FakePlayerPlus

插件

· 作者 coderxi

一款现代、强大且支持 Paper/Folia 的 Minecraft 假玩家插件,使用 Kotlin 从头重写。它是 tanyaofei/minecraft-fakeplayer 的增强版继任者。

0 本站下载 0 关注 更新于 5 天前

最新 2.2.3 · 26.3 · Folia / Paper

一键开服(送7天)

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:通过对话框界面快速切换实体碰撞、无敌模式、自动补货等功能。 FakePlayerSettings
  • 动作 GUI:通过对话框界面轻松执行模拟玩家动作 FakePlayerActions
  • 物品存储:你可以使用模拟玩家的物品栏来存储物品。 FakePlayerInventory
  • 聊天功能:使用 /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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源