开源 工具 FakePlayerPlus 假人插件支持Folia v1.10.0

FakePlayerPlus​

作者：xiplugin
github：https://github.com/xiplugin/FakePlayerPlus
这个插件模拟了真实玩家，对服务端而言，这个插件生成的假人就是一个真正的“活人”。

本插件灵感来源于minecraft-fakeplayerplugin。随着Minecraft版本的快速迭代，原插件架构在补丁维护方面略显吃力，因此基于Kotlin进行了彻底的重构。在继承原插件核心功能的同时，本项目架构实现了高度解耦，使其成为一个更现代化、健壮性更强且功能增强的衍生版本。

迁移​

为便于实现从minecraft-fakeplayer的无缝过渡，本插件提供了数据迁移命令，用于从原插件导入SQLite数据，避免假玩家NBT数据丢失。

• 注意: 在进行迁移操作前，请务必备份原有的数据文件，防止不可逆的数据丢失
• 步骤: 将minecraft-fakeplayer的数据库文件plugins/fakeplayer/data.db 复制到 plugins/FakeplayerPlus 目录中。执行 /fp import data.db fake_player_profile 进行导入。

功能​

• 等同真实玩家
• 保持区块加载：召唤假人帮你保持区块加载、怪物刷新
• 背包存放物品：可以使用假人的背包来存放物品。
• 行为动作控制：支持控制假人执行攻击、挖掘、跳跃、钓鱼等动作，并支持周期性循环。
• 开发者API：已将基本功能抽象成api包，可供插件开发者调用
• 语言文件：可自定义语言文件，并支持热重载
• 动态调整假人数量：服务器TPS过低时可踢出假人并降低召唤数量限制
• 假人设置GUI：可通过Dialog界面快速开关实体碰撞、无敌模式、自动补货等功能。
• 假人动作GUI：可通过Dialog界面快速执行假人动作
• 假人聊天功能：可通过/fp chat让假人发送聊天消息
• 假人PING设置：可配置假人ping值，也可模拟ping抖动伪装活人
• 多人管理：玩家可以互相分享假人使用权

配置​

请参考插件目录下的 config.yml 配置文件

命令

如果您不限制玩家的各种命令，可以直接赋予玩家fakeplayer.basic，此权限包含所有安全权限

Command Description 权限 注意事项
/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用于击杀所有假玩家

该选项可在 config.yml 中配置以模拟原始插件行为。注意：如果服务器禁用了 keep-inventory，kill 命令将导致物品从背包中掉落。death-action

/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 chat 强制假玩家发送聊天消息 fakeplayer.chat 将文本包裹在"如果消息包含空格

/fp settings 打开设置GUI fakeplayer.settings

/fp action 打开动作列表GUI fakeplayer.action 只有当玩家拥有相应权限时，动作按钮才会显示（见下文）

/fp action start <action> 打开 Action 执行 GUI fakeplayer.action.<action>

/fp action execute <action> 直接执行 Action fakeplayer.action.<action>

/fp owner list 列出 Fake Player 的所有者 fakeplayer.owner.list

/fp owner add 将玩家添加为 Fake Player 的所有者 fakeplayer.owner.add

/fp owner remove 撤销玩家的所有者权限 fakeplayer.owner.remove

/fp reload 重新加载配置 fakeplayer.reload

Fake Player 独立设置 / 动作
请参考/fp settings和/fp actioncommands。

PlaceholderAPI
占位符 类型 Description 示例输出
%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% 玩家 检查当前玩家是否为伪造玩家 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