Cosmetic Gear

Cosmetic Gear lets you customize your Minecraft character's appearance with separate cosmetic armor slots, support for custom 3D armor models, and independent armor visibility controls without affecting protection.

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 keepInventory game 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

  1. Install a compatible Minecraft Forge version.

  2. Download the correct Cosmetic Gear file for your Minecraft version.

  3. Place the downloaded JAR file inside your Minecraft mods folder.

  4. Launch Minecraft using your Forge profile.

  5. 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!

Cosmetic Gear Team

profile avatar
  • 1
    Followers
  • 6
    Projects
  • 11.4K
    Downloads

More from Yasin_GamerView all

  • InventoryFlow project image

    InventoryFlow

    InventoryFlow improves Minecraft inventory management with fast item transfers, mouse drag actions, scroll-based transfers, stack controls, and one-click inventory sorting.

    • 3.4K
    • October 3, 2026
  •  TreeBreaker project image

    TreeBreaker

    TreeBreaker is a tree-felling mod for Forge, NeoForge, and Fabric. Break one log with any axe type to cut connected logs, branches, and nearby natural leaves.

    • 5.6K
    • September 22, 2026
  • Rise Of  Trees project image

    Rise Of Trees

    Makes Minecraft trees grow taller and more impressive while preserving their natural vanilla appearance

    • 2.0K
    • September 22, 2026
  • TransportFrame project image

    TransportFrame

    Build directional conveyor networks with easy-to-use frames to transport items horizontally and vertically, split item flows, and merge multiple lines

    • 86
    • September 20, 2026
  • InventoryFlow project image

    InventoryFlow

    InventoryFlow improves Minecraft inventory management with fast item transfers, mouse drag actions, scroll-based transfers, stack controls, and one-click inventory sorting.

    • 3.4K
    • October 3, 2026
  •  TreeBreaker project image

    TreeBreaker

    TreeBreaker is a tree-felling mod for Forge, NeoForge, and Fabric. Break one log with any axe type to cut connected logs, branches, and nearby natural leaves.

    • 5.6K
    • September 22, 2026
  • Rise Of  Trees project image

    Rise Of Trees

    Makes Minecraft trees grow taller and more impressive while preserving their natural vanilla appearance

    • 2.0K
    • September 22, 2026
  • TransportFrame project image

    TransportFrame

    Build directional conveyor networks with easy-to-use frames to transport items horizontally and vertically, split item flows, and merge multiple lines

    • 86
    • September 20, 2026