Fake Player Plugin (FPP)

v1.6.0 (2026-04-09)

Interactive Help GUI

• /fpp help now opens a 54-slot double-chest GUI instead of text output — paginated, permission-filtered, click-navigable
• Each command gets a semantically meaningful Material icon (compass for move, chest for inventory, diamond pickaxe for mine, etc.)
• Displays command name, description, usage modes, and permission node per item
• Up to 45 commands per page; previous/next arrows; close button; adapts live to your permission level

New Commands

• /fpp inventory <bot> (alias inv) — 54-slot bot inventory GUI with equipment slots (boots/leggings/chestplate/helmet/offhand) and type enforcement; right-click a bot entity to open without a command. Permission: fpp.inventory
• /fpp move <bot> <player> — navigate a bot to an online player using server-side A* pathfinding; supports WALK, ASCEND, DESCEND, PARKOUR, BREAK, PLACE move types; stuck detection + auto-recalculation; max 64-block range, 2000-node search. Permission: fpp.move
• /fpp xp <bot> — transfer the bot's entire XP pool to yourself; 30-second post-collection cooldown on bot XP pickup. Permission: fpp.user.xp (user-tier)
• /fpp cmd <bot> <command> — execute a command dispatched as the bot; --add <command> stores a right-click command on the bot; --clear removes it; --show displays it; right-clicking a bot with a stored command runs it instead of opening inventory GUI. Permission: fpp.cmd
• /fpp mine <bot> [once|stop] — continuous block mining at the bot's look-target; once breaks a single block; stop cancels; creative mode = instant break, survival = progressive mining with destroy progress. Permission: fpp.mine

Settings GUI Expanded

• Settings GUI now has 7 categories: General, Body, Chat, Swap, Peak Hours, PvP, Pathfinding (up from 5)
• New pathfinding toggles: pathfinding.parkour, pathfinding.break-blocks, pathfinding.place-blocks, pathfinding.place-material
• New PvP AI settings: difficulty, defensive-mode, detect-range

WorldGuard Integration

• Bots are now protected from player-sourced PvP damage inside WorldGuard no-PvP regions
• WorldGuardHelper.isPvpAllowed(location) — fail-open: only regions with explicit DENY block bot damage

Config

• Config version bumped from v47 → v51 — adds pathfinding section, XP pickup gate, and cmd/mine subsystem keys
• body.pick-up-xp — gate orb pickup globally (true by default); XpCommand post-collection cooldown also honours this flag
• pathfinding.* section with parkour, break-blocks, place-blocks, place-material keys

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

v1.5.15 (2026-04-06)

Config Clarity Improvements

• All timing-related values in config.yml now clearly state their unit (ticks or seconds) with human-readable conversion examples
• join-delay / leave-delay section header updated: "Values are in TICKS — 20 ticks = 1 second" with a quick-reference line; both min/max keys now carry inline # ticks (20 ticks = 1 second) comments
• death.respawn-delay comment now shows seconds equivalents: 15 = 0.75 s · 60 = 3 s · 100 = 5 s
• chunk-loading.update-interval comment clarified to "in ticks (20 ticks = 1 second). Lower = more responsive, higher = less overhead."
• swap.session / swap.absence inline comments updated to show real-world time examples (e.g. 60 = 1 min, 300 = 5 min)

Build Pipeline Fixes

• ProGuard obfuscation: removed **.yml from -adaptresourcefilecontents — prevents charset corruption of plugin.yml and language files on Windows builds
• ProGuard obfuscation: removed -dontpreverify — StackMapTable attributes are now preserved so the JVM verifier accepts the obfuscated jar
• ProGuard obfuscation: MySQL / SQLite shaded classes excluded from preverification to prevent IncompleteClassHierarchyException; merged back verbatim into the final jar

v1.5.12 (2026-04-05)

Stable Bot UUID Identity

• BotIdentityCache — each bot name is permanently tied to a stable UUID; LuckPerms data, inventory, and session history persist across restarts
• Storage: in-memory cache → fpp_bot_identities DB table → data/bot-identities.yml YAML fallback

In-Game Settings GUI

• /fpp settings opens a 3-row chest GUI; 5 categories (General, Body, Chat, Swap, Peak Hours)
• Toggle booleans instantly; numeric values via chat-input prompt; reset page to JAR defaults; all changes apply live
• Permission: fpp.settings

Peak Hours Scheduler

• PeakHoursManager scales the bot pool by time-of-day windows (peak-hours.schedule, day-overrides, stagger-seconds)
• Crash-safe: sleeping-bot state persisted in fpp_sleeping_bots DB table, restored at startup
• New command: /fpp peaks [on|off|status|next|force|list|wake <name>|sleep <name>] — requires swap.enabled: true

Per-Bot Chat Control

• Random activity tier per bot: quiet / passive / normal / active / chatty
• /fpp chat <bot> tier|mute|info per-bot controls; /fpp chat all <on|off|tier|mute> for bulk operations
• Event-triggered chat (event-triggers.*) and keyword reactions (keyword-reactions.*)

Bodyless Bot Mode & Bot Types

• bodyless flag — bots without a world location exist in tab-list/chat only, no world entity
• BotType: AFK (passive) and PVP (combat via BotPvpAI)

Config Migration v41 → v44

• v41→v42: Added peak-hours section · v42→v43: Added min-online, notify-transitions · v43→v44: Removed auto-enable-swap

v1.5.10 (2026-04-05)

/fpp swap Toggle Fix

• Running /fpp swap with no arguments now toggles swap on/off — exactly like /fpp chat
• swap-enabled and swap-disabled messages redesigned to match chat toggle style (session rotation has been enabled/disabled)
• swap-status-on / swap-status-off now follow the same is enabled / is disabled pattern as chat status messages

Bot Chat Interval Fix

• Bot chat loops are now restarted on /fpp reload so changes to fake-chat.interval.min/max, fake-chat.chance, and fake-chat.stagger-interval take effect immediately instead of waiting for each bot's old scheduled task to naturally expire
• /fpp reload output shows the new interval range as confirmation

Fake Chat Realism Enhancements

• typing-delay — simulates a 0–2.5 s typing pause before each message
• burst-chance / burst-delay — bots occasionally send a quick follow-up message
• reply-to-mentions / mention-reply-chance / reply-delay — bots can reply when a player says their name in chat
• activity-variation — random per-bot chat frequency tier (quiet/normal/active/very-active)
• history-size — bots avoid repeating their own recent messages
• remote-format — MiniMessage format for bodyless / proxy-remote bot broadcasts

Swim AI

• New swim-ai.enabled config key (default true) — bots automatically swim upward when submerged in water or lava, mimicking a player holding spacebar. Set to false to let bots sink.

Language & Compatibility

• Biome.name() deprecated call replaced with Biome.getKey().getKey() — compatible with Paper 1.22+
• sync-usage and swap-now-usage messages now end with a period for consistency
• Startup banner now shows Bot swap status in the Features section
• Startup banner now shows actual Skin mode (auto/custom/off) instead of disabled