Cosmetic Gear
Your Armor. Your Style. Your Choice.
Cosmetic Gear is a Minecraft armor customization mod that allows you to wear one armor set for protection while displaying a completely different armor set on your character.
Want the protection of Netherite armor with the appearance of an epic knight, a medieval warrior, or a custom 3D armor set? Cosmetic Gear makes it possible.
Customize your appearance without sacrificing protection, enchantments, durability, or gameplay functionality.
With separate cosmetic armor slots, independent visibility controls, custom 3D armor support, and multiplayer synchronization, Cosmetic Gear gives you full control over your character's appearance.
Features
Separate Cosmetic Armor Slots
Cosmetic Gear adds four additional equipment slots:
-
Head — Helmets and compatible head equipment
-
Chest — Chestplates and compatible chest equipment
-
Legs — Leggings
-
Feet — Boots
Each cosmetic slot works independently from your actual equipment.
For example, you can wear Netherite armor for protection while displaying a completely different armor set.
Your real armor continues to provide its normal benefits, including armor protection, toughness, enchantments, durability, and other equipment attributes.
Cosmetic equipment changes appearance only.
Elytra can also be displayed through the cosmetic chest slot without replacing the functionality of your actual equipment.
Custom 3D Armor Support
Cosmetic Gear supports custom armor models provided through compatible Forge rendering systems.
Supported rendering features include:
-
Custom 3D helmets
-
Custom chestplates and shoulder armor
-
Custom leggings and boots
-
Complete custom armor sets
-
Custom textures and armor materials
-
Armor trims and enchantment glint where supported
-
Player movement and armor model animations
Compatible armor mods can preserve their original model geometry and textures when used as cosmetic equipment.
This allows players to combine armor from different mods and create their own appearance.
Compatibility note: Some armor mods use independent rendering systems or custom equipment inventories. These may require additional integration to display correctly.
Independent Armor Visibility Controls
Control the appearance of your cosmetic armor and real armor separately.
Each equipment slot has independent visibility settings.
You can:
-
Show or hide individual cosmetic armor pieces.
-
Show or hide individual real armor pieces.
-
Hide all cosmetic armor at once.
-
Hide all real armor at once.
-
Display your character's original skin while keeping armor protection.
-
Combine visible cosmetic and real armor pieces.
A visible cosmetic item takes priority over the real armor in the same slot.
When the cosmetic item is hidden, the real armor appears if its own visibility setting is enabled.
Visibility controls only affect rendering. Your actual armor remains equipped and functional.
Simple and Compact Inventory Interface
Cosmetic Gear integrates directly into Minecraft's inventory.
Open the cosmetic equipment panel using the hanger button in your inventory or the default G key.
The key can be changed through Minecraft's Controls settings.
The interface includes:
-
Four cosmetic equipment slots
-
Individual visibility controls
-
Two global visibility controls
-
A hanger icon for cosmetic armor visibility
-
A helmet icon for real armor visibility
-
Green indicators for visible equipment
-
Red indicators for hidden equipment
-
Helpful tooltips
-
Adjustable inventory button position
The cosmetic interface works in both Survival and Creative mode.
Safe Equipment Management
Cosmetic Gear includes safeguards to help prevent accidental item loss during equipment changes.
-
Swap cosmetic equipment directly from your inventory.
-
Existing items are returned when replaced.
-
Full-inventory conditions are handled safely.
-
Invalid equipment is rejected.
-
Creative-mode transactions are validated by the server.
-
Rapid repeated clicks are controlled while transactions are pending.
-
Cosmetic items and visibility preferences are saved with player data.
These protections help preserve equipment during normal inventory operations.
Multiplayer Support
Cosmetic Gear supports multiplayer gameplay.
Your cosmetic equipment and visibility settings are synchronized so other players can see your selected appearance.
Features include:
-
Player-specific cosmetic equipment
-
Multiplayer appearance synchronization
-
Persistent visibility settings
-
Equipment restoration after reconnecting
-
Server-controlled cosmetic equipment behavior
For multiplayer use, Cosmetic Gear must be installed on both the server and participating clients, using compatible versions.
Death and Item Retention
Server administrators can control what happens to cosmetic equipment when a player dies.
Three modes are available:
-
Follow: Follow Minecraft's
keepInventorygame rule. -
Keep: Preserve cosmetic equipment after death.
-
Drop: Drop cosmetic equipment when the player dies.
Items with the Curse of Vanishing are removed when the applicable death behavior causes them to be lost.
Optional Curios Compatibility
Cosmetic Gear includes optional compatibility with Curios.
Compatible Curios head accessories can be used in the cosmetic head slot.
Curios is not required for normal Cosmetic Gear functionality.
Not every Curios accessory type is supported. Compatibility depends on the item's equipment requirements and rendering implementation.
Language Support
Cosmetic Gear includes 10 languages:
-
English
-
Turkish
-
German
-
French
-
Spanish
-
Japanese
-
Korean
-
Russian
-
Simplified Chinese
-
Brazilian Portuguese
The interface automatically uses Minecraft's selected language when a translation is available.
Commands
Cosmetic Gear provides commands for managing cosmetic equipment and visibility.
| Command | Description |
|---|---|
/cosmeticgear clear |
Returns cosmetic equipment to the player's inventory. Items that cannot fit are dropped. |
/cosmeticgear hide |
Hides all cosmetic equipment. |
/cosmeticgear show |
Shows cosmetic equipment. |
/cosmeticgear realarmor <slot> <true|false> |
Changes real armor visibility for the selected slot. |
/cosmeticgear admin clear <player> |
Clears a player's cosmetic equipment and returns the items. |
/cosmeticgear admin cosmetics <player> <true|false> |
Changes a player's global cosmetic visibility. |
/cosmeticgear admin realarmor <player> <slot> <true|false> |
Changes a player's real armor visibility. |
/cosmeticgear admin death <follow|keep|drop> |
Configures the server's cosmetic equipment death behavior. |
Valid armor slot values are head, chest, legs, feet, and all.
Administrative commands require operator permissions.
Installation
-
Install a compatible Minecraft Forge version.
-
Download the correct Cosmetic Gear file for your Minecraft version.
-
Place the downloaded JAR file inside your Minecraft
modsfolder. -
Launch Minecraft using your Forge profile.
-
Open your inventory and select the hanger icon, or press G.
For supported Minecraft versions, check the Files tab.
Curios is optional and does not need to be installed unless you want to use supported Curios accessories.
Configuration
Cosmetic Gear includes client-side and server-side settings.
Client options:
-
Show or hide your own cosmetic equipment locally.
-
Show or hide other players' cosmetic equipment locally.
-
Hide the inventory hanger button.
-
Adjust the inventory button position.
Server options:
-
Configure cosmetic equipment behavior on death.
-
Manage player cosmetic equipment through commands.
-
Control equipment visibility using administrative commands.
Developer API
Cosmetic Gear provides a public API for developers who want to integrate their mods.
The API allows server-side integrations to:
-
Read cosmetic equipment slots.
-
Add or remove compatible cosmetic items.
-
Read and modify appearance settings.
-
Control real armor visibility.
-
Listen for cosmetic equipment and visibility changes through Forge events.
The API uses server-authoritative equipment mutations and returns defensive copies when reading stored items.
Package: com.cosmeticgear.api
Developers should validate their own gameplay permissions before modifying another player's equipment.
Important Notes
-
Cosmetic Gear does not increase armor protection or provide additional equipment attributes.
-
Cosmetic equipment only changes appearance.
-
Some third-party armor models may require additional compatibility support.
-
Multiplayer servers and clients must use compatible Cosmetic Gear versions.
-
Curios integration is optional and limited to compatible accessories.
-
Always back up important worlds before changing mod versions.
Feedback and Bug Reports
If you encounter a bug, rendering issue, inventory problem, or incompatibility with another armor mod, please report it in the comments.
When reporting a problem, include your Minecraft version, Forge version, Cosmetic Gear version, and the names of any other mods involved.
Enjoy customizing your armor without compromising your protection!