CosmetologyLib
CosmetologyLib is a Forge library for Minecraft 1.16.5 that other mods use to add and manage player cosmetics.
What it does
Mod developers use the library to register custom cosmetics, group them into slots, and control which players may equip each one. A unified interface handles equipping across the rendering libraries it supports, so a mod does not need its own system for cosmetic placement and access.
Cosmetic data is kept on the server and synced to clients through packets, and changes to a cosmetic set can be loaded remotely. That allows an update to the cosmetic list without requiring players to receive a new version of the mod. Geckolib is an optional dependency and adds support for animated models.
The library is released for Forge only, with a single file for 1.16.5 dated 2022-11-19 and version 1.0.13 as the latest build. It runs on the client and server together, so both the server and every player need it to be installed. The source code and issue tracker are public, and it is released under the MIT License.
Key features
Cosmetic slot tracking
Cosmetics are assigned to slots, and the library tracks which slot each equipped cosmetic occupies.
Access control
Each cosmetic can be restricted or opened for a player, with permission checks before equipping.
Server-synced data
Saved cosmetic data lives on the server, and packets keep each client's view of it up to date.
Cosmetic GUI widgets
Widgets display the available cosmetics in in-game screens, and most features rely on manually registered event handlers.
Armor model layer
An extra armor model layer on the player renders cosmetic models over the default body.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Optional 1
Use cases
Adding cosmetics to a modpack
A modpack author can add a set of hats or outfits through a mod built on the library, controlling who may equip them.
Remote cosmetic updates
A developer can change the cosmetic list on the server without forcing players to update their mod files.
Who it’s for: Mod developers who want to add cosmetics to their own mods, and server owners who run mods built on the library and need to manage player access to those cosmetics.
Questions
Does CosmetologyLib need to be installed on both sides?
Which loader does CosmetologyLib support?
Is Geckolib required to use CosmetologyLib?
In the catalog
CosmetologyLib is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 5,992 mods support Minecraft 1.16.5.
More from lukegrahamlandry
Similar mods
What the author says
A library to help Minecraft mods add custom cosmetics. A unified interface for equipping cosmetics supplied by a variety of rendering libraries. Provides tools for managing which cosmetics each player has permission to equip. This is a library for developers, it adds no content on its own.
Official listing
- Modrinth page
- modrinth.com/mod/cosmetology
- Owner
- lukegrahamlandry
- Published
- 2022-11-19
- Updated on Modrinth
- 2022-11-19
- Facts verified
- 2026-10-15