Abilities

Abilities are permanent Dungeon Sword unlocks configured in content/abilities.yml. Players redeem a tagged ability item, select the unlocked ability through /dungeons abilities, and press Q while holding their Dungeon Sword to activate it.

Shared fields

abilities:
  booster:
    order: 2
    display-name: '<light_purple><bold>Booster</bold></light_purple>'
    description:
      - 'Temporarily increases selected dungeon rewards.'
    material: PLAYER_HEAD
    head-texture: 'https://textures.minecraft.net/texture/...'
    cooldown-seconds: 120
    duration-seconds: 30
    effect: MULTIPLIER
    currency-multipliers:
      souls: 2.0
      essence: 2.0

IDs are persistent ownership keys. order controls menu order. Item presentation supports a normal material, head texture, and the configured text formats.

Multiplier abilities

effect: MULTIPLIER can apply currency multipliers and a damage multiplier for duration-seconds. Every referenced currency must exist.

effect: MULTIPLIER
duration-seconds: 20
currency-multipliers: { money: 2.0 }
damage-multiplier: 2.0

Command abilities

effect: COMMAND runs configured console commands when its base chance succeeds:

effect: COMMAND
base-chance: 0.25
commands:
  - chance: 1.0
    command: 'minecraft:give {player} minecraft:gold_block 1'

Use fully qualified command names where possible. Commands run with console authority, so review them carefully and never place untrusted player input into the command string.

Granting abilities

/dga give <player> ability <id> [amount]

This gives a correctly tagged redemption item. The player must right-click it to commit the unlock. Giving a normal look-alike item does not unlock the ability.

Menus, messages, and sounds

• menus/abilities.yml controls selection layout.

• language/messages/gameplay.yml controls unlock, selection, cooldown, and activation messages.

• language/sounds.yml controls ability event sounds.

Validate command syntax, duration, cooldown, and effect references before reloading. Test activation while grinding and confirm that reconnecting does not bypass the persistent cooldown.