Extractioncraft 命令和权限

Extractioncraft 注册的根命令：

/extractioncraft
/exc

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

管理员命令

命令	权限	默认	执行者	描述
/exc initialize	extractioncraft.initialize	op	玩家	打开首次设置菜单
/exc setup	extractioncraft.setup	op	玩家	打开内容包浏览器，用于安装、卸载和管理内容
/exc protection bypass	extractioncraft.protection.bypass	op	玩家	切换对读取此状态的方块和交互检查的绕过。不会绕过对局传送限制或 PvP 禁令。
/exc reload	extractioncraft.*	op	任意	重新加载插件。进行中的对局会结束，其中的玩家保留各自的物品。如果重载未完全应用，建议完全重启服务器。

玩家命令

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

MagmaCore 共享命令

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

命令	权限	默认	执行者	描述
/exc recommendedplugins	extractioncraft.setup	op	任意	为玩家打开（或为控制台打印）推荐与 Extractioncraft 搭配使用的配套插件列表。
/nightbreak plugins	nightbreak.plugins	op	任意	打开 Nightbreak 插件目录，浏览并下载 MagmaGuy 的其他插件。由 MagmaCore 在全局范围内注册一次。
/nightbreaklogin <token>	nightbreak.login	op	任意	在游戏内注册你的 nightbreak.io 账户令牌，使服务器能够获取授权内容。由 MagmaCore 在全局范围内注册一次。
/nightbreaklogout	nightbreak.login	op	任意	从服务器中清除已存储的 nightbreak.io 账户令牌。由 MagmaCore 在全局范围内注册一次。
/logify	logify.*	op	任意	将当前的 latest.log 发布到 mclo.gs，方便管理员报告 Bug。由 MagmaCore 在全局范围内注册一次。
/extractioncraftchangelog	op、extractioncraft.*、extractioncraft.setup 或 extractioncraft.initialize	op	玩家	显示来自 Nightbreak 的未读 Extractioncraft 版本说明。dismiss 将其标记为已读，disable 停止加入时的提醒。在 Extractioncraft 完成启动后注册。参见更新日志通知。

权限汇总

权限	默认	描述
extractioncraft.initialize	op	访问 /exc initialize
extractioncraft.setup	op	访问 /exc setup 和 /exc recommendedplugins
extractioncraft.protection.bypass	op	访问 /exc protection bypass
extractioncraft.match.bypass	op	允许管理人员传送进对局世界，并在对局倒计时或进行期间留在其中，而不会被拒绝或送到主世界出生点。它不会让持有者成为对局参与者。
extractioncraft.*	op	访问 /exc reload
extractioncraft.creatematch	true	访问 /exc createMatch
extractioncraft.start	true	访问 /exc start
extractioncraft.leave	true	在 plugin.yml 中为 /exc leave 声明，但运行时未强制检查（已注册的 quit/leave 命令没有权限验证）
nightbreak.plugins	op	访问 /nightbreak plugins（由 MagmaCore 注册）
nightbreak.login	op	访问 /nightbreaklogin 和 /nightbreaklogout（由 MagmaCore 注册）
logify.*	op	访问 /logify（由 MagmaCore 注册）

注意事项

• plugin.yml 声明了根命令 /extractioncraft 和 /logify。/extractioncraft 的子命令在运行时通过 MagmaCore 命令管理器注册。
• extractioncraft.* 被 /exc reload 使用，但并未在 plugin.yml 中声明，因此它不是一个已注册的权限节点。管理员（op）会自动通过；其他任何人都需要由权限插件显式授予。
• quit 和 leave 是同一命令的两个别名，该命令没有权限检查。extractioncraft.leave 节点从不会被强制检查。
• /logify、/nightbreak、/nightbreaklogin 和 /nightbreaklogout 由 MagmaCore（已内置于插件中）在全局范围内注册，在服务器上所有 MagmaCore 插件之间各自只注册一次。如果另一个 MagmaGuy 插件已经占用了其中某个名称，Extractioncraft 会跳过注册并沿用已有的那个。
• 不带参数运行 /exc 会列出该执行者的权限和类型所允许的已注册子命令。quit/leave 的处理器没有设置用法字符串，因此其帮助条目不完整。
• 注册时未指定权限节点的子命令（目前只有 quit/leave）对任何发送者都会通过权限检查。
• 除 /exc reload 和 /exc recommendedplugins 外，Extractioncraft 的所有子命令都仅限玩家使用。控制台会收到 This command must be run as a player!。
• /exc createMatch 会拒绝已在对局中或正在等待对局生成的玩家，包括其他使用内置 MagmaCore 对局系统的插件的对局。
• Extractioncraft 没有注册共享的 downloadall 子命令，因此 /exc setup 中的信息按钮不会建议使用它。请直接使用设置菜单本身来管理内容。
• Extractioncraft 也没有注册共享的 downloadpluginupdate 或 applypluginupdate 子命令，插件更新自动下载后的提示也不会建议使用 applypluginupdate。请重启服务器以使用更新，或在下载之前于 config.yml 中设置 nightbreak.applyPluginUpdatesWithoutRestart。