# FakePlayerPlugin<\/p>\n
)
\n
\n
\n
\n
\n
\n)
\n
\n
\n
\n<\/p>\n
> **Advanced Fake Player Spoofer for Paper 1.21+**
\n> Create realistic fake players \u2014 full tab-list entries, physical in-world bodies, skins, combat, pathfinding, automation, and multi-server proxy support.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### Core (Ships with `fpp.jar`)<\/p>\n
– \ud83c\udfad **Realistic Fake Players** \u2014 Full tab-list integration, join\/leave messages, server count spoofing
\n– \ud83c\udfc3 **Physical Bodies** \u2014 NMS `ServerPlayer` entities with hitboxes, collision, damage, death & respawn
\n– \ud83c\udfa8 **Skins** \u2014 Auto-resolve from Mojang, per-bot skin commands, custom pool support
\n– \ud83e\udded **Pathfinding & Automation** \u2014 A* navigation, follow, roam, find-and-mine, sleep, auto-eat, auto-place-bed
\n– \u26cf\ufe0f **Area Mining & Block Placing** \u2014 Cuboid region mining (`\/fpp mine`) and placement (`\/fpp place`) with supply-container restocking
\n– \u2694\ufe0f **PvE Combat** \u2014 Per-bot attack settings, hunt mode, melee cooldowns
\n– \u2699\ufe0f **Per-Bot Settings GUI** \u2014 Shift+right-click any bot for inventories, pathfinding toggles, PvE settings, and automation overrides
\n– \ud83d\udcbe **Persistence** \u2014 Bot positions, tasks, and inventories survive restarts (YAML or database)
\n– \ud83d\uddc4\ufe0f **Database** \u2014 SQLite (local) or MySQL (network \/ multi-server)
\n– \ud83c\udf10 **Proxy Support** \u2014 Velocity & BungeeCord companion plugins for cross-server bot visibility
\n– \ud83d\udd04 **Config Sync** \u2014 Push\/pull config across backend servers via shared MySQL
\n– \ud83d\udce6 **Extension API** \u2014 Drop `.jar` files into `plugins\/FakePlayerPlugin\/extensions\/` to load third-party addons
\n– \ud83d\udd24 **Random Name Generator** \u2014 `bot-name.mode: random` generates realistic Minecraft-style usernames on the fly
\n– \ud83d\udeab **Badword Filter** \u2014 Leet-speak normalization, auto-rename, remote word list
\n– \ud83d\udcca **PlaceholderAPI** \u2014 29+ placeholders for scoreboards, tab headers, and more
\n– \ud83e\uddf1 **WorldEdit & WorldGuard** \u2014 `–wesel` selection flag for mine\/place; region-aware PvP protection
\n– \ud83c\udf43 **Folia Support** \u2014 Compatible with Folia’s regionised threading model out of the box
\n– \ud83d\udcf6 **Simulated Ping** \u2014 Tab-list latency display per bot<\/p>\n
### Extension (`fpp-spoof.jar`)<\/p>\n
Some advanced subsystems require the **`fpp-spoof.jar` extension**:
\n– \ud83e\udd16 AI conversations (`\/msg` replies with personalities)
\n– \ud83d\udcac Fake chat \/ broadcast messaging
\n– \ud83d\udd04 Swap system \/ peak-hours scheduler
\n– \ud83d\udc65 Bot groups
\n– \ud83d\udcf6 Ping command (`\/fpp ping`)
\n– \ud83d\udcbb Stored right-click commands (`\/fpp cmd`)<\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download `fpp.jar` from Modrinth) or build from source.
\n2. Drop the JAR into your server’s `plugins\/` folder.
\n3. Restart the server. The plugin will create `plugins\/FakePlayerPlugin\/` with configs and data folders.
\n4. Configure permissions and `plugins\/FakePlayerPlugin\/config.yml` as needed.
\n5. Run `\/fpp reload` to apply most config changes without restarting.<\/p>\n
### Optional Dependencies
\n– **PlaceholderAPI** \u2014 enables placeholder expansion (`%fpp_count%`, `%fpp_total%`, etc.)
\n– **LuckPerms** \u2014 prefix\/suffix support and bot group assignment
\n– **WorldGuard** \u2014 bot PvP region protection
\n– **WorldEdit** \u2014 `–wesel` flag for area mining\/placing<\/p>\n
—<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
“` # Spawn your first bot # Open its settings # Teleport it to you # Make it follow you —<\/p>\n ## \u2328\ufe0f Commands<\/p>\n All commands are prefixed with `\/fpp` (aliases: `fakeplayer`, `fp`).<\/p>\n | Command | Usage | Description | Permission | ### Quick Examples<\/p>\n “`bash —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n FPP uses a two-tier permission system.<\/p>\n ### Wildcards<\/p>\n | Node | Default | Description | ### Key Nodes<\/p>\n – **Spawn:** `fpp.spawn`, `fpp.spawn.user`, `fpp.spawn.limit.1` through `fpp.spawn.limit.100` ### Quick Setup<\/p>\n “`bash # User # Custom bot limit (5) # Bypass cooldown for VIPs # Hide \/fpp from guests —<\/p>\n ## \ud83d\udcca Placeholders<\/p>\n Requires **PlaceholderAPI**. All prefixed with `%fpp_`.<\/p>\n ### Server-Wide<\/p>\n | Placeholder | Description | ### State<\/p>\n | Placeholder | Description | ### Per-World<\/p>\n | Placeholder | Description | ### Player-Relative<\/p>\n | Placeholder | Description | ### Per-Bot<\/p>\n | Placeholder | Description | —<\/p>\n ## \ud83d\uddc2\ufe0f Configuration<\/p>\n Main file: `plugins\/FakePlayerPlugin\/config.yml`<\/p>\n Key sections: The plugin includes an **automatic config migrator** (current version: **71**). Do not edit `config-version` manually.<\/p>\n —<\/p>\n ## \ud83d\udcda Documentation<\/p>\n – Wiki \u2014 Full documentation —<\/p>\n ## \ud83d\udcac Support<\/p>\n – **Discord:** Join our server —<\/p>\n ## \u2696\ufe0f License<\/p>\n MIT License. See `LICENSE`.<\/p>\n —<\/p>\n > Made with \u2764\ufe0f by Bill_Hub<\/p>\n","protected":false},"excerpt":{"rendered":" Spawn realistic fake players on your Paper server \u2014 complete with tab list presence, server list counts, join\/quit messages, and in-world entities. Can also be used as configurable AFK bots to keep your server active.<\/p>\n","protected":false},"featured_media":68339,"template":"","meta":{"_minecraft_slug":"fake-player-plugin-(fpp)","_minecraft_project_id":"oioBwOz4","_minecraft_author":"bill_hub","_minecraft_license":"MIT","_minecraft_downloads":7083,"_minecraft_follows":24,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"fake-player-plugin-(fpp).zip","_minecraft_size_bytes":414699223,"_minecraft_version_count":48,"_minecraft_updated_at":"2026-05-16T02:49:25.507609Z","_minecraft_date_created":"2026-03-11T03:17:30.479249Z","_minecraft_date_modified":"2026-05-16T19:04:36.406682Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/fake-player-plugin-(fpp)","_minecraft_icon_attachment_id":68339,"_minecraft_imported_at":"2026-06-03T21:36:00+00:00","_minecraft_import_hash":"6ac948c06ca68327529dfde45b98c1cf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,125,89,126,137,127,128,123,985],"mod_loader":[895,131,132,133,986],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-68338","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-velocity","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-velocity","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n# Grant yourself admin access
\n\/lp user
\n\/fpp spawn<\/p>\n
\nshift+right-click the bot entity<\/p>\n
\n\/fpp tph
\n\/fpp follow
\n|———|——-|————-|————|
\n| **spawn** | `[amount] [world [x y z]] [–name
\n| **despawn** | `
\n| **list** | `[page]` | List active bots | `fpp.list` |
\n| **tph** | `[botname|all]` | Teleport bot(s) to you | `fpp.tph` |
\n| **tp** | `[botname]` | Teleport to a bot | `fpp.tp` |
\n| **xp** | `
\n| **move** | `
\n| **mine** | `
\n| **place** | `
\n| **use** | `
\n| **attack** | `
\n| **follow** | `
\n| **find** | `
\n| **sleep** | `
\n| **stop** | `[
\n| **freeze** | `
\n| **inventory** | `
\n| **storage** | `
\n| **save** | \u2014 | Force-save all bots | `fpp.save` |
\n| **setowner** | `
\n| **rename** | `
\n| **info** | `[bot|spawner]
\n| **stats** | \u2014 | Plugin statistics | `fpp.stats` |
\n| **badword** | `
\n| **migrate** | `
\n| **reload** | `[all|config|lang|extensions]` | Hot-reload config | `fpp.reload` |
\n| **settings** | `[bot]` | Open settings GUI | `fpp.settings` |
\n| **help** | `[page]` | Show help menu | `fpp.help` |<\/p>\n
\n\/fpp spawn 5 # Spawn 5 bots
\n\/fpp spawn –name Steve # Spawn a bot named “Steve”
\n\/fpp spawn world_nether 100 64 -200 # Spawn in another world
\n\/fpp despawn all # Remove all bots
\n\/fpp despawn –random –count 3 # Remove 3 random bots
\n\/fpp move bot1 –to Notch # Navigate to player
\n\/fpp move bot1 –roam 500,64,200 25 # Roam in 25-block radius
\n\/fpp mine bot1 diamond_ore –wesel # Mine using WorldEdit selection
\n\/fpp place bot1 –once # Place one block
\n\/fpp attack bot1 –hunt –range 16 # Hunt mobs
\n\/fpp follow bot1 Notch # Follow a player
\n\/fpp find bot1 diamond_ore –radius 64 –count 20
\n\/fpp sleep bot1 100 64 200 50 # Set sleep origin
\n\/fpp stop bot1 # Stop all tasks
\n\/fpp freeze bot1 on # Freeze bot
\n\/fpp inv bot1 # Open inventory
\n\/fpp storage bot1 chest1 # Register container
\n\/fpp rename bot1 builder_01 # Rename bot
\n\/fpp info bot1 # Show session history
\n“`<\/p>\n
\n|——|———|————-|
\n| `fpp.admin` | `op` | Full admin access (same as `fpp.op`) |
\n| `fpp.op` | `op` | Full access to all commands |
\n| `fpp.use` | `true` | User-tier: spawn (1 bot), tph, xp, info (own bots) |<\/p>\n
\n– **Despawn:** `fpp.despawn`, `fpp.despawn.bulk`, `fpp.despawn.own`
\n– **Movement:** `fpp.move`, `fpp.move.to`, `fpp.move.stop`
\n– **Automation:** `fpp.mine`, `fpp.place`, `fpp.use.cmd`, `fpp.attack`, `fpp.attack.hunt`, `fpp.find`, `fpp.follow`, `fpp.sleep`, `fpp.stop`
\n– **Management:** `fpp.freeze`, `fpp.rename`, `fpp.rename.own`, `fpp.inventory`, `fpp.storage`, `fpp.setowner`, `fpp.save`, `fpp.settings`
\n– **System:** `fpp.reload`, `fpp.migrate`, `fpp.badword`
\n– **Bypass:** `fpp.bypass.max`, `fpp.bypass.cooldown`
\n– **Notify:** `fpp.notify` \u2014 update notifications on join<\/p>\n
\n# Admin
\n\/lp group admin permission set fpp.admin true<\/p>\n
\n\/lp group member permission set fpp.use true<\/p>\n
\n\/lp user Alice permission set fpp.spawn.limit.5 true<\/p>\n
\n\/lp group vip permission set fpp.bypass.cooldown true<\/p>\n
\n\/lp group guest permission set fpp.command false
\n“`<\/p>\n
\n|————-|————-|
\n| `%fpp_count%` | Total bots (local + remote) |
\n| `%fpp_local_count%` | Bots on this server |
\n| `%fpp_network_count%` | Bots on other proxy servers |
\n| `%fpp_max%` | Global bot cap (`\u221e` if unlimited) |
\n| `%fpp_real%` | Real players online |
\n| `%fpp_total%` \/ `%fpp_online%` | Total players (real + bots) |
\n| `%fpp_frozen%` | Frozen bot count |
\n| `%fpp_names%` | Comma-separated bot names |
\n| `%fpp_network_names%` | Remote bot names |
\n| `%fpp_version%` | Plugin version |<\/p>\n
\n|————-|————-|
\n| `%fpp_chat%` | `on` \/ `off` |
\n| `%fpp_skin%` | Skin mode |
\n| `%fpp_body%` \/ `%fpp_pushable%` \/ `%fpp_damageable%` \/ `%fpp_tab%` \/ `%fpp_ping%` | `on` \/ `off` |
\n| `%fpp_max_health%` | Max HP |
\n| `%fpp_network%` | `on` \/ `off` (NETWORK mode) |
\n| `%fpp_server_id%` | Server ID |
\n| `%fpp_persistence%` | `on` \/ `off` |
\n| `%fpp_spawn_cooldown%` | Cooldown seconds |<\/p>\n
\n|————-|————-|
\n| `%fpp_count_
\n| `%fpp_real_
\n| `%fpp_total_
\n|————-|————-|
\n| `%fpp_user_count%` | Player’s bot count |
\n| `%fpp_user_max%` | Player’s bot limit |
\n| `%fpp_user_names%` | Player’s bot names |
\n| `%fpp_user_ping%` | First bot’s ping |
\n| `%fpp_user_ping_avg%` | Average ping |<\/p>\n
\n|————-|————-|
\n| `%fpp_ping_
\n| `%fpp_ping_all%` | Bot ping or player ping |
\n| `%fpp_avg_ping%` | Average across all bots |
\n| `%fpp_player_ping%` | Sender’s real ping |<\/p>\n
\n– `limits` \u2014 max bots, user limits, spawn cooldowns
\n– `persistence` \u2014 save\/restore bots on restart
\n– `bot-name` \u2014 name sources and formatting
\n– `badword-filter` \u2014 profanity filtering
\n– `body` \u2014 entity settings (pushable, damageable, item pickup)
\n– `combat` \u2014 health, fall damage, hurt sounds
\n– `death` \u2014 respawn behavior
\n– `chunk-loading` \u2014 keep chunks loaded around bots
\n– `automation` \u2014 auto-eat, auto-place-bed, auto-milk, bad-omen prevention
\n– `head-ai` \u2014 smooth head rotation
\n– `swim-ai` \u2014 automatic upward swimming
\n– `collision` \u2014 push radius, strength, separation
\n– `database` \u2014 SQLite \/ MySQL settings
\n– `config-sync` \u2014 cross-server config push\/pull
\n– `performance` \u2014 position-sync distance tuning
\n– `logging.debug` \u2014 per-subsystem debug flags<\/p>\n
\n– Commands \u2014 Command reference
\n– Permissions \u2014 Permission setup
\n– Configuration \u2014 Config tuning
\n– Extensions \u2014 Extension API guide
\n– Changelog \u2014 Version history<\/p>\n
\n– **Modrinth:** Download updates)
\n– **GitHub Issues:** Report bugs & request features
\n– **GitHub Sponsors:** Sponsor development
\n– **Patreon:** Support FPP<\/p>\n