Refine

Refine

Refine raises an item's refinement level and applies configured stat, damage, or defense bonuses with success/failure behavior.

Files

• Settings: modules/refine/settings.yml

• Item: modules/refine/items/sample_stone.yml

• Bundled resources on GitHub

Commands and permissions

• refine refine — divinity.refine.cmd.refine
• refine downgrade — divinity.refine.cmd.downgrade
• Shared item commands and reload — divinity.admin

Configuration and example

refine.max-level, fail-level-downgrade, and fail-silent-rate-bonus control risk. A stone's refine-by-level adds item stats, damage types, or defense types.

Administrator notes

• Failure can downgrade refinement levels. Document this to players and test every threshold in fail-level-downgrade.
• Calculate cumulative bonuses at refine.max-level, including gems, sets, classes, and other stat sources.
• Use disposable copies for success and failure tests; existing refined items may retain metadata from older configurations.
• Restrict refine and downgrade permissions and verify commands cannot bypass intended materials or costs.

items/sample_stone.yml — bundled refine stone

material: CHARCOAL
name: 'Enchantment Stone'
tier: common
level:
  min: 1
  max: 3
uses-by-level:
  '1': 1
  '2': 2
refine-by-level:
  '1':
    damage-types:
      physical: 1%
  '2':
    damage-types:
      physical: 1.5%
  '3':
    damage-types:
      physical: 2%

See Modules and Commands and Permissions.