add_enchant_level

Adds levels to an enchantment the triggering item already has, removing it at 0.

Categories: inventory

Required arguments

Key(s)DescriptionType
enchantThe enchantment to level, e.g. sharpness.ENCHANTMENT
levelsThe levels to add. Use a negative number to remove levels. Supports expressions.EXPRESSION

Optional arguments

Key(s)DescriptionTypeDefault
allow_unsafeIf true, the enchantment can go above its max level.BOOLEANfalse

Trigger parameters required

  • ITEM

Example

effects:
  - id: add_enchant_level
    args:
      enchant: <value>
      levels: 1
      allow_unsafe: true # ← Optional

Behaviour

SettingValue
Run orderNORMAL
Supports delaytrue
Reloads on plugin reloadtrue