GeyserCommandsYML

插件

· 作者 xHue

设置自定义命令建议列表,以便在 Geyser(基岩版)客户端中显示

0 本站下载 0 关注 更新于 1 年前

需要前置:间歇泉

最新 1.1-SNAPSHOT · 1.21.5 · Paper / Spigot

一键开服(送7天)

GeyserCommandsYML

GeyserCommandsYML 是一款轻量级插件,专为使用 Geyser-Spigot 的服务器设计,旨在更好地控制向基岩版(Bedrock Edition)玩家显示的建议命令列表。

与其通过 Geyser-Spigot 配置(即 Geyser-Spigot\config.yml → command-suggestions: false)完全禁用所有服务器命令建议,此插件直接挂钩到 Geyser 和 Floodgate API,允许你为仅限基岩版玩家定义自己的自定义命令列表——从而避免崩溃、冗余或暴露无关命令。


功能

  • ✅ 添加可自定义的可见命令列表,专供基岩版玩家使用。
  • ✅ 无需全局禁用 Geyser 的命令建议功能。
  • ✅ 简单的 YAML 配置文件(plugins/GeyserCommandsYML/commands.yml)。
  • ✅ 支持外部配置编辑的热重载(附带受控的玩家踢出机制)。
  • ✅ 极其轻量——仅拦截 PlayerCommandSendEvent 并针对基岩版客户端进行修改。

命令

命令 描述 权限
/geysercommands add <command> 将命令添加到基岩版命令列表中。 geysercommands.add
/geysercommands remove <command> 从基岩版命令列表中移除命令。 geysercommands.remove
/geysercommands list 在聊天栏中列出当前注册的所有基岩版命令。 geysercommands.list
/geysercommands reload 重新加载插件配置并更新基岩版命令列表(强制基岩版玩家重新连接)。 geysercommands.reload

别名:
/geysercommandsyml, /gcyml


工作原理

  • 当触发 PlayerCommandSendEvent 时,插件会:

    • 检查玩家是否为基岩版客户端(通过 Geyser/Floodgate API)。
    • 如果是,它会清除默认的命令建议列表。
    • 然后只添加插件 YAML 文件中定义的命令。
  • Geyser 客户端仅在玩家加入时拉取可用命令,而非动态获取——
    因此,在执行 /geysercommands reload 后,基岩版玩家需要重新加入游戏才能看到更新后的列表。
    (该命令会自动以友好的提示消息踢出基岩版玩家,要求他们重新连接。)

  • 重要提示:

    • 在 Geyser-Spigot\config.yml 中,确保设置 command-suggestions: true。
    • /geysercommands add <command> 和 /geysercommands remove <command> 命令不会踢出玩家。
      • 但请注意,在线的基岩版玩家直到手动离开并重新加入前,将无法看到更新的命令列表。

权限概览

权限 用途
geysercommands.add 允许向基岩版命令列表中添加命令。
geysercommands.remove 允许从基岩版命令列表中移除命令。
geysercommands.list 允许查看当前的基岩版命令列表。
geysercommands.reload 允许重新加载插件配置并强制基岩版玩家重新连接。
  • 如果玩家缺乏所需权限,他们将无法访问子命令。
  • 服务器操作员(Server Operators)默认拥有命令访问权限。

测试环境

  • ✅ PaperMC 1.21.4 - Build #226: 兼容
  • ✅ Geyser-Spigot - Build #816: 兼容
  • ✅ Floodgate - Build #116: 兼容

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源