Configuration

SinceDungeon loads Core configuration from config.yml, plus setting files under settings/. Dungeon-specific files can override many gameplay settings per map.

Core configuration is stored in:

plugins/SinceDungeon/config.yml

Premium configuration is stored in:

plugins/SinceDungeon-PremiumAddon/config.yml

Startup

startup:
  async-timeout-seconds: 30

This controls how long the plugin waits for async startup data loading before failing startup. Increase it if the database is remote or the server has many dungeon files.

Cross-Server

cross-server:
  enabled: false
  transfer-timeout-seconds: 30
  server-name: "dungeon-node-1"
  bungee-channel: "BungeeCord"
  return-server: "lobby"

Cross-server mode is marked experimental in the default config. It uses proxy plugin messaging and Redis Pub/Sub so a lobby server can request a dungeon run on a dungeon node.

Redis

redis:
  host: "localhost"
  port: 6379
  password: ""
  channel: "SinceDungeon"

All servers in the same network must use the same Redis channel.

Database

database:
  type: "sqlite"
  host: "localhost"
  port: 3306
  database: "sincedungeonpremium"
  username: "root"
  password: ""

Supported backends:

• sqlite: local file storage, recommended for small servers.
• mysql: remote database, recommended for large or networked servers.

HikariCP pool settings are available under database.pool.

Full pool example:

database:
  type: "sqlite"
  host: "localhost"
  port: 3306
  database: "sincedungeonpremium"
  username: "root"
  password: ""
  pool:
    max-size: 10
    min-idle: 2
    max-lifetime: 1800000
    timeout: 5000

Database stores:

• Fastest solo clear records
• Fastest party clear records
• Kill records
• Clear count records
• Player lives
• Player cooldowns

Commands

Core command labels can be changed:

commands:
  party: "party"
  party-aliases: [ "p", "pt" ]
  dungeon: "dungeon"
  dungeon-aliases: [ "dg", "inst" ]
  admin: "sincedungeon"
  admin-aliases: [ "sincedungeonpremium", "sd", "sdungeon" ]

Premium’s command is fixed as /sdp, with alias /sdpremium.

Locale and Debug

settings:
  locale: "en"
  debug: false
  clear-remaining-mobs-on-action-complete: true

Available bundled locales include English, Vietnamese, and Chinese.

Language files are modular under:

plugins/SinceDungeon/languages/<locale>/

Party System

party:
  max-members: 4
  allow-friendly-fire: false
  max-join-distance: 50.0
  reward-share-mode: "EQUAL"
  system-name: "System"
  invite-timeout: 60

Reward share modes:

• EQUAL: all eligible party members receive rewards.
• LEADER_ONLY: only the party leader receives reward chests.

Dungeon Gameplay Defaults

dungeon:
  lobby-countdown: 10
  template-folder: "dungeons"
  world-prefix: "SinceDungeon_"
  death-action: "RESPAWN"
  top-awarded-to: "ALL_MEMBERS"
  clear-mob-drops: true
  save-and-restore-stats: false
  out-of-lives-action: "SPECTATE"

Important options:

Gameplay restrictions:

dungeon:
  gameplay:
    keep-inventory-on-death: true
    prevent-item-dropping: true
    block-ender-pearls: true
    block-commands: true
    block-teleport-commands: false
    allowed-commands:
      - "/party"
      - "/p"
      - "/dungeon"
      - "/sincedungeon"
      - "/sincedungeonpremium"

Lives

lives:
  default-max-lives: 3
  default-start-lives: 3
  regen-interval-seconds: 3600
  regen-amount: 1

Players can spend lives to join dungeons and lose lives on death depending on dungeon settings. Dungeon files can set lives-deducted-per-death plus outcome costs for leave, fail, and clear; outcome costs are independent from cooldown-on-leave.

Items

Configurable built-in items:

• items.key
• items.compass
• items.cooldown_reset
• items.cooldown_reduce
• items.life_crystal

Item options include material, name, lore, glowing, rarity, flags, custom model data, max stack size, sounds, and particles.

Menus

Menu settings control the editor, reward GUI, and leaderboard GUI:

editor:
  nav-item: "ARROW"
  limits:
    max-locations: 50
    max-mob-amount: 200
    max-radius: 100.0

reward:
  session-expire-seconds: 300

leaderboard:
  fetch-limit: 50
  gui-size: 54
  date-format: "dd/MM/yyyy HH:mm"

Generated Settings Files

Additional Core settings are split into:

settings/actions.yml
settings/effects.yml
settings/gameplay.yml
settings/items.yml
settings/menus.yml

These files control GUI items, gameplay defaults, effects, menu layouts, and action defaults used by the editor.