mirror of
https://github.com/tanyaofei/minecraft-fakeplayer.git
synced 2025-07-13 21:02:27 +08:00
A plugin for minecraft server to spawn fake players, inspired by Carpet Mod
src/main | ||
.gitignore | ||
pom.xml | ||
README.md |
FakePlayer - 假人插件
这个插件模拟出真实的玩家来保证区块的加载以及怪物的生成,生电服利器。
支持版本
1.20.*
的 paper, purpur (建议)
特性
- 这个假人有点"真", 与真实玩家一致, 可以保持区块的刷新和怪物生成, 距离取决于服务器设置的模拟距离
- 假人的原生数据档案、成就数据不会存档,但第三方的档案还会存在
命令
- /fp create - 创建一个假人
- /fp kill - 移除假人
- /fp tp - 传送到假人身边
- /fp tps - 与假人交换位置
- /fp tphere - 将假人传送到自己身边
- /fp expme - 转移假人的经验值
- /fp health - 查看假人的生命值
- /fp exp - 查看假人的经验值
- /fp config - 玩家个性化配置
- /fp config set - 设置个性化配置
- /fp config get - 查看个性化配置
- /fp attack - 让假人点击鼠标左键 (实验性)
- /fp use - 让假人点击鼠标右键 (实验性)
此外,假人是一个模拟玩家,因此可以被任何指令所识别比如 kick
, tp
, ban
等等
权限
默认所有权限是 op 拥有,请通过权限管理插件来分配!
-
fakeplayer.spawn -
create
,list
,kill
等使用命令权限 -
fakeplayer.tp -
tp
,tps
,tphere
等传送指令权限 -
fakeplayer.profile -
exp
,health
等查看假人信息命令权限 -
fakeplayer.action -
drop
,dropinv
,invsee
,sneak
等控制命令权限 -
fakeplayer.exp -
expme
等命令权限 -
fakeplayer.experimental.action -
attack
,use
等控制命令权限 (目前为实验性的, 未经过可靠性验证, 待成熟后将会移至fakeplayer.action
) -
fakeplayer.admin - 管理员权限
config 相关命令没有配置权限节点
已知问题
- 与
clearfog
清除迷雾插件不兼容, 会导致假人生成后被随机传送
配置项
这个不定时更新内容,具体以插件的 config.yml 为准
# 配置文件版本
# 不要修改这个值
version: 7
# 服务器最多存在多少个假人
# 默认: 1000
server-limit: 1000
# 每个玩家最多创建多少个假人
# 默认: 1
player-limit: 1
# 假人名称模版
# 如果为空, 则跟随创建者的名字并且加上后缀
# 如果为其他值, 则使用该模版并且加上后缀
# 注意:
# 1. 如果包含除 英文字母、数字、下划线以外的字符,原生自带命令将不被支持
# 2. 长度超过 16 位将会被截取
name-template: ''
# 跟随下线
# 假人创建者玩家下线时是否自动下线
# 如果玩家只是切换服务器, 那么不会触发跟随下线
follow-quiting: true
# 是否检测 IP
# 如果启用, 则一个 IP 只能创建 `maximum` 个假人
# 能够避免玩家开小号疯狂创建假人
detect-ip: false
# 服务器最近 5 分钟平均 TPS 低于这个值清除所有假人
# 每 60 秒检测一次
# 默认: 0, 即不开启, 因为移除假人可能导致玩家红石机器出问题, 按需开启吧
kale-tps: 0
# 是否模拟登陆
# 真实的玩家登陆流程是 "预登陆" -> "登陆" -> "加入游戏", 而假人插件默认情况下跳过了这三个步骤直接生成实体, 如果设置为 true 将会模拟这三个步骤
# 因此有一些需要在 "登陆" 时生成玩家档案的插件发生异常比如 LuckPerms, 如果服务器没有出现严重的错误不需要理会这些异常, 只是这些插件无法对假人进行操作而已
# 开启也不一定能解决所有问题, 甚至可能衍生出更加奇怪的报错并且会让第三方插件生成大量的假人数据, 或者由于和一些 "新加入玩家限制行动之类的插件" 起冲突而导致假人飞走
simulate-login: false
# 预准备命令
# 假人诞生时会以控制台的身份按顺序执行以下命令
# 你可以用这个来实现权限组的分配之类的命令
# 非正版服请避免写一些危险指令以防第三方插件没有清档被其他玩家以假人的身份登陆而利用
# 占位符:
# %p: 假人名称
# %u: 假人 uuid
# %c: 创建者的名称
preparing-commands:
- '/give %p poppy'
- ''
# 假人销毁时执行的命令
# 与 `preparing-commands` 类似, 会在假人销毁时依次执行的命令
# 也许可以用来销毁第三方插件的档案?
# 占位符:
# %p: 假人名称
# %u: 假人 uuid
# %c: 创建者的名称
destroy-commands:
- ''
- ''