Perks

Perks are rolled Dungeon Sword bonuses defined in content/perks.yml. A player equips one rolled perk and can reroll the same perk through five effect levels.

Global settings

schema-version: 1
pity-threshold: 500
mass-roll:
  rolls-per-tick: 25
  maximum-rolls-per-invocation: 5000
  confirmation-window-millis: 700
ticket-currency: credits
ticket-prices:
  1: 50
  10: 400
  25: 750

• pity-threshold guarantees the configured pity behavior after repeated rolls.

• ticket-currency must exist in content/currencies.yml.

• ticket-prices maps bundle size to price and must match the bundle values shown by menus/perks.yml.

• Mass Roll is additionally protected by drakodungeons.perks.mass-roll.

rolls-per-tick is a global server budget shared by all active Mass Rolls. Increase it only after measuring tick time under concurrent use.

Perk definitions

perks:
  attack:
    display-name: '<green>Attack Perk</green>'
    description:
      - '<gray>Adds Dungeon Sword damage.'
    rarity: GREEN
    chance: 12.5
    material: PLAYER_HEAD
    head-texture: 'http://textures.minecraft.net/texture/...'
    effects:
      damage: [5, 10, 15, 20, 25]

chance is a relative weight. The service normalizes all configured weights at roll time. Each effect list contains the values for levels I through V.

Supported effect keys

• damage

• critical-damage

• money, shards, souls, and essence

• sword-xp

• enchant-proc

• attack-speed-millis

Perks can combine several effects in one definition.

Layout and administration

• menus/perks.yml controls rolling, ticket bundles, and navigation.

• menus/perk-index.yml controls the catalogue view.

• menus/perk-confirmation.yml controls the keep/continue result flow.

Admins can change tickets and pity progress with /dga player. Use tab completion to select the correct resource name and action.

When balancing, compare the full level-V perk against sword tiers, armor, rebirth upgrades, and enchants. Percent values are bonuses, not standalone multipliers.