Introduction
Welcome to GreatCosmetics
GreatCosmetics is a full cosmetics framework for Fabric 1.21.1 servers (NeoForge in testing). It gives your players a 3D Avatar Studio to browse and equip cosmetics on nine virtual body slots, plus chat tags, storage backpacks and particle effects — all editable in-game, with no restart, through the built-in Dev Studio.
It needs only Fabric API. Add Cobblemon and it unlocks Pokémon skins, the Party tab and the Cobblemon Lure bonus system; add LuckPerms for permission-tiered slots and automatic group chat tags. Without either, the mod still runs and every non-Pokémon feature works.
Every piece of text the mod shows (menus, chat, item names) is stored in editable JSON files and rendered through MiniMessage, so you control the language, colors and formatting without touching the code.
The mod ships with no cosmetic models
GreatCosmetics is the framework — the wardrobe, the slots, the Dev Studio, the effects, the networking. It does not come with a library of cosmetics. Out of the box you only get a couple of small built-in examples (safe to leave in and use on your server, no catch), not a content pack.
Every cosmetic shown in the mod's showcase video was built separately and is not included with the mod. To fill your server's wardrobe you need actual 3D models/textures, acquired however you like: model packs sold (or soon to be sold) on the official SaSDevelopment Discord, any other model source, or even reskinned armor from other mods turned into an Armor Cosmetic. See Making Models & Textures if you (or your artist) want to build your own from scratch.
Main Features
- 3D Avatar Studio (
/wardrobe): a rotating 3D preview of the player where cosmetics are equipped with a click, organized by category and searchable. - Nine virtual slots:
HEAD, FACE, NECK, CHEST, BACK, WAIST, LEGS, FEET, HAND— independent from the player's real armor, with per-slot and per-type limits and permission tiers. - Custom 3D models: cosmetics render as flat item icons (Custom Model Data) or full animated GeckoLib models, positioned per-part with an in-game 3D gizmo. See Making Models & Textures.
- In-game Dev Studio: create and edit cosmetics, particle effects, accessory types, slots and server config live — changes broadcast to every online player.
- Chat Tags: custom prefixes plus automatic LuckPerms group tags, with an in-game editor.
- Pokémon Skins: aspect-based skins for the player's party Pokémon, with cooldowns, alternate forms and thematic groups.
- Cosmetic Backpacks: wearable backpacks that double as paged item storage.
- Cobblemon Lure bonuses: shiny rate, IV/EV, capture chance, hidden ability, fishing bonuses and more, attached to any cosmetic.
- Particle Effects & Sounds: trailing particles and per-action sounds (equip, walk, fly, sneak, idle…).
- Armor → Cosmetic conversion: turn real armor items into wardrobe cosmetics automatically.
- Forced Resource Pack: the mod can push its texture pack to clients on join and on
/gc reload, noserver.propertiesedits needed.
Development and Authorship
GreatCosmetics was fully designed and programmed by F4xizzz, from SaSDevelopment — the Fabric/Java mod and the Node.js licensing backend.
Official Community
Configuration questions, bug reports and update news happen on our official Discord. This documentation is kept up to date to give you the best setup experience for GreatCosmetics on your server.