MegaBlock Survivors 指令
MegaBlock Survivors 注册了一个单一的根指令：
/mbs
/megablocksurvivors
在安装过程中使用的 Nightbreak 令牌指令是独立的，由 MagmaCore 提供：
/nightbreaklogin <token>
安装与内容管理
| 指令 | 发送者 | 权限 | 当前用途 |
|---|---|---|---|
/mbs | 任意 | megablocksurvivors.*（声明，但在无参数路径上不强制） | 打印快速入门帮助（start、setup、reload） |
/mbs setup | 玩家 | megablocksurvivors.setup | 打开 Nightbreak 内容浏览菜单（Free / Premium / Resources 筛选） |
/mbs recommendedplugins | 任意 | megablocksurvivors.setup | 显示推荐的配套插件目录（对玩家打开菜单，对控制台打印列表） |
/mbs downloadpluginupdate | 任意 | megablocksurvivors.* | 从 Nightbreak 下载最新的 MegaBlock Survivors 插件 jar（需要已关联账号） |
/mbs downloadall | 任意 | megablocksurvivors.* | 下载插件更新。（MBS 默认 hasContentPackages=false，因此该指令不会拉取内容包——在这里它实际上是插件更新的别名。） |
/mbs reload | 任意 | megablocksurvivors.* | 重载 MegaBlock Survivors 内容，并在存在 FreeMinecraftModels 时刷新其导入 |
/mbs version | 任意 | 无 | 显示当前插件版本 |
setup、recommendedplugins、downloadpluginupdate 和 downloadall 由 MagmaCore 的 NightbreakPluginBootstrap.registerStandardCommands（被着色合并进插件）注册，而非由 MegaBlock Survivors 自己的指令类注册。
玩法指令
| 指令 | 发送者 | 当前用途 |
|---|---|---|
/mbs start | 玩家 | 开始一场新的对局。如果你已经在对局中，或对局仍在准备中，指令会被拒绝。 |
/mbs quit | 玩家 | 结束当前对局并将你送回出生点 |
/mbs stats | 玩家 | 打开当前对局的装备与属性面板 |
/mbs summary | 玩家 | 在聊天栏打印当前或最近一场对局的总结（时长、最高波次、伤害明细、装备、击杀数） |
/mbs dump | 玩家 | 清空 stats-dump.log，并将调用者的当前或最近一场对局总结写入为一行 JSON |
/mbs sacrifice | 玩家 | 触发最近的鲜血祭坛当前阶段（25% / 50% / 75% HP） |
/mbs meta | 玩家 | 打开元进度（灵魂回响圣坛）商店对话框 |
/mbs meta upgrade <track> | 玩家 | 为指定的元进度路线购买一级。可用路线：hp、luck、speed、weaponslots、passiveslots、extralives、bantokens、rerolltokens。 |
内部指令
以下指令由游戏内对话框按钮自动触发，不建议手动执行：
| 指令 | 发送者 | 当前用途 |
|---|---|---|
/mbs selectgamemode <challenge|endless> | 玩家 | 在第一个赛前界面选择游戏模式 |
/mbs selectdifficulty <easy|medium|hard> | 玩家 | 在第二个赛前界面选择难度 |
/mbs selectweapon <weaponType> | 玩家 | 在职业选择界面选择初始武器 |
/mbs reward <number> | 玩家 | 在升级奖励界面选择一个奖励 |
/mbs reward-ban <type> | 玩家 | 将某一类装备从本场剩余奖励池中禁掉（消耗一枚禁用代币） |
/mbs reward-reroll | 玩家 | 重新摇取当前奖励选项（消耗一枚重摇代币） |
/mbs hourglass-reward <number> | 玩家 | 在沙漏奖励界面选择一个奖励 |
/mbs chest-reward <number> | 玩家 | 在宝箱奖励界面选择一个奖励 |
/mbs resume | 玩家 | 在奖励选择后恢复游戏 |
调试与管理员指令
| 指令 | 发送者 | 当前用途 |
|---|---|---|
/mbs cheat | 玩家 | 杀掉所有敌人并即时满足传送门献祭要求 |
/mbs beam | 玩家 | 为 20 格范围内的所有 Target 方块绘制 10 秒的调试光束 |
/mbs skipworld | 玩家 | 跳到当前对局的下一个世界 |
说明
- MegaBlock Survivors 的
plugin.yml仅声明了/mbs根指令以及/megablocksurvivors别名。所有子指令都是在运行时通过 MagmaCore 的CommandManager注册的。 - 未显式设置权限的指令没有权限要求。
/mbs setup与/mbs recommendedplugins由megablocksurvivors.setup控制；/mbs reload、/mbs downloadpluginupdate和/mbs downloadall由megablocksurvivors.*控制。两个权限都在插件的NightbreakPluginSpec中声明，因此运维方可以将「仅安装」角色与完整管理员角色分别授予。- 插件的
NightbreakPluginSpec配置为hasContentPackages=false和hasPresetModes=false。因此，MagmaCore 不会注册/mbs initialize（受hasPresetModes控制）以及各内容包的下载/更新指令（受hasContentPackages控制）。/mbs downloadpluginupdate和/mbs downloadall始终会被注册，但由于内容包被禁用，downloadall只会拉取插件 jar。MegaBlock Survivors 的内容由它自己的MBSPackage系统提供，并通过/mbs setup管理。（某些遗留的聊天字符串仍可能提到本构建上已不存在的initialize/updatecontent流程；请忽略它们。） - 所有面向用户的文本（聊天消息、指令描述、对话框标题）都从
plugins/MegaBlockSurvivors/translations.yml加载，因此无需修改 jar 即可重新本地化指令描述。