English | 简体中文 | 繁體中文
FakePlayerPlus
本插件可生成模拟玩家,其行为与真实玩家无异。在服务器端看来,它们被完全识别为真实的、有生命的玩家。
⭐ 如果你喜欢 FakePlayerPlus,请考虑给它点个 Star!这对项目的成长非常有帮助。
本插件灵感来源于 minecraft-fakeplayer 插件。随着 Minecraft 版本的快速迭代,原插件的架构在补丁和维护方面略显吃力,因此我们基于 Kotlin 从头进行了彻底的重构。在继承原插件核心功能的同时,本插件在项目架构上实现了高度解耦,使其成为更现代、更稳健且功能增强的衍生版本。
数据迁移
为了方便从 minecraft-fakeplayer 无缝过渡,本插件提供了数据迁移命令,用于导入原插件的 SQLite 数据,防止模拟玩家的 NBT 数据丢失。
- 注意:执行迁移前,请务必备份原始数据文件,以防止不可逆的数据丢失。
- 步骤:将
plugins/fakeplayer/data.db 中的 minecraft-fakeplayer 数据库文件复制到 plugins/FakeplayerPlus 目录中。然后执行 /fp import data.db fake_player_profile 以导入数据。
特性
- 与真实玩家无异
- 保持区块加载:召唤模拟玩家帮助你保持区块加载和怪物刷新
- 行为与动作控制:支持控制模拟玩家执行攻击、挖掘、跳跃、钓鱼等动作,并支持周期性循环。
- 开发者 API:核心功能已抽象为 api 包,可供插件开发者调用。
- 语言文件:支持自定义语言文件并实现热重载
- 动态数量调整:当服务器 TPS 过低时,可以踢出模拟玩家并降低召唤上限
- 设置 GUI:通过对话框界面快速切换实体碰撞、无敌模式、自动补货等功能。

- 动作 GUI:通过对话框界面轻松执行模拟玩家动作

- 物品存储:你可以使用模拟玩家的物品栏来存储物品。

