# FakePlayerPlugin Wiki

> Advanced NPC / Bot Plugin for Paper/Purpur 1.21+

Welcome to the FakePlayerPlugin (FPP) wiki. FPP spawns server-side bot entities that behave like players — useful for **AFK farms, automated tasks, testing, and NPC simulations**. It is **not** a fake-online-count or player-spoofing tool.

This documentation covers the **base plugin only** — features that ship in the core `fpp.jar`.

Some advanced subsystems are implemented as extensions and are not part of the base plugin. Those are noted where applicable. You can find official extensions on the [FPP Marketplace](https://mp.fpp.wtf/resources/).

---

## Getting Started

| Page | Description |
|------|-------------|
| [Getting Started](Getting-Started) | Installation, first setup, and quick start |
| [Commands](Commands) | Full command reference with examples |
| [Permissions](Permissions) | Permission nodes and setup guide |
| [Configuration](Configuration) | config.yml reference and tuning |

## Systems

| Page | Description |
|------|-------------|
| [Placeholders](Placeholders) | PlaceholderAPI integration reference (70+ placeholders including cross-server totals) |
| [Database](Database) | SQLite / MySQL setup, network tables, and proxy-merged architecture |
| [Proxy Support](Proxy-Support) | Velocity / BungeeCord multi-server networks with shared MySQL |
| [Config Sync](Config-Sync) | Synchronize configs across proxy backends |
| [Extensions](Extensions) | Extension API for third-party developers |

## Reference

| Page | Description |
|------|-------------|
| [FAQ](FAQ) | Common questions and troubleshooting |
| [Changelog](Changelog) | Version history and release notes |

---

## Quick Links

- **Source:** https://github.com/Pepe-tf/fake-player-plugin
- **Discord:** https://discord.gg/RfjEJDG2TM
- **Modrinth:** https://modrinth.com/plugin/fake-player-plugin-(fpp)
- **Marketplace:** https://mp.fpp.wtf/resources/
- **License:** MIT
