Skip to main content
Version: 26.1+

Suit Sets

Suit sets are a shorthand for registering a full set of armor items (helmet, chestplate, leggings, boots) from a single file, instead of creating four separate item files. All pieces share the same armor material, components, and creative tab placement, with the option to override those per slot.

To create a suit set, create a JSON file at:

addon/<namespace>/suit_set/<id>.json

The suit set is registered under the same ID, e.g. addon/mypack/suit_set/iron_spider.json registers mypack:iron_spider.


Fields

FieldTypeRequiredDescription
armor_materialArmorMaterialYesThe armor material used for all pieces. Accepts a registry ID or an inline definition. See Armor Materials.
slotsObjectYesMap of armor slot to slot config. Keys are helmet, chestplate, leggings, boots.
componentsObjectNoData components applied to all pieces. Same format as on individual items.
tabTab PlacementNoCreative tab placement for all pieces. Same format as on individual items.

Slot Config

Each entry in slots configures one armor piece.

FieldTypeRequiredDescription
item_nameStringNoThe item ID path within the namespace. If omitted, defaults to <suit_set_id>_<slot> (e.g. iron_spider_helmet).
componentsObjectNoAdditional data components for this piece only, merged on top of the top-level components.
tabTab PlacementNoCreative tab placement for this piece only, overriding the top-level tab.

Example

addon/mypack/suit_set/iron_spider.json
{
"armor_material": "mypack:iron_spider",
"tab": {
"type": "add_after",
"tab": "minecraft:combat",
"target": "minecraft:netherite_boots"
},
"slots": {
"helmet": {
"item_name": "iron_spider_helmet"
},
"chestplate": {
"item_name": "iron_spider_chestplate"
},
"leggings": {
"item_name": "iron_spider_leggings"
},
"boots": {
"item_name": "iron_spider_boots"
}
}
}

This registers four items: mypack:iron_spider_helmet, mypack:iron_spider_chestplate, mypack:iron_spider_leggings, and mypack:iron_spider_boots.


To assign powers to a suit set, see Assigning Powers to Items.