Crystals

Crystals add enchant-specific boosts to Dungeon Sword sockets. Players can open Crystal Boxes, store crystals, improve apply chance with dust, tinker unwanted crystals, merge exceptional crystals, and buy permanent crystal upgrades.

All rules are configured in content/crystals.yml.

Storage and sockets

storage-capacity: 180
sword-xp-per-swing: 1.0
crystal-material: AMETHYST_SHARD
upgrade-currency: shards
socket-materials:
  equipped: END_CRYSTAL
  available: GRAY_DYE
  locked: RED_DYE

Storage capacity is independent of the menu page size. Available socket count comes from the milestones in settings/gameplay.yml, and the final count must match menus/crystals.yml: items.crystal-slot.slots.

Crystal Box tiers

Each tier controls its item, eligible enchant sword-level range, apply chance, and boost range:

box:
  default-tier: 1
  tiers:
    1:
      display-name: '&f&lTier I Crystal Box'
      material: LIGHT_GRAY_SHULKER_BOX
      minimum-enchant-sword-level: 1
      maximum-enchant-sword-level: 30
      minimum-apply-chance: 50
      maximum-apply-chance: 70
      minimum-boost: 3
      maximum-boost: 10

An empty eligible enchant pool prevents the box from opening. Enchants with a guaranteed base proc chance are omitted from normal crystal selection.

Dust, tinkering, and merging

dust:
  base-tinker-chance: 0.50
  normal-apply-increase: 5
  enchanted-apply-increase: 15

merge:
  base-success-chance: 0.25
  required-apply-chance: 100
  required-boost: 40
  merged-boost: 60

Normal Dust and Enchanted Dust improve apply chance. Merging requires two matching crystals that meet the configured thresholds. A failed merge follows the plugin's configured failure behavior and consumes the inputs.

Permanent upgrades

The bundled upgrades improve Enchanted Dust luck, regular Dust luck, and merge success. Each has a maximum level, exponential price curve, and chance increase per level. All three use upgrade-currency.

Admin commands

/dga give <player> crystal <enchant> [amount] [apply-chance] [boost] [merged]
/dga player <player> crystal-boxes <add|remove|set> <amount> [tier]
/dga player <player> stored-crystals <add|remove|set> <amount> <enchant|all> [apply-chance] [boost] [merged]

Use /crystal to test the complete player flow. Confirm socket capacity, duplicate-enchant rules, failed application, dust, bulk tinkering, storage paging, and merging.