enchantment_definition

Defines a custom enchantment — misc entry.

Entry Information

Property	Value
Entry ID	enchantment_definition
Type	Misc
Color	Purple
Icon	material-symbols:auto-fix

Fields

Field	Type	Description
displayName	String	Display name of the enchantment
enchantmentLore	String	Lore shown on items for this enchantment
nameColor	String	Color of the enchantment name on items (MiniMessage tag, e.g. 'gray' or '#aaaaaa')
supportedItems	List<Material>	Items that support this enchantment
anvilCost	Int	Cost in an anvil to combine
maxLevel	Int	Maximum level of the enchantment
weight	Int	Weight used for random selection
minimumCost	Cost	Minimum cost when enchanting
maximumCost	Cost	Maximum cost when enchanting
activeSlots	List<EnchantSlot>	Equipment slots the enchantment is active in (empty = armor + hands)
exclusiveWith	List<Ref<RegisteredEnchantment>>	Enchantments that cannot coexist with this one on the same item
treasureChance	Int	Chance (0-100%) for this enchantment to appear as a book in generated loot chests
tradeChance	Int	Chance (0-100%) for librarian villagers to sell this enchantment instead of a vanilla book trade
cooldownEnabled	Boolean	Whether active triggers use a cooldown
cooldown	Duration	Cooldown between active triggers
criteria	List<Criteria>	Criteria that must match for triggers to run
inactiveTriggers	List<Ref<TriggerableEntry>>	Triggers fired when the enchantment becomes inactive
activeTriggers	List<ActiveTriggers>	Triggers fired while the enchantment is active. Each entry specifies the level.

Usage Example

- entry: enchantment_definition
  name: "Defines a custom enchantment"
  displayName: ""
  enchantmentLore: ""
  nameColor: ""
  supportedItems: []
  anvilCost: 0
  maxLevel: 0
  weight: 0
  minimumCost: ""
  maximumCost: ""
  activeSlots: []
  exclusiveWith: []
  treasureChance: 0
  tradeChance: 0
  cooldownEnabled: false
  cooldown: ""
  criteria: []
  inactiveTriggers: []
  activeTriggers: []