Fake Player Plugin (FPP)

v1.5.17 (2026-04-07)

Swap System — Critical Fix & Major Enhancements

• Critical bug fix: bots now actually rejoin after swapping out. The rejoin timer was being silently cancelled by delete() calling cancel(uuid) — bots left but never came back. Fixed by registering the rejoin task after delete() runs so cancel() finds nothing to cancel.
• New swap.min-online: 0 — minimum bots that must stay online; swap skips if removing one would go below this floor
• New swap.retry-rejoin: true / swap.retry-delay: 60 — auto-retry failed rejoins (e.g. when max-bots cap is temporarily full)
• Better bot identification on rejoin: same-name rejoins use getByName() (reliable even with stable UUIDs); random-name rejoins use UUID diff
• New Personality.SPORADIC type — unpredictable session variance for more natural patterns
• Expanded farewell/greeting message pools (~50 entries each)
• New /fpp swap info <bot> — shows personality, cycle count, time until next leave, and offline-waiting count
• /fpp swap list now shows time remaining in each session
• /fpp swap status now shows the min-online floor setting
• New logging.debug.swap: false — dedicated swap lifecycle debug channel

Performance Optimizations

• O(1) bot name lookup via secondary nameIndex map — getByName() was O(n) linear scan, now O(1) ConcurrentHashMap lookup maintained at all add/remove sites
• Position sync distance culling — position packets only broadcast to players within performance.position-sync-distance: 128.0 blocks (0 = unlimited); saves significant packet overhead on large servers

Log Cleanup

• NmsPlayerSpawner per-spawn/despawn log messages demoted from INFO → DEBUG; no more log spam on every bot cycle

Config Reorganization

• config.yml restructured into 9 clearly labelled sections: Spawning · Appearance · Body & Combat · AI Systems · Bot Chat · Scheduling · Database & Network · Performance · Debug & Logging
• Config version → v47