Admin Tools

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 — running it twice gives 2 copies, not a duplicate-blocked no-op.

Managing Crates

See the full crate admin 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) and re-validates every cosmetic and crate reference. Invalid references are logged to console rather than crashing the plugin.

---

Next: Commands Reference