Equipment refers to items that can be inserted into a specialized slot in a mob's inventory in order to change certain aspects of its behaviour and appearence. Equipment objects typically do not flash red when the mob takes damage and remain visible if the mob has the Invisibility effect.
Specification
Custom equipment can be defined and referenced by the equippable item component.
Equipment definitions are stored in the assets/<namespace>/equipment directory of a resource pack.
- [NBT Compound / JSON Object]: The root tag.
- [NBT Compound / JSON Object] layers: Layer types for this equipment model. If a layer is omitted, the armor piece does not render when in the respective slot (with the exception of the head slot, where the regular item model is rendered instead).
- [NBT List / JSON Array] Layer definitions: The layers for this layer type.
- [String] texture: A namespaced id pointing to a texture for this layer.
namespace:path resolves to assets/<namespace>/textures/entity/equipment/<layer_type>/<path>.png.
- [NBT Compound / JSON Object] dyeable: (optional) Specifies how this layer behaves when the item is dyed. An item is considered as "dyed" when it has the dyed_color data component.
- [Int] color_when_undyed: (optional) An rgb int in decimal representation. The color to tint this layer if the item is undyable or not dyed. If this is not present and the item is not dyed, the layer is hidden.
- [Boolean] use_player_texture: (optional, default: false) If set to true, the layer texture is overridden by a texture given by the player. This is currently used only for the
wings layer type, where the player's cape texture is used instead if this is set to true.
An interactive widget is being loaded. If this does not work for you, please reload the page or check if JavaScript is working or enabled.
Equipment Layer Types
Equipment layer types are used for the following inventory slots:
| Equipment model layer type
|
Inventory slots
|
wolf_body
|
A wolf's armor slot.
|
horse_body
|
A horse's armor slot.
|
llama_body
|
A llama's carpet slot.
|
humanoid
|
A humanoid's head or chest or feet slot.
|
humanoid_leggings
|
A humanoid's legs slot.
|
wings
|
A humanoid's chest slot if the equipment has the glider data component.
|
pig_saddle
|
A Pig's saddle slot.
|
strider_saddle
|
A Strider's saddle slot.
|
camel_saddle
|
A Camel's saddle slot.
|
horse_saddle
|
A Horse's saddle slot.
|
donkey_saddle
|
A Donkey's saddle slot.
|
mule_saddle
|
A Mule's saddle slot.
|
skeleton_horse_saddle
|
A Skeleton Horse's saddle slot.
|
zombie_horse_saddle
|
A Zombie Horse's saddle slot.
|
happy_ghast_body
|
A Happy Ghast's body slot.
|
History
| Java Edition |
|---|
| 1.21.2 | 24w36a | Equipment is now defined in resource pack using the files in assets/[namespace]/models/equipment.
|
|---|
| The appearance of equipment when equipped by players or certain mobs can now be customized by defining 'equipment models' in the Resource Pack. |
| 1.21.4 | 24w45a | Equipment is now defined at assets/[namespace]/equipment.
|
|---|
equipment directory has been moved one level up, i.e. models/equipment/ becomes equipment/. |
| 1.21.5 | 25w03a | Saddles are now counted as equipment.
|
|---|
Added 8 new equipment model layers for saddles: pig_saddle, strider_saddle, camel_saddle, horse_saddle, donkey_saddle, mule_saddle, skeleton_horse_saddle and zombie_horse_saddle. These layers are only used for the respective entities' saddle slots. |
| 25w08a | Equipment layers configured to be dyeable will now show if the dyed_color component is present on the item, even if the item is not in the dyeable item tag.
|
|---|
| 1.21.6 | 25w15a | Added a new equipment model layer happy_ghast_body for happy ghasts.
|
|---|
Navigation
