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 TAB overrides the color and the glow goes white.

Fix: install ProtocolLib. The plugin then intercepts team packets and forces the glow color even with TAB running (console shows Glow: ProtocolLib hook active). 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 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.

---

Back to Home