Sets

Sets

A Set bundles multiple cosmetics — one from each category — into a single item that equips (or unequips) all of them at once.

Configuration

# sets.yml
sets:
  rainbow:
    display: "&#fc0000R&#fc6c00a&#fcd700i&#6cfc00n&#0fe56cb&#398eeeo&#8b00ffw &fSet"
    icon: PRISMARINE_CRYSTALS
    permission: celestial.cosmetics.set.rainbow
    cosmetics:
      tag: rainbow
      rebirth: rainbow
      namecolor: rainbow
      chatcolor: rainbow
      rankcolor: rainbow
      emoji: rainbow

cosmetics: maps each category to the id of an existing cosmetic in that category's file. You don't need to include every category — a set can be just two or three cosmetics if that's the look you want.

How Access Works

A player only needs the set's own permission — they don't need the individual permissions of each component. As long as they have access to the set (via owned copies or rank/group), every component listed becomes usable, without needing to unlock each one separately.

Equipping and Unequipping

• Equipping a set immediately applies every listed component (switching Rank Color also pushes the LuckPerms prefix, same as equipping it individually).
• If the player later changes one component manually (e.g. swaps just the Tag), the set is automatically marked as no longer "active" — but the rest of the components stay equipped as they were.
• Clicking Unequip on a set clears every component that's still set to match the set's values.

Sets Are Stackable & Tradeable Too

Sets follow the same vault ownership rules as any other cosmetic: you can own multiple copies, withdraw one as a physical item, trade it, or list the whole set on the Auction House as a single purchase.

Set Previews

In the Crates rewards preview, sets show a live composed preview line — your actual name, colored, tagged, and formatted exactly as it would look equipped — so players can see the full look before opening the crate.

---

Next: Rank Defaults