- 版权类型
- 转载
- 插件中文名称
- 假人插件
- 插件英文名称
- Fake Player Plugin
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- PufferFish
- Leaves
- 语言支持
- English
- 适配版本(Java)
- 26.x
- 1.21
[MD]
# FakePlayerPlugin (FPP)
[](LICENSE)
[](https://papermc.io)
[](https://papermc.io/software/folia)
> **为 Paper、Purpur 和 Folia 1.21+ 打造的高阶 NPC / 机器人插件**
FPP 会在服务端生成像真实玩家一样行动的机器人实体 —— 非常适合 **AFK 挂机农场、自动化任务、测试以及 NPC 模拟**。请注意,它**不是**用来虚增在线人数或冒充玩家的工具:机器人不会出现在 Tab 列表和服务器 Ping 列表里,头上永远戴着强制显示的 “ʙᴏᴛ ʙʏ {主人}” 名牌,不会获得任何进度成就,也绝不会冒用任何真实账号的身份。
---
## 功能亮点
- 🧭 **真正的寻路引擎** —— 基于 [Pathetic](https://github.com/bsommerfeld/pathetic) 的 A* 导航,支持跑酷、破块、搭桥、带有硬性放弃预算的卡死检测、飞行前路径校验,以及 Baritone 风格的粒子调试视图
- 🗡️ **PVE 战斗** —— 每个机器人独立智能攻击,可选攻击的生物类型、探测范围、目标优先级、真实武器冷却节奏,并配合寻路进行追击
- ⛏️ **自动搜寻矿物** —— `/fpp find` 搜索 → 寻路 → 挖掘循环,自动装备工具,防卡死监控,并能将产物存入已登记的存储容器
- 🎯 **精准点击** —— `/fpp left-click` / `/fpp right-click` 会瞄准你视线所对的**精确坐标点**,如果目标超出范围,机器人会走到一个可触及的有利位置(优先选择你站的地方),并且只有在准星真正对准按钮/拉杆的碰撞箱时才会触发
- ⏸️ **一次只做一件事** —— 所有任务互斥(不会同时进行多个操作);中断事件(比如自动进食)会暂停当前任务,结束后恢复
- 🍗 **自动进食** —— 每个机器人独立控制:饥饿时从背包里吃东西(优先级:副手 → 快捷栏 → 背包),可配置允许的食物列表和饥饿阈值;会暂停当前任务,吃完后换回之前拿的物品
- 🎨 **稀有度皮肤池** —— 机器人的皮肤从可配置的稀有度分级中随机抽取(`skins/1-<N>%.txt` 文件里存放 NameMC 链接),通过 MineSkin 一次签名后永久缓存,并自动识别 slim/classic 模型
- 🆔 **可读的机器人 UUID** —— 固定的 `fb07…` UUID,其中嵌入了机器人编号(例如 `bot2` → `fb070000-…-000000000002`);与真实账号零碰撞风险
- 🏷️ **实时名牌** —— 三行展示,类似人台标签,包含实时活动状态(空闲 / 移动 / 挖掘 / 战斗 / 进食 / 搜索 / 潜行 ……)
- 🖥️ **完整的 GUI 套件** —— 机器人列表中心(搜索、排序、实时刷新、一键生成 & 设置),每个机器人的独立设置界面(通用、PVE、寻路、皮肤、**自动进食**、改名、危险操作),全局设置(含运行时调试开关),以及分类帮助 GUI
- 🫥 **对玩家不可见** —— 不显示在 Tab 列表,不计入服务器列表人数/样本,不获得进度成就,没有加入/离开/死亡聊天消息
- 💾 **数据持久化** —— 机器人、背包、经验值和任务都能在重启后保留(支持 SQLite 或 MySQL)
- 🌐 **代理网络支持** —— 支持 Velocity / BungeeCord,可使用共享 MySQL,跨服占位符,以及配置同步
- ✅ **Folia 支持** —— 完全兼容 Folia 的区域线程架构
- 📊 **性能工具** —— `/fpp perf` 仪表盘、历史记录、基准测试报告,以及与 Spark 的集成
## 快速上手
1. 把 `fake-player-plugin-<version>-all.jar` 丢进 `plugins/` 文件夹,重启服务器。
2. 给自己权限:`/lp user <你的ID> permission set fpp.admin true`
3. `/fpp spawn` —— 在你当前位置生成一个自动命名的机器人(`bot`、`bot2`……)。
4. `/fpp spawn --name 矿工` —— 生成一个自定义名字的机器人。
5. `/fpp list` —— 打开 GUI 中心:点击机器人管理它,或者继续生成更多,也可以打开全局设置。
完整文档请查阅 [wiki](frontend/wiki/Home.md):命令、权限、配置、占位符、数据库/代理设置以及常见问题。
## 从源码构建
需要 **JDK 21+**。paperweight 开发依赖包会自动下载。
```bash
./gradlew clean shadowJar
# → build/libs/fake-player-plugin-<version>-all.jar
```
运行测试:`./gradlew test`
## 刻意移除的功能
以下功能**有意从代码库中移除**,且不应重新引入 —— 任何恢复它们的 PR 都将被拒绝。完整政策和理由请见 [CONTRIBUTING.md](https://github.com/Pepe-tf/Fake-Player-plugin-2.0/blob/master/CONTRIBUTING.md):
- **玩家冒充 / 冒名顶替** —— 任何让机器人伪装成特定真实玩家的行为(例如使用真实账号的 UUID、按玩家名查找正版皮肤/身份、移除强制机器人名牌、在 Tab 列表或服务器 Ping 中显示机器人)
- **机器人聊天** —— 机器人在聊天中完全保持沉默,这是设计如此
- **运行时扩展 / 附加加载器** —— 不允许外部代码加载到 FPP 中;如果需要扩展功能,请通过普通 Bukkit 插件监听触发的 `FppBot*` 事件来实现
- **许可证 / DRM 检测** —— 本插件开源且无条件运行
## 相关链接
- **Discord:** https://discord.gg/Q9cd9frzRt
- **Modrinth:** https://modrinth.com/plugin/fake-player-plugin-(fpp)
- **Wiki:** [https://github.com/Pepe-tf/Fake-Player-plugin-2.0/blob/master/frontend/wiki/Home.md)
## 许可证
MIT —— 见 [LICENSE](https://github.com/Pepe-tf/Fake-Player-plugin-2.0/blob/master/LICENSE)。
[/MD]