Getting started
Installing the mod, applying a piece, and taking it off again.
Installing
- Install Fabric Loader for the Minecraft version on the main page.
- Put Armor Pieces and Fabric API in
mods/. The mod is downloaded from Modrinth or CurseForge; this site does not host it. - Install it on both sides. The client draws the pieces; the server owns their behaviour.
There is one setting, first_person_parts in config/armorpieces.json, written for you on first launch. It only decides whether the pieces on your arms are drawn on the first-person hand.
Applying a piece
A piece rides on a template: one template item per socket (brow_template, pauldrons_template, and so on), carrying the piece as a component. At a smithing table: template, the armor, and a trim material (an ingot, a gem, a crystal). The piece takes that material’s colour. A socket holds one piece, so applying a new crest replaces the crest.
Most templates are found rather than made. Thirty of the mod’s pieces have a crafting recipe, the ones where the centre item is plainly the piece or what it is made of: a bell for the bells, a goat horn for the horns. The recipe is the item in a ring of paper.
Skins, cloths and fittings
- A skin goes on with a skin template and the armor’s own material: re-skinning is re-forging, and it costs the metal the piece is made of.
- A cloth goes on a chestplate with a cloth template and a banner made at a loom.
- A fitting fills a place a piece declares for a second material: a gem in the circlet, a metal buckle on the sash. One fitting template per kind; the same template with the third slot empty takes the fitting out again.
Taking a piece off
At the advanced smithing table, crafted from a smithing table, an armor stand and two iron ingots. It holds a whole set worn by a stand and lists each piece’s sockets and their fittings as rows of icons, with the armor’s own row under them: its trim, its skin and, on a chestplate, its cloth. Pick one and Remove empties it. It is the one way a piece, a fitting, a trim, a skin or a cloth ever comes off. Its own template and material slots run the smithing table’s recipes too, with the result shown on the stand before it is paid for.
Switching a recipe off
Any recipe the mod ships can be disabled by a datapack that overrides its file with
{"type": "armorpieces:disabled"}which is how a server keeps a piece found-only, or does without fittings.