Troubleshooting FAQ

Troubleshooting & FAQ

The plugin won't load

• Wrong server type: you need Paper 1.20+ (or a fork), not Spigot/CraftBukkit.
• Java too old: you need Java 17+. Check with java -version.
• Missing dependencies: PlaceholderAPI and LuckPerms are required.
• Library download failed: first start needs internet to fetch the DB driver/pool. Check console for a download error.

Glow shows white / no color

The glow color comes from the player's scoreboard team, and nametag plugins like TAB manage that same team — a player can only be in one team, so without help TAB overrides the color and the glow goes white.

Fix: install PacketEvents. The plugin then intercepts team packets and forces the glow color even with TAB running (console shows Glow: PacketEvents hook active), without taking over the team itself — TAB keeps full control (sorting, collision, rank badge/prefix), we only repaint the color. Color changes apply instantly to everyone already online, no reconnect needed. Note: since glow and nametag share the team color, coloring the glow can also color the nametag.

Also remember: you can't see your own glow in first person — check from another player or third person (F5).

The overhead nametag doesn't show my hex Name Color

That's a Minecraft client limitation, not a bug: the real nametag above a player's head can only render one of the 16 legacy colors, no matter which plugin builds it. Use %celestial_namecolor_legacy% (rounds to the nearest legacy color) wherever a nametag plugin's overhead-nametag field is involved, e.g. TAB's tagprefix. %celestial_namecolor% (full hex) keeps working everywhere else — chat, tablist, menus. See Placeholders Reference.

No join/leave message shows at all

Working as intended — Join Messages and Leave Messages are opt-in only. A player with nothing equipped joins/leaves in complete silence, with no vanilla fallback text. Only players who actually equipped one of these cosmetics broadcast anything.

The rank offset (:offset_-40:) shows literally in TAB

Use %celestial_rank_tab% in TAB, not %celestial_rank%. TAB needs the %img_offset% form. Enable TAB's nested placeholder support. See The Rank System.

The rank text shifts when I equip an effect

Your template needs a reset so the effect (shader trigger) doesn't bleed onto the text:

template: '{effect}{background}&r{offset}{text}'

The &r stops the effect at the background.

MANAGER (or a long rank) overflows its background

Give that rank a wider background and its own offset in rankcolors.yml, and restrict narrow backgrounds to short ranks with the ranks: list. See Rank Backgrounds.

Cosmetics don't sync across my network

• Set storage.type: mysql on every server, all pointing at the same database.
• Keep the config files identical across servers.
• Check console for a MySQL connection error (host/user/password/firewall).

See Network Sync.

Purchases say "unavailable"

Your economy-mode couldn't start. Check console: Vault/economy plugin missing, EdDungeons not found, or the balance placeholder not resolving. See Economy Integration.

Placeholders show as raw text

• Install PlaceholderAPI and run /papi ecloud download … for any external placeholders you reference.
• In TAB, enable nested placeholder support.

Chat emojis / rank glyphs show as boxes

Those need an ItemsAdder (or compatible) resource pack loaded on the client. Without the pack, the glyph character can't render. The clean/vanilla build disables ItemsAdder-only categories by default.

A category is missing from the menu

Check categories-enabled in config.yml — a disabled category is hidden everywhere.

No hologram appears above my crate block

• FancyHolograms isn't installed or isn't enabled. The label needs FancyHolograms specifically — other hologram plugins aren't hooked into (yet).
• Check crate-holograms.enabled: true in config.yml, and that the crate doesn't have hologram.enabled: false set for itself in crates.yml.
• Make sure the block is actually linked — /cosmetics crate blocks lists every linked location. A block declared in crates.<id>.blocks only gets linked after a restart or /cosmetics reload.
• The label sits crate-holograms.height-offset blocks above the block's centre (1.6 by default) — check you're not just looking past it.

My crate never shows as "Limited"

Limited is auto-detected: at least one reward needs a stock: cap (a shorthand like tag:fire:5:10 or a map entry with stock: 10). If every reward is unlimited, the crate is Normal by design. Force it explicitly with hologram.limited: true in that crate's config if you want the label regardless. See Crates.

---

Back to Home