FAKE PLAYER PLUGIN (FPP)

Spawn realistic fake players on your Paper server — with tab list presence, server list count, join/leave messages, in-world bodies, guaranteed skins, chunk loading, bot swap/rotation, fake chat, and full hot-reload support.

Downloads:
- Modrinth
- BuiltByBit
- Spigot
- Discord (support & contact)

What It Does:
- Shows up in the tab list and server player count
- Broadcasts join, leave, and kill messages
- Spawns as real entities (pushable, damageable, solid)
- Always uses real skins (no Steve/Alex unless configured)
- Loads chunks like a real player
- Rotates head to nearby players
- Sends fake chat messages from a configurable pool
- Automatically swaps bots with new names and personalities
- Persists across server restarts
- Freeze any bot with /fpp freeze
- PlaceholderAPI support
- Fully hot-reloadable (no restart needed)

Requirements:
- Paper / Purpur 1.21.9+
- Java 21+
- PacketEvents 2.x
- LuckPerms (optional)
- PlaceholderAPI (optional)

SQLite is bundled; MySQL supported for multi-server setups.

Installation:
1. Download the plugin from one of the links above
2. Place fpp-1.3.0.jar in your plugins/ folder
3. Install PacketEvents in the same folder
4. Restart your server (config files generated automatically)
5. Edit plugins/FakePlayerPlugin/config.yml as needed
6. Run /fpp reload to apply changes

Updating: FPP automatically migrates config files and creates a timestamped backup.

Important Version Warning:
FPP only supports Minecraft 1.21.9+ on Paper or Purpur.

Not supported:
- 1.21.8 or older
- Spigot / Bukkit / Fabric / Forge

Running unsupported platforms:
- No support will be provided
- Bug reports may be ignored

Supported:
- Paper / Purpur 1.21.9+
- Java 21+

Commands:
All commands under /fpp (aliases /fakeplayer, /fp)
- /fpp — Plugin info
- /fpp help [page] — Paginated help
- /fpp spawn [amount] [--name <name>] — Spawn bots
- /fpp delete <name|all> — Remove bots
- /fpp list — List active bots
- /fpp chat [on|off|status] — Toggle fake chat
- /fpp swap [on|off|status] — Toggle bot swap
- /fpp freeze <name|all> [on|off] — Freeze or unfreeze bots
- /fpp stats — Live stats panel
- /fpp reload — Reload configuration
- /fpp info [bot <name> | spawner <name>] — Query DB
- /fpp tp <name> — Teleport to a bot
- /fpp tph — Teleport your bot to you

Permissions:

Admin:
- fpp.* — All permissions
- fpp.spawn, fpp.delete, fpp.list
- fpp.chat, fpp.swap, fpp.freeze
- fpp.stats, fpp.reload, fpp.info
- fpp.tp, fpp.bypass.maxbots, fpp.bypass.cooldown, fpp.admin.migrate

User (enabled for all players by default):
- fpp.user.* — All user commands
- fpp.user.spawn — Spawn personal bot
- fpp.user.tph — Teleport bot to you
- fpp.user.info — View bot info

Links:
- Modrinth
- BuiltByBit
- Spigot
- GitHub
- Discord