Sunplayer

插件

· 作者 Coaels

一个假玩家插件,类似 Carpet 但更强大。支持 NPC 模式,你可以让点击假玩家来运行命令!

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

最新 0.12.8 · 1.21.11 · Folia / Paper

一键开服(送7天)

SunPlayer

假人玩家插件,支持 Paper / Folia 1.21.11

这个插件能在服务器里凭空生成一个“玩家”。它会挂机、保持区块加载、会被水冲走、被活塞推动、被打、也会掉东西,行为跟真玩家没什么区别。也可以把它摆成 NPC:玩家点一下,就执行你设置好的命令。

现在还有 pvp 机器人模式。

一个 jar 包,Paper 和 Folia 都能直接跑,没有前置插件。


特性

  • 行为接近真玩家:会被水冲走、被活塞推、能触发事件、能进计分板、能被 /ban
  • 挂机不掉线:假人所在区块一直保持加载,种田、炼药、刷怪机不会停
  • 动作齐全:左键、右键、挥手、丢弃、跳跃、移动、转向、潜行、疾跑、换手、骑乘
  • 点击式 NPC:摆一个假人,玩家点它就触发你指定的命令
  • 正版皮肤:自动使用该名字对应的正版皮肤,取不到就用 Steve
  • 不占用同名真人的名额:假人在服务端使用独立名字,与同名真人完全隔离
  • 挂机限时:可以限制每个假人的最长在线时间,到期自动删除
  • 持久化:重启后自动恢复,不用重新召唤
  • pvp 机器人模式:命令创建 4 个等级的 pvp 机器人,可以和你对打

安装

  1. 服务器需要 Paper 或 Folia 1.21.11,以及 Java 21
  2. 把 SunPlayer.jar 放进 plugins/ 文件夹
  3. 重启服务器

快速开始

在游戏里执行:

/sunplayer Steve

一个叫 Steve 的假人就会出现在你脚下,游戏模式跟你当前的一样。


命令

命令 说明
/sunplayer <名字> 在你站的位置生成假人
/sunplayer <名字> <动作> 指挥假人做事
/sunplayer <名字> remove 让假人下线(重启后会自动回来)
/sunplayer <名字> kill 彻底删除假人(连存档一起)
/sunplayer <名字> renew 重置挂机计时
/sunplayer list 查看所有在线假人与 NPC
/sunplayer reload 重载配置文件
/sunplayer revive 恢复没有成功上线的假人
/pvpbot [<等级(1~4)> | kill] 创建 pvp 机器人(会继承你的装备);kill 杀死所有 pvp 机器人

命令里只写名字本身就行,不用管前缀。


动作

动作 写法
右键 / 使用 use [once|continuous|interval <秒>]
左键 / 攻击 attack [once|continuous|interval <秒>]
挥手 swing [once|continuous|interval <秒>]
丢弃物品 drop [once|continuous|interval <秒>] [mainhand|offhand|<0-40>]
丢整组 dropstack
跳跃 jump
移动 move <forward|backward|left|right>
视角 look <yaw> <pitch>
转身 turn <left|right|back>
潜行 / 站起 sneak / unsneak
疾跑 / 停止疾跑 sprint / unsprint
停止所有动作 stop
切换快捷栏 hotbar <0-8>
交换主副手 swaphands
骑乘 / 下坐骑 mount / dismount
设置皮肤 skin <player_name>
示例:
/sunplayer Steve
/sunplayer Steve attack continuous
/sunplayer Steve move forward
/sunplayer Steve stop

NPC 模式

把假人摆成 NPC,玩家点击时执行命令:

/sunplayer <名字> --npcmode --command <命令> [参数...]
参数 说明 默认
--npcmode 开启 NPC 模式(必需) —
--command <命令,命令> 点击时执行的命令,逗号分隔 无
--left / --right / --both 哪种点击触发 --both
--look 始终面向最近的玩家 关
--look-range <格> 面向距离 8
--cooldown <tick> 同一玩家的点击冷却 10
--as-console 用控制台权限执行命令 关
--delay 更精确的冷却控制,单位 ms /

示例:

/sunplayer Merchant --npcmode --command tell @s 欢迎光临,title @s title {"text":"商店"} --look
/sunplayer Guard --npcmode --left --command effect give @s minecraft:slowness 5 1

命令里的 @s 指向点击者本人,坐标和朝向也是他的。

NPC 不会移动、不会受伤、不占玩家位。参数在创建后无法修改,要改就先 kill 再重建。


挂机限时

在 config.yml 里限制假人的最长挂机时间:

auto-remove:
  minutes: 120        # 最多挂 2 小时,0 = 关闭
  warn-minutes: 1     # 删除前 1 分钟提醒主人
  • 每个假人独立计时,重启后继续计时
  • 快到期时会私聊创建者,并附带可点击的 renew 续时链接
  • 到期后假人被彻底删除,重启也不会复活
  • NPC 不受这个限制

权限

权限 默认 作用
sunplayer.use 所有人 生成假人、发送动作、remove、kill、renew、list
sunplayer.npc 仅 OP 使用 NPC 模式及全部 NPC 参数
sunplayer.admin 仅 OP 以上全部,并可给别人的假人续时、重载配置

配置

max-fake-players: 20   # 全服假人上限
view-distance: 2       # 假人视距(区块)

naming:
  fake-prefix: "Bot_"  # 假人服务端名字前缀

auto-remove:
  minutes: 0           # 假人最多挂几分钟,0 = 关闭
  warn-minutes: 1      # 删除前几分钟提醒主人

compat:
  prevent-plugin-kicks: true   # 防止其他插件误踢假人
  authme-force-login: true     # 安装 AuthMe 时自动免登录
  remove-on-death: true        # 假人被打死后自动删除

