Repository navigation
Levels Above The Maximum
Every enchantment has a max-level. It is the highest level the game gives out naturally: in the enchanting table, in villager trades and in loot, and what the normal /enchant command accepts.
But an item can have a higher level. Operators can create such items with /forceenchant, a trigger can create them with add-enchant, and a custom item can include them in its enchantments list.
Yes. The level on the item is the level that is used. Nothing is cut down to the maximum.
This is the same as vanilla: a Sharpness 50 sword really deals the damage of Sharpness 50. MetaEnchants does the same for its enchantments. If an item has vampirism at level 20, then {level} is 20 in every trigger of that enchantment, even if its max-level is 5.
This is true for everything:
- the chance, damage, effects and amounts that use
{level}; - the conditions that compare the level, like
enchant-level: ">= 10"; - several items together, with
stack: sumadding all the levels.
| Way | Notes |
|---|---|
/forceenchant @s metaenchants:vampirism 20 |
The easiest. Works on the main-hand item. |
/metaenchants give <player> <enchantment> 20 |
Gives a book. |
The add-enchant action |
add-enchant: {enchant: vampirism, level: 20} inside a trigger. |
The enchantments option of a custom item |
In give-item or drop-item. |
The highest possible level is 255.
Because levels can go far above the maximum, write your triggers so that big levels do not break your server's balance:
- Cap things that grow with the level:
- heal:
amount: "min({level} * 0.5, 6)"
entity: "{player}"- Use
min()to cap a chance. The percent sign goes at the very end and applies to the whole calculation:
- chance: "min({level} * 5, 60)%"- Think about whether you want the effect to scale linearly. A level 255 enchantment that is 255 times stronger may be too much.
With MetaEnchants tooltips on (the default), every level is written as a Roman numeral, also above X: Vampirism XX, Sharpness L. Levels above the maximum use tooltip.above-max-format, which shows them in gold by default so players notice them.
Without the tooltips (tooltip.enabled: false), the game only knows the numerals up to X, and shows enchantment.level.11, enchantment.level.50... for higher levels. A resource pack with the keys enchantment.level.11 to enchantment.level.255 fixes that.
The enchanting table, villagers and loot only produce levels up to max-level. Higher levels only exist if somebody creates them on purpose.