Skip to content

Items Slots And Incompatibilities

neoramm edited this page Nov 5, 2026 · 1 revision

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

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 with minecraft: and in lowercase).
  • A tag starts with # and stands for a whole family of items. It is the easiest way: #minecraft:swords means every sword.
  • Always put them between quotes.

Useful tags

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

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

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.

Several items with the same enchantment

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 enchantments

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 lifesteal lists vampirism as incompatible, then vampirism cannot be added to an item that has lifesteal, even if vampirism does 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.

Checking the result

Use /metaenchants info <enchantment> to see how the plugin understood an enchantment: its items, slots, incompatibilities and where it appears.

Clone this wiki locally