- 聊天功能:使用 /fp chat 让模拟玩家发送聊天消息
- 延迟 (PING) 设置:配置模拟玩家的 ping 值,或模拟 ping 抖动以伪装真实玩家
- 多用户管理:玩家可以互相共享模拟玩家的控制权限
配置
请参阅插件目录下的 config.yml 配置文件
命令
[!IMPORTANT]
如果你不限制玩家的各种命令,可以直接给予玩家 fakeplayer.basic 权限,该权限包含所有安全权限
| 命令 |
描述 |
权限 |
备注 |
| /fp help |
显示帮助列表 |
fakeplayer.help |
支持通过 /fp help [page] 进行分页查看 |
| /fp spawn |
召唤一个假人玩家 |
fakeplayer.spawn |
召唤上限可在配置文件中设置 |
|
|
fakeplayer.spawn.limit.<node> |
在配置文件中配置节点,为特定玩家/组设置自定义召唤上限 |
| /fp spawn <name> |
以指定名称召唤 |
fakeplayer.spawn.name |
不建议普通玩家使用,因为会占用未注册的真人玩家名称 |
| /fp select <name> |
选择假人玩家 |
fakeplayer.select |
任何动作命令都可以通过在命令末尾添加 <name> 来针对特定的假人玩家 |
| /fp remove |
移除假人玩家 |
fakeplayer.remove |
--all 可移除所有假人玩家 |
| /fp kill |
杀死假人玩家 |
fakeplayer.kill |
--all 可杀死所有假人玩家 death-action 选项可在 config.yml 中配置以模拟原版插件行为。注意:如果服务器禁用了 keep-inventory,kill 命令会导致物品从背包中掉落。 |
| /fp invsee |
查看假人玩家背包 |
fakeplayer.invsee |
玩家也可以右键点击假人玩家来打开它 |
| /fp enderchest |
查看假人玩家末影箱 |
fakeplayer.enderchest |
玩家也可以按住 Shift 右键点击假人玩家来打开它 |
| /fp tp |
传送至假人玩家处 |
fakeplayer.tp |
|
| /fp tphere |
将假人玩家传送到你身边 |
fakeplayer.tp |
|
| /fp tpswap |
与假人玩家交换位置 |
fakeplayer.tp |
|
| /fp tppos |
将假人玩家传送到指定坐标 |
fakeplayer.tp |
|
| /fp skin <name> |
为假人玩家设置正版账号皮肤 |
fakeplayer.skin |
此命令有 60 秒冷却时间 |
| /fp cmd |
强制假人玩家执行命令 |
fakeplayer.cmd |
如果命令包含空格或需要 / 前缀,请用双引号包裹,例如 /fp cmd "kill @p" |
| /fp swap |
交换主手和副手物品。 |
fakeplayer.swap |
|
| /fp chat |
强制假人玩家发送聊天消息 |
fakeplayer.chat |
如果消息包含空格,请将文本用双引号 " 包裹 |
| /fp settings |
打开设置 GUI |
fakeplayer.settings |
|
| /fp action |
打开动作列表 GUI |
fakeplayer.action |
仅当玩家拥有相应权限时才会显示动作按钮(见下文) |
| /fp action start <action> |
打开动作执行 GUI |
fakeplayer.action.<action> |
|
| /fp action execute <action> |
直接执行动作 |
fakeplayer.action.<action> |
|
| /fp owner list |
列出假人玩家的拥有者 |
fakeplayer.owner.list |
|
| /fp owner add |
将玩家添加为假人玩家的拥有者 |
fakeplayer.owner.add |
|
| /fp owner remove |
撤销玩家的拥有者权限 |
fakeplayer.owner.remove |
|
| /fp reload |
重新加载配置 |
fakeplayer.reload |
|
PlaceholderAPI
| 占位符 |
类型 |
描述 |
示例输出 |
%fakeplayer_total% |
Global |
获取当前在线的假人玩家总数 |
5 |
%fakeplayer_list% |
Global |
获取所有当前在线假人玩家的名称列表 (分隔符可在语言文件中配置) |
FakePlayer_1,FakePlayer_2 |
%fakeplayer_list_0_name% |
Global |
获取列表中指定 index 位置的假人玩家信息(name 可替换为下方任何 FakePlayer 类型的属性,如 uuid、spawner 等) |
FakePlayer_1 |
%fakeplayer_isfake% |
Player |
检查当前玩家是否为假人玩家 |
true / false |
%fakeplayer_name% |
FakePlayer |
假人玩家的名称 |
FakePlayer_1 |
%fakeplayer_uuid% |
FakePlayer |
假人玩家的 UUID |
d6850f71-24e2-3d31-9ad4-1f5806837a17 |
%fakeplayer_spawner% |
FakePlayer |
获取召唤该假人玩家的创建者名称 |
Steve |
%fakeplayer_spawntime% |
FakePlayer |
假人玩家的召唤时间 (时间格式可在语言文件中配置) |
2026-07-01 00:00:00 |
%fakeplayer_actions% |
FakePlayer |
获取假人玩家当前正在执行的动作列表 (本地化文本和分隔符可在语言文件中配置) |
Attack|Mine |
English | 简体中文 | 繁體中文
FakePlayerPlus
This plugin generates fake players that act as real ones. To the server, they are fully recognized as real, living players.
⭐ If you like FakePlayerPlus, consider giving it a Star! It really helps the project grow.
This plugin is inspired by minecraft-fakeplayer plugin. With the rapid iteration of Minecraft versions, the original plugin's architecture is slightly struggling in patching and maintenance, so it was completely refactored from the ground up based on Kotlin. While inheriting the core features of the original plugin, this plugin achieves a high degree of decoupling in project architecture, making it a more modern, robust, and enhanced derivative version.
Migration
To facilitate a seamless transition from minecraft-fakeplayer, this plugin provides a data migration command to import SQLite data from the original plugin, preventing the loss of fake player NBT data.
- Note: Before performing the migration, please make sure to back up your original data files to prevent irreversible data loss.
- Steps: Copy the
minecraft-fakeplayer database file from plugins/fakeplayer/data.db into the plugins/FakeplayerPlus directory. Then, execute /fp import data.db fake_player_profile to import the data.
Features
- Identical to Real Players
- Keep Chunks Loaded: Summon fake players to help you keep chunks loaded and mobs refreshing
- Behavior & Action Control: Supports controlling fake players to perform actions such as attacking, mining, jumping, fishing, etc., and supports periodic loops.
- Developer API: Core features have been abstracted into an api package, available for plugin developers to invoke.
- Language Files : Custom language files supported with hot-reload
- Dynamic Count Adjustment : When the server TPS is too low, it can kick fake players and lower the summon limit
- Settings GUI : Quickly toggle entity collision, invincibility mode, auto-restock, and other features via Dialog interface.

- Action GUI : Easily execute fake player actions via Dialog interface

- Inventory Storage: You can use the fake player's inventory to store items.

