Fake Player Plugin (FPP)

v1.5.6 (2026-04-03)

Knockback fix (1.21.9 – 1.21.11)

• Bots now correctly receive knockback on 1.21.9+ servers
• In MC 1.21.9 Mojang replaced the individual getXa/Ya/Za() packet accessors with a single getMovement() → Vec3; the old code silently skipped knockback because all accessors returned null
• New tiered strategy system resolves the correct API once at startup and caches it — zero reflection overhead per hit:
  • GET_MOVEMENT (1.21.9+): packet.getMovement() → Vec3 → player.lerpMotion(Vec3) (matches hello09x/fakeplayer reference plugin)
  • GET_XA (≤ 1.21.8): packet.getXa/Ya/Za() → lerpMotion(double,double,double) or setDeltaMovement(Vec3) fallback
  • NONE: no compatible API found — silently skipped, debug-logged
• Enable logging.debug.nms: true to see which strategy was selected on first use

Double-disconnect crash fix (Paper 1.21+)

• Fixed IllegalStateException: Already retired spam in server logs when a bot is slain
• Root cause: injectFakeListener was replacing ServerPlayer.connection but not Connection.packetListener — the field Connection.handleDisconnection() uses to call onDisconnect(); the vanilla SGPL (with no double-retirement guard) was being called instead of our override
• Fix: injectPacketListenerIntoConnection() now scans the Connection object's field hierarchy at spawn time and replaces the vanilla listener reference with our FakeServerGamePacketListenerImpl; the existing onDisconnect try-catch then correctly suppresses the second "Already retired" error
• Side-effect improvement: Connection.tick() now calls our fake listener's tick() instead of the vanilla SGPL, eliminating any lingering awaitingPositionFromClient processing

Bot Protection System

• Command blocking — bots can no longer execute commands from ANY source (4-layer protection system)
• Lobby spawn fix — 5-tick grace period prevents lobby plugins from teleporting bots during spawn
• New BotCommandBlocker listener blocks commands at LOWEST, HIGHEST, and MONITOR priorities
• New BotSpawnProtectionListener prevents lobby/spawn plugin teleports
• Command suggestion blocking prevents auto-command discovery
• Blocks all execution paths: typing, Player.performCommand(), Bukkit.dispatchCommand()
• Works with first-join command plugins, auto-command schedulers, and permission-based executors