Skip to content

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

  1. Place the GreatCosmetics .jar for your loader in your server's mods/ folder, alongside Cobblemon, Architectury API and the Kotlin runtime (Fabric Language Kotlin on Fabric, Kotlin for Forge on NeoForge — plus Fabric API on Fabric).
  2. Start (or restart) the server.
  3. 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:

  1. Join your server as an operator.
  2. 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.


Done — the wardrobe is live. Players open it with /wardrobe.