FAQs
Frequently Asked Questions
1. Players open /wardrobe but every cosmetic is missing / broken.
Almost always the resource pack isn't loaded on the client. GreatCosmetics ships models and textures in its own jar for the built-in cosmetics, but any cosmetic you add yourself needs a resource pack on the client with the matching models/, textures/icons/, geo/ and textures/ files. Enable the Forced Resource Pack or add the pack to the modpack.
2. The server says "no valid license" and nothing works.
You are on a dedicated server without an activated key. Run /gc activation GREATCOSMETICS-XXXX-XXXX. If activation fails:
- The key may already be bound to another server (keys are single-server).
- The licensing backend may be waking up — the first request after idle can take up to a minute; try again.
- Make sure you are running the unmodified official jar.
See License & Activation.
3. Do I need LuckPerms?
Not to run the mod, but strongly recommended. Without it: only operators can use /gc subcommands or the Dev Studio, per-slot/per-type limit tiers do nothing, per-cosmetic permission gating can't be used, and group Tags show but never apply a real prefix.
4. Where do I add my own 3D models?
Drop the files into a resource pack and reference them by name in the Dev Studio. Conventions:
- Flat icon:
assets/greatcosmetics/textures/icons/<name>.png - Vanilla model:
assets/greatcosmetics/models/<name>.json - GeckoLib model:
geo/item/<name>.geo.json+textures/item/<name>.png(+ optionalanimations/item/<name>.animation.json) — in any namespace.
See Parts & Models.
5. Can cosmetics give real stats (armor, flight, speed)?
Yes. Any cosmetic can grant armor points, toughness, creative-style flight, ground/fly/swim speed multipliers, auto-feed, and permanent potion effects. See Attributes & Abilities. It can also carry Cobblemon Lure bonuses (shiny rate, IVs, capture chance, fishing…) — see Lure System.
6. A player's real diamond helmet turned into a cosmetic. Why?
You configured that item in armor_cosmetics.json (or the Dev Studio "+ Armor" button). When a player joins holding a matching real item, the mod removes it from the inventory and unlocks the cosmetic version in the wardrobe. See Armor Cosmetics.
7. I edited a config file and nothing changed.
Run /gc reload. For mainconfig.conf and the lang/ files this is enough. Cosmetic models (GeckoLib .geo) also need the client's resource pack to be current — /gc reload re-pushes it if you use the Forced Resource Pack.
8. How do I translate the mod / change its messages?
Everything is in config/GreatCosmetics/lang/*.json, one file per area, all rendered through MiniMessage. Edit the values, /gc reload. See Language & MiniMessage.
Still stuck?
Open a support ticket on our Discord with your latest.log and a description of what you expected.