跳转到主要内容

命令与权限

Geyser 内置了许多可供玩家或服务器管理员使用的命令。

信息

使用 BungeeCord 和 Velocity 时,你需要在代理服务器上使用诸如 LuckPerms 之类的权限插件 为玩家分配权限。在后端服务器上分配权限将无效。

Geyser 命令及其权限

命令权限描述
geyser
Geyser 根命令
geyser.command查看/执行任何 Geyser 命令所需的基础权限。
geyser help
geyser ?
geyser.command.help显示所有已注册命令的帮助信息。
geyser advancementsgeyser.command.advancements打开 Java 版的进度菜单。
geyser dumpgeyser.command.dump导出 Geyser 调试信息(用于提交漏洞报告)。
geyser listgeyser.command.list列出所有通过 Geyser 连接的玩家。
geyser offhandgeyser.command.offhand将物品放入副手栏。
geyser reloadgeyser.command.reload重新加载 Geyser 配置文件。使用此命令会踢出所有在线玩家!
geyser settingsgeyser.command.settings打开设置菜单,可修改世界相关的各项设置。
geyser shutdown
geyser stop
geyser.command.shutdown关闭 Geyser。
此命令仅在独立版(Standalone)中生效。
geyser statisticsgeyser.command.statistics打开 Java 版的统计信息菜单。
geyser versiongeyser.command.version显示当前 Geyser 版本并检查更新。
geyser tooltipsgeyser.command.tooltips切换是否显示高级提示信息(Java 版按 F3 + H)
geyser extensionsgeyser.command.extensions列出所有当前已加载的扩展。仅当有扩展被加载时,此命令才会被注册。
geyser pinggeyser.command.ping显示玩家与 Geyser 实例之间的延迟(Ping 值)。
geyser optionsgeyser.command.options若由 Java 版服务器触发,则打开“暂停界面扩展项”对话框。
geyser quickactionsgeyser.command.quickactions若由 Java 版服务器触发,则打开“快速操作”对话框。

Geyser 扩展的权限

以下内容中,<id> 指代扩展的唯一标识(ID)。

命令权限描述
<id> help
<id> ?
geyser.command.exthelp.<id>显示此扩展所注册的所有命令的帮助信息。

其他权限

除命令外,还有一些其他权限用于管控 Geyser 的特定功能。

权限描述
geyser.settings.server允许玩家使用游戏设置菜单。(同时要求玩家拥有管理员(OP)权限。)
geyser.settings.gamerules定义用户是否可在游戏设置菜单中修改游戏规则(Gamerule)。(同时要求玩家拥有管理员(OP)权限。)
geyser.update该玩家加入服务器时是否会收到 Geyser 的更新通知。

使用 Geyser-Standalone/Geyser-ViaProxy 时的权限

Geyser-ViaProxy 和 Geyser-Standalone 内置了基础的权限处理机制。若要编辑基础权限, 请打开 permissions.yml 文件,添加或移除 Geyser 玩家加入时应获得的权限。 更多信息请参考该文件内的说明。

你还可以通过创建Geyser 扩展并调用 Geyser 的 API 来处理权限校验,从而进一步自定义权限管理逻辑。

在无内置权限处理机制的平台上使用 Geyser 时的权限

以下内容适用于 Geyser-BungeeCord、Geyser-Velocity 和 Geyser-Fabric 版本。 遗憾的是,这些平台没有内置的权限处理机制。因此,你需要在这些平台上通过权限插件(如 LuckPerms) 手动为玩家授予权限。Geyser 核心权限已在上文列出,扩展的权限请参考对应扩展的文档。

你也可以使用第三方 Geyser 扩展 LuckLink,通过 LuckPerms 自动注册权限:

  • 在安装了 Geyser 的平台(BungeeCord/Velocity/Fabric)上安装 LuckPerms
  • 若要让 Geyser 自动注册权限默认值,请下载 LuckLink.jar 并将其放入 Geyser 的 extensions 文件夹,以此安装 LuckLink 扩展。
  • 重启服务器后,权限应会被自动注册。

Floodgate 命令与权限

关于 Floodgate 的命令,请参考此链接