Pieces and sockets

The twelve sockets, what sits on each, and how a piece takes its colour.

A piece is real geometry hung on the body, not paint on the texture: a model in a resource pack, a greyscale master texture, and a small data file that says which socket it fits and what it does. Every socket has several pieces to choose from in the mod alone, so the choice is the expressive act.

The sockets

Socket	Armor	Where	Pieces
crest	helmet	Top of the skull, pointing up	4
brow	helmet	Across the forehead, on the front face of the head	12
horns	helmet	Both temples, mirrored	2
pauldrons	chestplate	Both shoulders, mirrored, riding on the arms so they swing with them	4
back	chestplate	Upper back	6
collar	chestplate	Base of the throat, on the front of the chest	7
vambraces	chestplate	Both forearms, mirrored, riding on the arms	6
belt	leggings	Waistline, at the bottom of the torso	7
tassets	leggings	Both hips, mirrored, riding on the legs	4
knees	leggings	Both knees, mirrored, on the front of the legs	5
spurs	boots	Both heels, mirrored, at the back of the ankle	6
greaves	boots	Both shins, mirrored, on the front of the lower leg	3

Mirrored sockets

A mirrored socket is modelled once and drawn on both sides. The pieces on the arms are also drawn on the first-person hand, close to the camera and meant to be; first_person_parts in the config turns that off.

Colour

One greyscale master per piece is mapped onto each trim material's own palette at load time, the same palette vanilla uses for the trim. A circlet applied with gold is gold; with amethyst, amethyst. A new trim material, from vanilla or another mod, costs a piece no new art at all. A piece may also carry a static layer, painted in real colour, for whatever on it is never the material: a feather, a leather strap.

Fittings

A piece can declare places for a second material. See Fittings.

Behaviour

A piece may carry effects, configured in the same data file: attributes, mob effects, a dodge, gliding. The pinions are a cut-down elytra that actually flies, the gorget is worth a heart and two in netherite, and the puttees walk a twentieth faster. Effects can be gated on a fitting, so the circlet grants Hero of the Village only with an emerald in it. The authoring guide lists every effect type, and says which attributes want which operation.

What is here

How many	What
66	the pieces, over every socket
9	the armor skins
2	the cloths
4	the fittings
12	the sockets a piece can hang on
3	the loot groups
6	the effect types a piece may carry
29	the pieces with a template recipe; the rest are found
2	the fewest pieces any socket has to choose from

Edit this page · generated in the mod repository from its own data; the prose is in docs/wiki/pieces.yml and the tables are counted at build time.