# Admin Tools

## The In-Game Creation Wizard

`/cosmetics admin` (requires `celestial.cosmetics.admin`) opens a menu with one button per cosmetic type. Clicking one starts a guided **chat wizard**:

1. **id** — internal identifier (lowercase, no spaces)
2. **display** — the name shown in menus (supports `&#RRGGBB` colors)
3. **value** (or **prefix / text / suffix** for Rebirth styles, or **components** for Sets)
4. **icon** — a material name, or type `hand` to use whatever item you're currently holding

Type `cancel` at any point to abort. Every step is validated — duplicate ids, invalid materials, and non-existent set components are all rejected with a clear message instead of silently corrupting the config.

On completion, the cosmetic is written directly to the correct file (`tags.yml`, `sets.yml`, etc.) and the config is hot-reloaded — no restart needed, no manual file editing.

The same admin menu also has a **Reload** button, equivalent to `/cosmetics reload`.

## Managing Player Cosmetics

```
/cosmetics give <player> <type> <id> [amount]     Add copies to a player's vault (default 1)
/cosmetics set <player> <type> <id>               Force-equip a cosmetic (admin override, bypasses ownership)
/cosmetics extract <player> <type> <id>           Extract one owned copy as a physical item
/cosmetics clear <player> <type>                  Unequip a category
```

`give` respects the [stackable vault](Vault-and-Trading.md) — running it twice gives 2 copies, not a duplicate-blocked no-op.

## Managing Crates

See the [full crate admin command reference](Crates.md#full-command-reference) — giving keys, opening/closing seasonal crates, and linking physical crate blocks in the world.

## Reloading

```
/cosmetics reload
```

Reloads all 10 configuration files (see [Configuration Files Overview](Configuration-Files.md)) and re-validates every cosmetic and crate reference. Invalid references are logged to console rather than crashing the plugin.

---

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