Repository navigation
Items Slots And Incompatibilities
This page explains which items accept an enchantment, where the item must be for the enchantment to work, and which enchantments cannot be together.
All of these options need a server restart after you change them.
supported-items is a list of the items that can carry the enchantment. You write item names and tags.
supported-items: ["minecraft:diamond_sword", "#minecraft:axes"]- An item name is written like
minecraft:diamond_sword(always withminecraft:and in lowercase). - A tag starts with
#and stands for a whole family of items. It is the easiest way:#minecraft:swordsmeans every sword. - Always put them between quotes.
| Tag | Items |
|---|---|
#minecraft:swords |
All swords. |
#minecraft:axes |
All axes. |
#minecraft:pickaxes |
All pickaxes. |
#minecraft:shovels |
All shovels. |
#minecraft:hoes |
All hoes. |
#minecraft:spears |
All spears. |
#minecraft:enchantable/weapon |
Everything meant for fighting. |
#minecraft:enchantable/sharp_weapon |
Swords and axes, the items that Sharpness fits. |
#minecraft:enchantable/melee_weapon |
Melee weapons. |
#minecraft:enchantable/mace |
The mace. |
#minecraft:enchantable/trident |
The trident. |
#minecraft:enchantable/bow |
Bows. |
#minecraft:enchantable/crossbow |
Crossbows. |
#minecraft:enchantable/fishing |
Fishing rods. |
#minecraft:enchantable/mining |
Tools for mining (pickaxe, axe, shovel, hoe). |
#minecraft:enchantable/armor |
All armor. |
#minecraft:enchantable/head_armor |
Helmets. |
#minecraft:enchantable/chest_armor |
Chestplates. |
#minecraft:enchantable/leg_armor |
Leggings. |
#minecraft:enchantable/foot_armor |
Boots. |
#minecraft:enchantable/equippable |
Anything that can be worn. |
#minecraft:enchantable/durability |
Anything that has durability. |
You can mix names and tags in one list. If a name or tag does not exist, the console warns you with the ones it did not find, and ignores them.
primary-items is optional. It limits which items the enchanting table offers the enchantment for. If you leave it out, it is the same as supported-items.
supported-items: ["#minecraft:enchantable/weapon"]
primary-items: ["#minecraft:swords"]With this, the table only offers it on swords, but an anvil or an operator can still put it on any weapon.
slots says where the item must be for the enchantment to work. A list of places:
| Slot | Where |
|---|---|
mainhand |
In the main hand. (Default.) |
offhand |
In the off hand. |
hand |
In either hand. |
head |
Worn on the head. |
chest |
Worn on the chest. |
legs |
Worn on the legs. |
feet |
Worn on the feet. |
armor |
Any armor slot. |
body |
The body slot of animals (horse armor, for example). |
saddle |
The saddle slot of animals. |
any |
Anywhere: hands, armor and everything else. |
slots: [mainhand]
slots: [hand]
slots: [feet]
slots: [head, chest, legs, feet]The same list also tells the game when to apply the enchantment's vanilla effects, so pick the places that make sense for the item. A sword enchantment uses mainhand; boots use feet; a shield could use offhand.
If the player wears several items with the enchantment in the slots you listed, the stack option decides:
-
highest(default): the enchantment works with the highest level among them. -
sum: the levels are added up.
incompatible is a list of enchantments that cannot be on the same item as this one.
incompatible: ["minecraft:sharpness", "vampirism", "#minecraft:exclusive_set/damage"]You can write:
| Write | Meaning |
|---|---|
minecraft:sharpness |
A vanilla enchantment. |
vampirism |
An enchantment of this plugin (the file name). |
metaenchants:vampirism |
The same, with the full id. |
"#minecraft:exclusive_set/damage" |
A whole family: here, all the damage enchantments (Sharpness, Smite, Bane of Arthropods...). |
Good to know:
- It works in both directions. If
lifesteallistsvampirismas incompatible, thenvampirismcannot be added to an item that haslifesteal, even ifvampirismdoes not list it back. - It applies in the enchanting table, the anvil and the commands.
- An enchantment is never incompatible with itself.
Other useful families of vanilla enchantments:
| Tag | Includes |
|---|---|
#minecraft:exclusive_set/damage |
Sharpness, Smite, Bane of Arthropods... |
#minecraft:exclusive_set/armor |
The protection family. |
#minecraft:exclusive_set/bow |
Infinity and Mending. |
#minecraft:exclusive_set/crossbow |
Multishot and Piercing. |
#minecraft:exclusive_set/mining |
Fortune and Silk Touch. |
#minecraft:exclusive_set/boots |
Frost Walker and Depth Strider. |
#minecraft:exclusive_set/riptide |
Riptide with Loyalty and Channeling. |
Use /metaenchants info <enchantment> to see how the plugin understood an enchantment: its items, slots, incompatibilities and where it appears.