Fake Player Plugin v1.6.6.12.8

Bug Fixes

• Bot rank colour preserved after restart — bot display names now always reconstruct from the current LuckPerms prefix + name format on restore; colours are no longer stripped when saving to the database, and a post-restore prefix refresh runs automatically after all bots are re-queued.
• Join / leave delay timing fixed — config values (join-delay / leave-delay) were being multiplied by 20 internally, making all delays 20× too long. Values are now treated as ticks directly as documented (e.g. max: 20 = 1 second).
• /fpp reload now refreshes all bot prefixes — LP cache is invalidated and updateAllBotPrefixes() is called, so prefix changes take effect immediately without a restart.

New Features

• /fpp despawn random [amount] — removes a random selection of active bots (default 1). Useful for gradual scale-down.
• Beta version detection — when the running version is newer than the latest published release, admins see a styled in-game warning identifying the build as a beta. The message is also delivered to admins who join after the check completes, identical to how update-available notifications work.

Internals
- Config-version bumped to 25 (housekeeping stamp — no structural changes).

New Features

• LuckPerms auto-update — bot display names, tab-list entries, and nametags now update in real-time when LuckPerms group data changes (prefix, weight, colours). No reload or respawn needed.
• Full LuckPerms colour support — all colour formats now render correctly in bot prefixes: MiniMessage tags (<rainbow>, <gradient:#FF0000:#0000FF>), hex colours (<#9782ff>), LuckPerms gradient shorthand ({#FFFFFF>}text{#FFFFFF<}), and mixed formats (&7[<#9782ff>Phantom</#9782ff>&7]).
• LuckPerms weight ordering — bot tab-list entries sort below all real players by default; bots always use the default group (never inherit spawner permissions or weight).
• Multi-platform download links — update notifications and /fpp info screen show clickable links to Modrinth, SpigotMC, PaperMC Hangar, and BuiltByBit.
• Enhanced reload command — /fpp reload shows step-by-step progress with a checkmark per subsystem and total reload time on completion.
• Update checker improvements — Modrinth API is now the primary version source; console output is a clean one-liner; in-game notifications use a bordered style matching the help menu.
• Tab-list bot visibility — tab-list.enabled: true/false controls whether bots appear in the tab list. When false, bots are hidden but still count in the server player count. Hot-reloadable via /fpp reload.
• No external API requirement — physical bot bodies no longer depend on any external plugin API; works on any compatible Paper server out of the box.

Bug Fixes

• Fixed join/leave messages rendering raw gradient tags (e.g. {#FFFFFF>}[PLAYER]{#FFFFFF<}) instead of the formatted text — LuckPerms gradient shorthand is now fully resolved in all broadcast messages.
• Fixed bot display names restoring as literal bot-{spawner}-{num} placeholder text after a server restart — names are now reconstructed correctly from saved data on restore.
• Fixed StackOverflowError in visualChain when spawning large batches of bots with join-delay: 0 and some bots deleted mid-spawn.
• Fixed NullPointerException in PlayerWorldChangeListener on non-Folia servers (replaced Folia-specific player.getScheduler() with standard Bukkit scheduler).
• Fixed unclosed hex colour tags (e.g. <#9782ff>) at the end of LuckPerms prefixes causing broken text — trailing unclosed tags are now stripped before parsing.
• Fixed tab-list migration incorrectly applying enabled: false (the old header/footer toggle) as bot visibility for users upgrading from older versions.
• Fixed startup log pause/lag caused by blocking update checker — now runs asynchronously with a fast timeout.

• Bug fix — bots restored after a server restart no longer show literal {spawner}, {num}, or {bot_name} in their display name; stale saves from older versions are detected and the display name is rebuilt correctly.
• Bug fix — trailing unclosed hex color tags (e.g. <#9782ff>) at the end of LuckPerms prefixes are now stripped before parsing, preventing broken text in nametags and the tab list.

• Added a proper version check to the update checker (previously it only checked if the API was reachable, not if the version was actually newer).
• Fixed a bug where the update checker would report an update available when the API was reachable but returned an error or invalid response.
• Multi Hotfix.

Release

• Compatibility checks: detect non-Paper servers and Minecraft versions below 1.21.9 and enter a restricted compatibility mode when needed (physical bodies and chunk-loading disabled).
• Added runtime guard for missing server API classes (prevents NoClassDefFoundError when the Mannequin class is absent).
• Admin-facing in-game compatibility warning (configurable) sent on enable and on admin join.
• Teleport commands updated: /fpp tp and /fpp tph now report when no physical body is available; /fpp info shows "No Body" when bodies are disabled.
• Command rename: /fpp delete renamed to /fpp despawn (permission node fpp.delete retained for compatibility).

Hotfix

• Fixed NullPointerException in BotSwapAI when bot entity is null.
• Fixed StackOverflowError in FakePlayerManager.visualChain by adding a recursion base case.