Compatibility

Compatibility

Server

Software	Paper 1.20 – 1.21.x, and compatible forks (Purpur, Pufferfish)
Java	17 or newer (Java 21 works too)
Spigot / CraftBukkit	❌ Not supported

CelestialCosmetics uses the Paper API (for example Paper's async chat event), so it requires Paper or a Paper fork. It is compiled against the 1.20 API and Java 17, which lets it load on everything from 1.20 up to the latest 1.21.x.

Clients

Players can join from any client version as long as you run ViaVersion (and ViaBackwards for older clients) on the server. Client compatibility is handled at the protocol level by Via — the plugin only needs to run on your server's Paper version.

Required plugins

Plugin	Why
PlaceholderAPI	Placeholders (rank, name/chat colors, rebirth…)
LuckPerms	Rank detection and the rank prefix system

Optional plugins

Plugin	Enables
MySQL / MariaDB	Cross-server sync — see Network Sync
PacketEvents	Colored Glows that survive TAB's nametag teams
Vault / EdDungeons / any currency plugin	Auction House & paid crates — see Economy Integration
ItemsAdder / Oraxen / Nexo	Custom GUI textures and rank/emoji glyphs
TAB	Rank display in the tab list / nametags via %celestial_rank_tab%

Java note

Minecraft 1.20 – 1.20.4 run on Java 17; 1.20.5+ and 1.21 run on Java 21. Because the plugin targets Java 17, it loads on both. Just make sure your server is actually running Java 17 or newer.

---

Next: Installation