Installation
Fabric is the current release
The public release runs on Fabric — use greatcosmetics-fabric-<version>.jar. A NeoForge build exists and is in testing; it will be published once it's verified. Watch Discord for the announcement.
Server Requirements
| Requirement | Fabric | NeoForge |
|---|---|---|
| Minecraft | 1.21.1 | 1.21.1 |
| Java | 21 or higher | 21 or higher |
| Loader | Fabric Loader 0.16 or higher | NeoForge 21.1.133 or higher |
| Cobblemon | 1.8.0 | 1.8.0 |
| Kotlin runtime | Fabric Language Kotlin 1.13.13+kotlin.2.4.10 or higher |
Kotlin for Forge 5.7.0 or higher |
| API | Fabric API 0.116.9+1.21.1 or higher |
— |
| Architectury API | 13.0.0 or higher |
13.0.0 or higher |
See Dependencies for download links.
Step 1 — Drop in the jar
- Place the GreatCosmetics
.jarfor your loader in your server'smods/folder, alongside Cobblemon, Architectury API and the Kotlin runtime (Fabric Language Kotlin on Fabric, Kotlin for Forge on NeoForge — plus Fabric API on Fabric). - Start (or restart) the server.
- On first startup the mod creates the folder
config/GreatCosmetics/with all its default config files, and generates a starter cosmetic so you can confirm it loaded.
Same jar for players
There's only one jar — give players the exact same file you put on the server (same version). The Dev Studio and other admin tools are already restricted to operators and players with the specific permission, so there's no separate stripped-down build to distribute.
Step 2 — Configure the basics
Open config/GreatCosmetics/ and adjust:
| File | What to set | Page |
|---|---|---|
mainconfig.conf |
Database mode, slot/type limits, forced resource pack, startup commands | Main Config |
lang/*.json |
Language, colors and every message the mod shows | Language & MiniMessage |
Everything else (cosmetics, tags, effects, skins) is best edited in-game — see Dev Studio.
Step 3 — Activate the license
On a dedicated server, GreatCosmetics stays locked until you activate a license key:
- Join your server as an operator.
- Run:
/gc activation GREATCOSMETICS-XXXX-XXXX
This binds the key to your server instance and creates config/GreatCosmetics/license.json.
One server per key
On first activation the key is bound to that server instance. Your public IP can change without breaking activation, but a key cannot be shared or run on a second, different server. Contact support to migrate a key to a new machine.
Singleplayer / LAN
In singleplayer or an integrated LAN world the mod is always active — no key needed. Activation is a dedicated-server concept.
Full details on License & Activation.
Step 4 — Reload
After editing config files, apply everything without a restart:
/gc reload
This reloads every config, recomputes model data, re-pushes the resource pack to online players and re-syncs the whole catalog.