- Chat Feature : Make fake players send chat messages using /fp chat
- Latency (PING) Settings : Configure fake player ping values, or simulate ping jitter to camouflage real players
- Multi-user Management : Players can share fake player control rights with each other
Configuration
Please refer to the config.yml configuration file in the plugin directory
Commands
[!IMPORTANT]
If you don't restrict various commands for players, you can directly give players fakeplayer.basic, this permission includes all safe permissions
| Command |
Description |
Permission |
Notes |
| /fp help |
Display help list |
fakeplayer.help |
Supports pagination via /fp help [page] |
| /fp spawn |
Summon a fake player |
fakeplayer.spawn |
The summon limit can be configured in the configuration file |
|
|
fakeplayer.spawn.limit.<node> |
Configure node in the configuration file to set custom summon limits for specific players/groups |
| /fp spawn <name> |
Summon with a specific name |
fakeplayer.spawn.name |
Not recommended for regular players because it occupies unregistered real player names |
| /fp select <name> |
Select a fake player |
fakeplayer.select |
Any action command can target a specific fake player by adding <name> at the end of the command |
| /fp remove |
Remove a fake player |
fakeplayer.remove |
--all to remove all fake players |
| /fp kill |
Kill the fake player |
fakeplayer.kill |
--all to kill all fake players The death-action option can be configured in the config.yml to mimic original plugin behavior. Note: If keep-inventory is disabled on the server, the kill command will cause items to drop from the inventory. |
| /fp invsee |
View fake player inventory |
fakeplayer.invsee |
Players can also right-click the fake player to open it |
| /fp enderchest |
View fake player enderchest |
fakeplayer.enderchest |
Players can also shift-right-click the fake player to open it |
| /fp tp |
Teleport to the fake player |
fakeplayer.tp |
|
| /fp tphere |
Teleport the fake player to you |
fakeplayer.tp |
|
| /fp tpswap |
Swap positions with the fake player |
fakeplayer.tp |
|
| /fp tppos |
Teleport fake player to specific position |
fakeplayer.tp |
|
| /fp skin <name> |
Set a premium account skin for the fake player |
fakeplayer.skin |
This command has a 60-second cooldown |
| /fp cmd |
Force fake player to execute a command |
fakeplayer.cmd |
If the command contains spaces or requires a / prefix, wrap it in ", e.g., /fp cmd "kill @p" |
| /fp swap |
Swap main and off-hand items. |
fakeplayer.swap |
|
| /fp chat |
Force fake player to send a chat message |
fakeplayer.chat |
Wrap the text in " if the message contains spaces |
| /fp settings |
Open the Settings GUI |
fakeplayer.settings |
|
| /fp action |
Open the Action List GUI |
fakeplayer.action |
The action buttons will only display if the player has the corresponding permission (see below) |
| /fp action start <action> |
Open the Action Execution GUI |
fakeplayer.action.<action> |
|
| /fp action execute <action> |
Execute Action directly |
fakeplayer.action.<action> |
|
| /fp owner list |
List the owners of the fake player |
fakeplayer.owner.list |
|
| /fp owner add |
Add a player as an owner of the fake player |
fakeplayer.owner.add |
|
| /fp owner remove |
Revoke a player's owner permissions |
fakeplayer.owner.remove |
|
| /fp reload |
Reload configuration |
fakeplayer.reload |
|
PlaceholderAPI
| Placeholder |
Type |
Description |
Example Output |
%fakeplayer_total% |
Global |
Gets the total number of fake players currently online across the server |
5 |
%fakeplayer_list% |
Global |
Gets the list of names of all fake players currently online (The separator can be configured in the language file) |
FakePlayer_1,FakePlayer_2 |
%fakeplayer_list_0_name% |
Global |
Gets the information of the fake player at the specified index in the list (name can be replaced with any FakePlayer-type attribute below, e.g., uuid, spawner, etc.) |
FakePlayer_1 |
%fakeplayer_isfake% |
Player |
Checks if the current player is a fake player |
true / false |
%fakeplayer_name% |
FakePlayer |
The name of the fake player |
FakePlayer_1 |
%fakeplayer_uuid% |
FakePlayer |
The UUID of the fake player |
d6850f71-24e2-3d31-9ad4-1f5806837a17 |
%fakeplayer_spawner% |
FakePlayer |
Gets the name of the creator who summoned this fake player |
Steve |
%fakeplayer_spawntime% |
FakePlayer |
The time when the fake player was summoned (The time format can be configured in the language file) |
2026-07-01 00:00:00 |
%fakeplayer_actions% |
FakePlayer |
Gets the list of actions currently being executed by the fake player (The localized text and separator can be configured in the language file) |
Attack|Mine |
评论 0
登录后参与评分
还没有评论,来抢沙发吧