# Commands Reference

Base command: `/cosmetics` (aliases: `/cosmetic`, `/ccos`)

| Command | Permission | Description |
|---|---|---|
| `/cosmetics` | `celestial.cosmetics.use` | Open the cosmetics vault |
| `/cosmetics search [query]` | `celestial.cosmetics.use` | Search cosmetics across every category. With no query, prompts you to type one in chat |
| `/cosmetics daily` | `celestial.cosmetics.use` | Show your remaining cooldown for every daily-login crate |
| `/cosmetics admin` | `celestial.cosmetics.admin` | Open the admin cosmetic-creation menu |
| `/cosmetics crates` | `celestial.cosmetics.use` | Open the crates browse menu |
| `/cosmetics crate open <crate>` | `celestial.cosmetics.use` | Open a crate (uses a key automatically if you have one) |
| `/cosmetics crate givekey <player> <crate> [amount]` | `celestial.cosmetics.admin` | Give crate keys |
| `/cosmetics crate enable <crate> <duration\|always>` | `celestial.cosmetics.admin` | Open a seasonal crate for a set time, or permanently |
| `/cosmetics crate disable <crate>` | `celestial.cosmetics.admin` | Close a seasonal crate |
| `/cosmetics crate setblock <crate> [world x y z]` | `celestial.cosmetics.admin` | Link a world block to a crate |
| `/cosmetics crate removeblock [world x y z]` | `celestial.cosmetics.admin` | Unlink a world block |
| `/cosmetics crate blocks` | `celestial.cosmetics.admin` | List every linked crate block |
| `/cosmetics crate pity <player> <crate> [reset]` | `celestial.cosmetics.admin` | Check (or reset) a player's pity counter for a crate |
| `/cosmetics ah` (alias: `/cosmetics auction`) | `celestial.cosmetics.use` | Open the Auction House |
| `/cosmetics sell <type> <id> [price]` | `celestial.cosmetics.use` | List an owned cosmetic for sale |
| `/cosmetics give <player> <type> <id> [amount]` | `celestial.cosmetics.admin` | Add copies to a player's vault |
| `/cosmetics set <player> <type> <id>` | `celestial.cosmetics.admin` | Force-equip a cosmetic |
| `/cosmetics extract <player> <type> <id>` | `celestial.cosmetics.admin` | Extract an owned copy as a physical item |
| `/cosmetics clear <player> <type>` | `celestial.cosmetics.admin` | Unequip a category |
| `/cosmetics reload` | `celestial.cosmetics.admin` | Reload all configuration files |

## Cosmetic Types (used as `<type>` in commands)

`tag` · `rebirth` · `customstat1` · `customstat2` · `customstat3` · `namecolor` · `rankcolor` · `rankbg` · `chatcolor` · `emoji` · `glow` · `joinmessage` · `leavemessage` · `chatemoji` · `set`

## Player Commands vs. Admin Commands

- **Player** (`celestial.cosmetics.use`, default `true`): opening menus, `search`, `daily`, `crate open`, `ah`, `sell`.
- **Admin** (`celestial.cosmetics.admin`, default `op`): everything that targets another player or edits state — `give`, `set`, `extract`, `clear`, `reload`, and all `crate` sub-commands except `open`.

Tab-completion for `<type>` and `<id>` is available to admins on the `give`/`set`/`clear`/`extract` commands.

---

Next: [Permissions Reference](Permissions-Reference.md)