# 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](Vault-and-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](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](Rank-Backgrounds).

---

Next: [Placeholders](Placeholders-Reference)