改完配置执行 /sunplayer reload 即可生效,在线假人不受影响。


实用小贴士

  • 假人占玩家位,NPC 不占。max-fake-players 建议按「服务器总人数 − 预期真人数」来设
  • view-distance 建议设为 2,能明显降低内存占用
  • 关闭正版验证(online-mode=false)的服务器也能正常使用
  • 假人不加载玩家背包与成就数据,每次生成都是干净的新玩家

常见问题

重启后假人没回来? 先执行 /sunplayer list,底部会列出没有恢复的假人名字,再执行 /sunplayer revive 重试。

假人会跟同名真人冲突吗? 不会。假人在服务端有独立名字,与同名真人完全隔离。

命令 说明
/sunplayer <name> 在你所在的位置生成一个假人玩家
/sunplayer <name> <action> 指挥假人玩家执行某项操作
/sunplayer <name> remove 使假人玩家离线(重启后会恢复)
/sunplayer <name> kill 永久删除假人玩家(包括其存档数据)
/sunplayer <name> renew 重置闲置计时器
/sunplayer list 列出所有在线的假人玩家和 NPC
/sunplayer reload 重新加载配置文件
/sunplayer revive 恢复那些未能成功上线的假人玩家
/pvpbot [<tier(1~4)> | kill] 创建一个 PvP 机器人(继承你的装备);kill 移除所有 PvP 机器人

在命令中只需输入纯名称,无需担心前缀。


动作

动作 语法
右键点击 / 使用 use [once|continuous|interval <seconds>]
左键点击 / 攻击 attack [once|continuous|interval <seconds>]
挥动手臂 swing [once|continuous|interval <seconds>]
丢弃物品 drop [once|continuous|interval <seconds>] [mainhand|offhand|<0-40>]
丢弃一组物品 dropstack
跳跃 jump
移动 move <forward|backward|left|right>
看向 look <yaw> <pitch>
转身 turn <left|right|back>
潜行 / 站起 sneak / unsneak
疾跑 / 停止疾跑 sprint / unsprint
停止所有动作 stop
切换快捷栏槽位 hotbar <0-8>
交换主手/副手 swaphands
骑乘 / 下马 mount / dismount
设置皮肤 skin <player_name>

示例:

/sunplayer Steve
/sunplayer Steve attack continuous
/sunplayer Steve move forward
/sunplayer Steve stop

NPC 模式

将假人玩家转换为 NPC,在被点击时运行命令:

/sunplayer <name> --npcmode --command <command> [arguments...]
参数 说明 默认值
--npcmode 启用 NPC 模式(必需) —
--command <cmd,cmd> 点击时运行的命令,用逗号分隔 无
--left / --right / --both 哪种点击触发该行为 --both
--look 始终面向最近的玩家 关闭
--look-range <blocks> 面向距离 8
--cooldown <ticks> 每个玩家的点击冷却时间 10
--as-console 以控制台权限运行命令 关闭
--delay 更精细的冷却控制,单位为毫秒 /

示例:

/sunplayer Merchant --npcmode --command tell @s Welcome,title @s title {"text":"Shop"} --look
/sunplayer Guard --npcmode --left --command effect give @s minecraft:slowness 5 1

命令中的 @s 指的是点击的玩家,坐标和方向也属于该玩家。

NPC 不会移动、不会受到伤害,也不占用玩家槽位。创建后无法编辑参数;如需更改,请执行 kill 并重新创建。


AFK 时间限制

在 config.yml 中设定假人玩家的最大闲置时间:

auto-remove:
  minutes: 120        # 最大 2 小时闲置,0 = 禁用
  warn-minutes: 1     # 在移除前 1 分钟警告所有者
  • 每个假人玩家单独计时,重启后计时继续
  • 当接近过期时,所有者会收到一条包含可点击 renew 链接的私聊消息
  • 一旦过期,假人玩家将被永久删除,重启后也不会恢复
  • NPC 不受此限制影响

权限

权限 默认值 用途
sunplayer.use 所有人 生成假人玩家、发送动作、remove、kill、renew、list
sunplayer.npc OP 专属 使用 NPC 模式及所有 NPC 参数
sunplayer.admin OP 专属 上述所有功能,以及恢复他人的假人玩家和重载配置

配置

max-fake-players: 20   # 全局假人玩家上限
view-distance: 2       # 假人玩家视距(区块)

naming:
  fake-prefix: "Bot_"  # 假人玩家服务端名称前缀

auto-remove:
  minutes: 0           # 每个假人玩家的最大闲置分钟数,0 = 禁用
  warn-minutes: 1      # 在移除前多少分钟警告所有者

compat:
  prevent-plugin-kicks: true   # 防止其他插件误踢假人玩家
  authme-force-login: true     # 安装 AuthMe 时自动绕过登录
  remove-on-death: true        # 被击杀时自动删除假人玩家

编辑配置后运行 /sunplayer reload;在线假人玩家不受影响。


提示

  • 假人玩家占用玩家槽位,而 NPC 不占用。将 max-fake-players 设置为约等于“服务器总槽位 − 预期真实玩家数量”
  • 将 view-distance 设置为 2 可显著降低内存占用
  • 即使禁用了在线模式(online-mode=false),服务器也能正常工作
  • 假人玩家不会加载玩家背包或进度数据,因此每次生成都是全新的干净玩家

常见问题

假人玩家在重启后没有恢复? 运行 /sunplayer list;未恢复的假人玩家名称列在底部。然后运行 /sunplayer revive 重试。

假人玩家会与同名真实玩家冲突吗? 不会。假人玩家拥有独立的服务端名称,并与同名真实玩家完全隔离。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源