Home

Armor Cosmetic

Armor Cosmetic lets a player wear two sets of armor: the real armor that gives protection, and a cosmetic set that is only drawn on the player model. It also lets you hide each armor piece so your skin shows through, and turn cosmetic rendering off on your own client (for example for PvP).

Armor Cosmetic is a fork of CosmeticArmorReworked by zlainsama and dmillerw, distributed under the Minecraft Mod Public License (MMPL) 1.0.1. It is not affiliated with or endorsed by the original authors. See Credits and license.

Versions

One wiki covers every build. Each row is a published branch of codex-skd/armor-cosmetic.

Minecraft	Loader	Armor Cosmetic	Java	Branch
1.21.1	NeoForge 21.1.249	1.0.1	21	minecraft/1.21.1/neoforge-21.1.249/main
1.21.1	Fabric Loader 0.19.5 + Fabric API 0.116.17+1.21.1	1.0.0	21	minecraft/1.21.1/fabric-0.19.5/main
26.1.2	NeoForge 26.1.2.78	1.1.1	25	minecraft/26.1.2/neoforge-26.1.2.78/main
26.1.2	Fabric Loader 0.19.5 + Fabric API 0.155.3+26.1.2	1.0.0	25	minecraft/26.1.2/fabric-0.19.5/main
26.2	NeoForge 26.2.0.57	1.2.1	25	minecraft/26.2/neoforge-26.2.0.57/main
26.2	Fabric Loader 0.19.5 + Fabric API 0.161.0+26.2	1.0.0	25	minecraft/26.2/fabric-0.19.5/main
26.3	NeoForge 26.3.0.26-beta	1.0.0	25	minecraft/26.3/neoforge-26.3.0.26-beta/main
26.3	Fabric Loader 0.19.5 + Fabric API 0.161.0+26.3	1.0.0	25	minecraft/26.3/fabric-0.19.5/main
26.2	NeoForge 26.2.0.45-beta (legacy)	1.0.18	25	minecraft/26.2/neoforge-26.2.0.45-beta/main
26.2	NeoForge 26.2.0.37-beta (legacy)	1.0.17	25	minecraft/26.2/neoforge-26.2.0.37-beta/main
26.2	NeoForge 26.2.0.32-beta (legacy)	1.0.5	25	minecraft/26.2/neoforge-26.2.0.32-beta/main

What is the same everywhere

• Four cosmetic slots (head, chest, legs, feet), the per-slot skin toggle, and the client-side rendering toggle.
• The /clearcosarmor and /coshat commands.
• Cosmetic items are saved on the server, one <uuid>.cosarmor file per player in the world's player data folder.
• The Java API: CosArmorAPI, CAStacksBase and the CosArmorDeathDrops hook.

What changes between builds

• Loader: NeoForge builds use NeoForge configs (config/armor_cosmetic/client.toml and common.toml); Fabric builds use one JSON file (config/armor_cosmetic.json). The death-drop hook is a NeoForge event or a Fabric callback. See API.
• Key binding: unbound by default on 1.21.1, Left Alt on 26.x.
• Legacy NeoForge 26.2 betas (26.2.0.32, 26.2.0.37 and 26.2.0.45): older interface and config layout, a different /coshat, and different death rules. Each page has a Legacy 26.2 betas note. The current NeoForge 26.2 build is 26.2.0.57.
• Languages: 15 on most builds (English, Spanish, German, French, Italian, Dutch, Swedish, Polish, Japanese, Portuguese, Russian, Chinese, Korean, Turkish, Czech); the NeoForge 26.1.2 and 26.2.0.32-beta builds ship 11 (without Italian, Dutch, Swedish and Polish).

Pages

• Getting started: installation and requirements.
• Cosmetic inventory: the buttons, the slots and the toggles.
• Configuration: every option, for NeoForge and Fabric.
• Commands: /clearcosarmor and /coshat.
• Death and storage: what happens to cosmetic items when you die, and where they are saved.
• API: using Armor Cosmetic from another mod.
• Credits and license

Bugs and suggestions: issue tracker.