Fake Player Plugin (FPP)

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bungeecord folia paper purpur velocity

标签： game-mechanics management mobs

FakePlayerPlugin (FPP)

Advanced NPC / Bot plugin for Paper, Purpur, and Folia 1.21+

FPP spawns server-side bot entities that behave like real players — useful for AFK farms,
automated tasks, testing, and NPC simulations. It is deliberately not a fake-online-count or
player-spoofing tool: bots are hidden from the tab list and server-list ping, always wear a
mandatory "ʙᴏᴛ ʙʏ {owner}" nametag, earn no advancements, and can never take a real account's
identity.

Features

• ? Real pathfinding engine — Pathetic-backed A*
  navigation with parkour, block-breaking, bridging, stuck detection with a hard give-up budget,
  pre-flight path verification, and a Baritone-style particle debug view
• ?️ PVE combat — per-bot smart attack with mob-type selection, detect range, target priority,
  real weapon-cooldown pacing, and pathfinding-linked chasing
• ⛏️ Find automation — /fpp find search → path → mine loops with tool auto-equip, anti-stuck
  watchdogs, and inventory-aware deposits into registered storages
• ? Precise clicking — /fpp left-click / /fpp right-click aim at the exact point you're
  looking at, walk to a reachable vantage (preferring your own standing spot) when the target is out
  of reach, and only trigger a button/lever when actually aimed at its hit box
• ⏸️ One action at a time — tasks are mutually exclusive (no multitasking); an interrupt such as
  auto-eat pauses the current task and resumes it afterward
• ? Auto-eat — per bot: eats from its inventory when hungry (off-hand → hotbar → inventory
  priority), with a configurable allowed-food list and hunger threshold; pauses the current task,
  eats, then switches back to what it was holding
• ? Rarity skin pools — bots roll their skin from configurable rarity tiers
  (skins/1-<N>%.txt files of NameMC URLs), signed once via MineSkin and cached forever, with
  slim/classic model auto-detection
• ? Readable bot UUIDs — deterministic fb07… UUIDs with the bot number embedded
  (bot2 → fb070000-…-000000000002); zero collision risk with real accounts
• ?️ Live nametags — three-row mannequin-style tag with a real-time activity line
  (idle / moving / mining / fighting / eating / searching / sneaking …)
• ?️ Full GUI suite — bot list hub (search, sort, live refresh, spawn & settings shortcuts),
  per-bot settings (general, PVE, pathfinding, skin, auto-eat, rename, danger), global settings
  with runtime debug toggles, and a categorized help GUI
• ? Invisible to players — no tab-list entry, no server-list count/sample entry, no
  advancements, no join/leave/death chat noise
• ? Persistence — bots, inventories, XP, and tasks survive restarts (SQLite or MySQL)
• ? Proxy networks — Velocity/BungeeCord support with shared MySQL, cross-server placeholders,
  and config sync
• ✅ Folia support — full compatibility with Folia's region-threaded architecture
• ? Performance tooling — /fpp perf dashboard, history, benchmark reports, Spark integration

Quick Start

1. Drop fake-player-plugin-<version>-all.jar into plugins/ and restart.
2. Grant yourself access: /lp user <you> permission set fpp.admin true
3. /fpp spawn — spawns one auto-named bot (bot, bot2, …) at your location.
4. /fpp spawn --name Miner — spawns one custom-named bot.
5. /fpp list — the GUI hub: click a bot to manage it, spawn more, or open global settings.

Full documentation lives in the wiki: commands, permissions,
configuration, placeholders, database/proxy setup, and FAQ.

Deliberately Removed Capabilities

Several capabilities were intentionally removed from this codebase and should not be
reintroduced — pull requests restoring them will be declined. See
CONTRIBUTING.md for the full policy and rationale:

• Player spoofing / impersonation — anything that lets a bot pose as a specific real player
  (real-account UUIDs, premium skin/identity lookups by player name, removing the mandatory bot
  nametag, showing bots in the tab list or server-list ping)
• Bot chat — bots are fully silent in chat by design
• The runtime extension/addon loader — external code cannot be loaded into FPP; integrate from
  a normal Bukkit plugin via the fired FppBot* events instead
• License/DRM checks — the plugin is open source and runs unconditionally

Links

• Discord: https://discord.gg/Q9cd9frzRt
• Modrinth: https://modrinth.com/plugin/fake-player-plugin-(fpp)
• Wiki: frontend/wiki/Home.md

License

MIT — see LICENSE.