Slots & Types
GreatCosmetics limits how many cosmetics a player can wear with two independent systems: virtual slots (by body area) and accessory types (by category). Both are defined in mainconfig.conf and editable in the Dev Studio.
Virtual slots
Nine fixed names, independent from real armor:
HEAD · FACE · NECK · CHEST · BACK · WAIST · LEGS · FEET · HAND
Each has:
"HEAD": { "defaultLimit": 1, "permission": "gc.slot.head" }
defaultLimit— cosmetics a normal player may wear in that slot.permission— the base node for the tier system.
Raising a slot limit
| Node | Effect |
|---|---|
gc.slot.head.3 |
Sets the HEAD limit to 3 (the mod picks the highest tier 1–20 the player holds). |
gc.slot.head.bypass |
Unlimited (99) in HEAD. |
gc.extraslot.head.2 |
+2 on top of the normal limit (the highest single extraslot.head.N the player holds). |
gc.extraslot.all.4 |
+4 to every slot (added on top of the slot-specific extra). |
gc.slot.* replaces the limit with the tier value; gc.extraslot.* adds to it. They stack: base 1 + gc.slot.head.3 → 3, then + gc.extraslot.all.2 → 5.
Per-player bonus: /gc extraslot
gc.extraslot.* above is granted through LuckPerms, so it applies to a whole group at once. GreatCosmetics also has a second, independent way to add slot bonuses — targeted at one specific player and stored in the database instead of as a permission node:
/gc extraslot <player> <slot|ALL> add|set|remove <amount>
add <amount>— adds to that player's existing bonus for the slot.set <amount>— overwrites it to exactly that amount.remove <amount>— subtracts from it.<slot>is one of the nine slot names (case-insensitive) orALLfor every slot at once.- Permission:
gc.command.extraslot.
Two bonuses, and they stack
A LuckPerms gc.extraslot.head.2 node and a /gc extraslot Steve head add 2 command both add +2 to HEAD — and they add up together. Use the permission node to bonus an entire rank; use /gc extraslot to gift bonus slots to one specific player without creating a rank for it.
Accessory types
A type is a free-text category you assign to a cosmetic (its Type field). It caps how many cosmetics of that category a player wears, regardless of slot.
"necklace": { "slot": "NECK", "limitPerPlayer": 1, "permission": "gc.type.necklace" }
slot— informational (which body area this type belongs to).limitPerPlayer— max cosmetics with this exact type worn at once.permission— base node for tiers.
Raising a type limit
| Node | Effect |
|---|---|
gc.type.necklace.2 |
Raises the necklace limit to 2. |
gc.type.necklace.bypass |
Unlimited (99) for necklaces. |
gc.extratypeslot.necklace.2 |
+2 on top of the normal limit (the highest single extratypeslot.necklace.N the player holds). |
gc.extratypeslot.all.4 |
+4 to every type (added on top of the type-specific extra). |
gc.type.* replaces the limit with the tier value; gc.extratypeslot.* adds to it. They stack the same way slot nodes do: base 1 + gc.type.necklace.2 → 2, then + gc.extratypeslot.all.1 → 3.
A cosmetic with type default has no type limit — only its slot limit applies.
Per-player bonus: /gc extratypeslot
Exact mirror of /gc extraslot, but for accessory types instead of virtual slots:
/gc extratypeslot <player> <type|ALL> add|set|remove <amount>
- Same
add/set/removesemantics as/gc extraslot, stored per-player in the database. <type>is any type id defined in your config (case-insensitive) orALLfor every type at once.- Permission:
gc.command.extratypeslot.
Two bonuses, and they stack
A LuckPerms gc.extratypeslot.necklace.2 node and a /gc extratypeslot Steve necklace add 2 command both add +2 to the necklace limit — and they add up together, exactly like gc.extraslot.* vs. /gc extraslot for slots.
How a check runs when a player equips
- Is the player owner (or has the
permissionnode, or Dev Mode)? If not → blocked. - Slot count for the target slot vs. the resolved slot limit (
defaultLimit→gc.slottier →+ extraslotbonuses, from permission nodes and/or/gc extraslot). - Type count for the cosmetic's type vs. the resolved type limit (
limitPerPlayer→gc.typetier →+ extratypeslotbonuses, from permission nodes and/or/gc extratypeslot).
If any check fails, the player gets a message and a sound; nothing is equipped.
Operators and Dev Mode bypass all slot/type limits. /gc cosmetics equip also force-equips ignoring limits.
Example: a "3 hats for VIP" setup
mainconfig.conf:
"HEAD": { "defaultLimit": 1, "permission": "gc.slot.head" }
LuckPerms:
lp group vip permission set gc.slot.head.3 true
Now VIPs wear up to 3 HEAD cosmetics; everyone else wears 1.