Gems

Gems

Gems socket item stats and damage/defense bonuses. Gem merchants can sell socketing services.

Files

• Settings: modules/gems/settings.yml

• Items: diamond_of_damage.yml, emerald_of_health.yml, gold_nugget_of_agility.yml, iron_nugget_of_defense.yml in items/

• Merchant: merchant.yml

• Bundled resources on GitHub

Commands and permissions

• Alias: gems
• gems merchant [player] — divinity.gems.cmd.merchant / .merchant.others
• Socket GUI — divinity.gems.gui.user and .gui.merchant
• Shared item commands and reload — divinity.admin

Configuration and example

Gem bonuses-by-level can fill damage-types, defense-types, and item-stats. success-rate-by-level accepts fixed values, formulas, or ranges.

Administrator notes

• The bundled socket failure settings can destroy the target item. Review target/source destruction and socket wiping before launch.
• Gem bonuses can compound across sockets, sets, classes, and base stats; calculate worst-case totals, not only one gem.
• If the merchant is enabled, verify Vault prices and separate user/merchant GUI permissions.
• Test duplicated gem IDs, success-rate ranges, full sockets, failure, old items, and items at each target requirement boundary.

items/diamond_of_damage.yml — bundled multi-type damage gem

material: DIAMOND
name: 'Diamond of Damage'
socket-display: '&6Damage Diamond %ITEM_LEVEL_ROMAN%'
tier: eternal
level:
  min: 1
  max: 1
uses-by-level:
  '1': 3
success-rate-by-level:
  '1': '40:80'
bonuses-by-level:
  '1':
    damage-types:
      physical: 3.5%
      magical: 3.5%
      fire: 3.5%
      poison: 3.5%
      wind: 3.5%
      water: 3.5%

See Modules and Commands and Permissions.