On this page

Equipment tab

Sounds, repairing, and the rules about who can wear the item and how.

Sounds

The Sounds section with the Equip Sound field numbered
The Sounds section.
  1. Equip Sound — plays when a player puts the piece on. Start typing to search; there are thousands. Try item.armor.equip_netherite for something weighty or item.armor.equip_leather for something soft.

With advanced settings on, wolf, horse and harness pieces also get a Shear Sound, played when the armour is sheared off the animal.

Advanced: Repair Rules

The Repair Rules section with its two fields numbered
The Repair Rules section.
  1. Repair behaviorUse vanilla rules repairs with the normal material; Allow selected items only accepts what you list; Never repair blocks anvil repair entirely.
  2. Anvil repair cost — how many levels an anvil charges. Higher is more expensive.

Pick Allow selected items and an Add Repair Item button appears. Add one item per row, e.g. minecraft:diamond.

Behavior

The Behavior section with its dropdowns numbered
Each is a three-way dropdown: Use vanilla default, Enabled, Disabled.
  1. Swappable — whether right-clicking swaps it with what's already worn.
  2. Dispensable — whether a dispenser can equip it.
  3. Damage on hurt — whether it loses durability when the wearer is hit.

Two more appear where they apply: Can be sheared (wolf, horse and harness only) and Equip on interact (right-click an animal to put it on).

Leave them all on the default unless you have a specific reason.

Some of these need a newer server. Equip on interact needs Paper 1.21.5+, and shearing plus shear sounds need Paper 1.21.6+. On older servers those settings are quietly ignored and you get vanilla behaviour — nothing breaks.

Allowed Entities

Who can wear it. Leave the list empty and vanilla rules apply — which is what you want almost every time. Add entries only to restrict it, e.g. add player so a mob can never pick it up and wear it.

Advanced: Custom Data

Tags other plugins can read off the item. Press Add Custom Tag and fill in a key, a value and a type. Only useful if another plugin is looking for it — see the developer guide.

Advanced: Camera Overlay

Helmets only. An image drawn over the player's whole screen while the helmet is worn, like the pumpkin overlay. Click Upload Overlay Image.

Keep it mostly transparent, or players won't see anything.

Last updated August 11, 2026