Permissions Reference

Permissions Reference

Permission	Default	Description
celestial.cosmetics.use	true	Open /cosmetics and every player menu (vault, Auction House, crates, search)
celestial.cosmetics.admin	op	Every admin command and the /cosmetics admin creation menu
celestial.cosmetics.<type>.<id>	(none)	Grants unlimited, non-tradeable access to a specific cosmetic

Per-cosmetic permissions

Every cosmetic has an auto-generated node:

celestial.cosmetics.<type>.<id>

Examples:

celestial.cosmetics.tag.dragon
celestial.cosmetics.customstat1.rankup_simple
celestial.cosmetics.namecolor.gold
celestial.cosmetics.chatcolor.aqua
celestial.cosmetics.rankcolor.gold        # rank effect
celestial.cosmetics.rankbg.plate_short    # rank background
celestial.cosmetics.emoji.heart
celestial.cosmetics.glow.aqua
celestial.cosmetics.joinmessage.royal
celestial.cosmetics.leavemessage.royal
celestial.cosmetics.chatemoji.smile
celestial.cosmetics.set.rainbow

Override the auto node with an explicit permission: field per cosmetic if you want a custom scheme.

Two kinds of access

• Vault copy (from crates / /cosmetics give) — a real, stackable, tradeable/sellable copy.
• Permission (granted to a rank/group) — unlimited access but cannot be withdrawn, traded or sold.

/lp group vip permission set celestial.cosmetics.set.rainbow true

Grant access this way for rank perks; use /cosmetics give when you want the player to receive a real, tradeable item. See Vault & Trading.

Chat Emojis are different

A chat emoji is never "equipped" — the permission is a straight on/off gate. Grant celestial.cosmetics.chatemoji.smile (or celestial.cosmetics.chatemoji.*) to a rank and every member can type that shortcode immediately. See Chat Emojis.

Rank Backgrounds & ranks

Beyond the permission, a background can be restricted to specific LuckPerms groups with a ranks: list in rank-backgrounds.yml — see Rank Backgrounds.

---

Next: Placeholders