Quick Start

Quick Start Guide

A five-minute walkthrough to get your first cosmetics live.

1. Give yourself a cosmetic

/cosmetics give YourName tag dragon

This adds 1 copy of the dragon tag to your vault (tags are defined in tags.yml — the plugin ships with example entries).

2. Open your vault

/cosmetics

Click Tags, then click the Dragon tag. A new menu opens with three options:

• EQUIP — puts it on
• WITHDRAW — pulls it out as a physical, tradeable item
• AUCTION — lists it for sale (only shown if you own a real copy)

Click EQUIP.

3. Wire it into chat

Your cosmetics don't show anywhere until your chat/tablist plugin actually reads the placeholders. In your chat formatter (LPC, EssentialsChat, etc.), update the format to include:

"%celestial_rebirth% {prefix}%celestial_namecolor%{name} %celestial_tag%%celestial_emoji%&8» %celestial_chatcolor%{message}"

See Placeholders for the full list and TAB/tablist wiring notes.

4. Create your own cosmetic in-game

No file editing needed:

/cosmetics admin

Click a category (e.g. + New Tag), then answer the chat prompts: id → display name → value → icon. The cosmetic is written to the correct config file and hot-reloaded immediately.

5. Set up your first crate

/cosmetics crate givekey YourName starter 3

Open /cosmetics crates, click the Starter Crate, and open it with a key to see the roulette animation. See Crates for setting up seasonal crates, unique stock-limited rewards, and physical crate blocks in the world.

6. Try the Auction House

/cosmetics give YourName tag fire

Open your vault → Tags → Fire → AUCTION, type a price in chat, and it appears in /cosmetics ah for other players to buy.

---

Next steps:

• Cosmetic Types to understand every config option
• GUI Customization to reskin the menus for your server
• Admin Tools for the full admin command reference