Fake Player Plugin (FPP)

v1.1.4 (2026-03-12)

Chunk Loading — Complete Rewrite

• Spiral ticket order — chunks are added from centre outward, matching Paper's chunk-send priority queue so nearby chunks are always loaded first
• Movement-delta detection — ChunkLoader tracks each bot's last chunk position; the full spiral recomputation is skipped entirely when the bot hasn't crossed a chunk boundary — zero CPU waste for stationary bots
• World-border clamping — chunks outside the configured world border are automatically excluded from ticket sets in both the spiral builder and the boundary checker
• update-interval config — new chunk-loading.update-interval key (default 20 ticks) controls how often the loader polls bot positions; tune lower for heavily knocked-around bots, higher for static lobby bots
• Auto-radius — setting chunk-loading.radius: 0 now reads the server's live Bukkit.getSimulationDistance() and uses that as the radius
• Instant release on removal — releaseForBot() removes all tickets immediately when a bot is deleted, killed, or the plugin disables; no orphaned loaded chunks
• totalTickets() diagnostic — new public method returns total plugin chunk tickets held across all bots for /fpp info display

FakePlayer Model Enhancements

• getLiveLocation() — returns Mannequin body position when alive, falls back to spawnLocation; used by DB flush and ChunkLoader for maximum accuracy
• getUptime() / getUptimeFormatted() — Duration-based uptime, formatted as 1h 23m 45s
• Session stats — totalDamageTaken, deathCount, isAlive(), tabRefreshCount tracked per session
• Chunk tracking helpers — hasMovedChunk(cx, cz), setLastChunk(cx, cz) for O(1) movement detection without Location allocation

Config & DB

• DB location flush uses getLiveLocation() instead of raw body reference — handles body-less bots (tab-only mode) correctly
• Config.chunkLoadingUpdateInterval() accessor added