Home

CelestialCosmetics Wiki

Welcome to the complete documentation for CelestialCosmetics — a full cosmetics economy for Paper networks: tags, colors, emojis, glows, a layered rank-styling system, join messages, chat emojis, sets, player trading, an Auction House, a complete crate system, and MySQL cross-server sync, all wrapped in a 100% configurable GUI.

The plugin is a premium resource — get it on BuiltByBit. This wiki is the source of truth for setup and configuration.

📖 Table of Contents

Getting Started

• Installation
• Quick Start
• Compatibility
• Configuration Files
• Network Sync (MySQL)

Cosmetics

• Cosmetic Types
• The Rank System — effect + background + text, per rank
• Rank Backgrounds
• Glows
• Join Messages · Leave Messages
• Chat Emojis
• Sets

Economy & Items

• Vault & Trading
• Auction House
• Crates · Daily Rewards
• Economy Integration
• Search

Customization & Admin

• GUI Customization
• Admin Tools

Reference

• Commands
• Permissions
• Placeholders
• Troubleshooting & FAQ

---

What is CelestialCosmetics?

Most cosmetics plugins are a menu that flips a boolean permission on. CelestialCosmetics is built differently: every cosmetic is a real, stackable, ownable item. Players hold multiple copies, trade them, sell them on a live Auction House, or win them from crates with real global stock limits and server-wide broadcasts for unique prizes.

With MySQL storage, a player's whole cosmetic profile — owned cosmetics, equipped looks, vault, pity and daily progress — follows them across every server on your network.

Compatibility at a glance

Server	Paper 1.20 – 1.21.x (+ Purpur, Pufferfish)
Java	17+
Clients	any version via ViaVersion / ViaBackwards
Required	PlaceholderAPI, LuckPerms
Optional	MySQL (network), PacketEvents (glow+TAB), FancyHolograms (crate labels), a currency plugin, ItemsAdder/Oraxen/Nexo

See Compatibility for details. Bukkit/Spigot are not supported — Paper only.