跳到主要内容

Extractioncraft 命令和权限

Extractioncraft 注册的根命令：

/extractioncraft
/exc

子命令通过 MagmaCore 命令管理器在运行时注册。

管理员命令​

命令权限默认执行者描述
/exc initializeextractioncraft.initializeop玩家打开首次设置菜单
/exc setupextractioncraft.setupop玩家打开内容包浏览器，用于安装、卸载和管理内容
/exc protection bypassextractioncraft.protection.bypassop玩家切换绕过比赛实例保护（例如传送限制、方块保护）
/exc reloadextractioncraft.*op任意重新加载插件。如果重载未完全应用，建议完全重启服务器。

玩家命令​

命令权限默认执行者描述
/exc createMatch <contentPackage.yml>extractioncraft.creatematchtrue玩家使用指定的内容包创建新比赛并将玩家放入其中。支持 Tab 补全可用的内容包文件名。
/exc startextractioncraft.starttrue玩家如果满足最低玩家数量要求，则开始玩家当前所在的比赛
/exc leave（未设置）true玩家离开当前比赛。
/exc quit（未设置）true玩家离开当前比赛。与 /exc leave 相同。

MagmaCore 共享命令​

MagmaCore 已内置于 Extractioncraft 中，因此这些命令也随插件一同提供。

命令权限默认执行者描述
/exc recommendedpluginsextractioncraft.setupop任意为玩家打开（或为控制台打印）推荐与 Extractioncraft 搭配使用的配套插件列表。
/nightbreak pluginsnightbreak.pluginsop任意打开 Nightbreak 插件目录，浏览并下载 MagmaGuy 的其他插件。由 MagmaCore 在全局范围内注册一次。
/nightbreaklogin <token>nightbreak.loginop任意在游戏内注册你的 nightbreak.io 账户令牌，使服务器能够获取授权内容。由 MagmaCore 在全局范围内注册一次。
/nightbreaklogoutnightbreak.loginop任意从服务器中清除已存储的 nightbreak.io 账户令牌。由 MagmaCore 在全局范围内注册一次。
/logifylogify.*op任意将当前的 latest.log 发布到 mclo.gs，方便管理员报告 Bug。由 MagmaCore 在全局范围内注册一次。

权限汇总​

权限默认描述
extractioncraft.initializeop访问 /exc initialize
extractioncraft.setupop访问 /exc setup 和 /exc recommendedplugins
extractioncraft.protection.bypassop访问 /exc protection bypass
extractioncraft.*op访问 /exc reload
extractioncraft.creatematchtrue访问 /exc createMatch
extractioncraft.starttrue访问 /exc start
extractioncraft.leavetrue在 plugin.yml 中为 /exc leave 声明，但运行时未强制检查（已注册的 quit/leave 命令没有权限验证）
nightbreak.pluginsop访问 /nightbreak plugins（由 MagmaCore 注册）
nightbreak.loginop访问 /nightbreaklogin 和 /nightbreaklogout（由 MagmaCore 注册）
logify.*op访问 /logify（由 MagmaCore 注册）

注意事项​

  • plugin.yml 声明了根命令 /extractioncraft 和 /logify。/extractioncraft 的子命令在运行时通过 MagmaCore 命令管理器注册。
  • extractioncraft.* 被 /exc reload 使用，但并未在 plugin.yml 中声明，因此它不是一个已注册的权限节点。管理员（op）会自动通过；其他任何人都需要由权限插件显式授予。
  • quit 和 leave 子命令都会将玩家从当前对局中移除。它们都通过 QuitMatchCommand（没有权限验证）注册。注意：源码中存在一个独立的 ExitMatchCommand 类（别名 exit/leave，权限 extractioncraft.leave），但它在启动时未被注册，因此 extractioncraft.leave 节点从不会被强制检查。
  • /logify、/nightbreak、/nightbreaklogin 和 /nightbreaklogout 由 MagmaCore（已内置于插件中）在全局范围内注册，在服务器上所有 MagmaCore 插件之间各自只注册一次。如果另一个 MagmaGuy 插件已经占用了其中某个名称，Extractioncraft 会跳过注册并沿用已有的那个。
  • 不带参数运行 /exc 会打印每个已注册子命令的用法提示行。
  • 注册时未指定权限节点的子命令（目前只有 quit/leave）对任何发送者都会通过权限检查。
  • /exc setup 中的信息按钮宣传了 /extractioncraft downloadall。该子命令并未被 Extractioncraft 注册，因此这条建议不会有任何效果 —— 请直接使用设置菜单本身来管理内容。