Команды 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.*	Скачивает последний jar плагина MegaBlock Survivors с Nightbreak (требуется привязанный аккаунт)
/mbs downloadall	Любой	megablocksurvivors.*	Скачивает обновление плагина. (MBS поставляется с hasContentPackages=false, поэтому эта команда не подтягивает пакеты контента — здесь это фактически алиас обновления плагина.)
/mbs reload	Любой	megablocksurvivors.*	Перезагружает контент MegaBlock Survivors и обновляет импорты FreeMinecraftModels, если он установлен
/mbs version	Любой	Нет	Отображает текущую версию плагина

setup, recommendedplugins, downloadpluginupdate и downloadall регистрируются методом NightbreakPluginBootstrap.registerStandardCommands из MagmaCore (вшитого в плагин), а не собственными классами команд MegaBlock Survivors.

Игровые команды

Команда	Отправитель	Текущее назначение
/mbs start	Игрок	Начинает новый матч. Отклоняется, если вы уже в матче или матч ещё готовится.
/mbs quit	Игрок	Завершает ваш текущий матч и возвращает вас на спавн
/mbs stats	Игрок	Открывает экран снаряжения и характеристик для текущего матча
/mbs summary	Игрок	Выводит в чат сводку вашего текущего или последнего матча (длительность, наивысшая волна, разбивка урона, снаряжение, убийства)
/mbs dump	Игрок	Очищает stats-dump.log и записывает сводку текущего или последнего матча вызывающего игрока в виде JSON-строки
/mbs sacrifice	Игрок	Запускает текущую стадию ближайшего Алтаря Крови (25% / 50% / 75% ХП)
/mbs meta	Игрок	Открывает диалог магазина мета-прогрессии (Святилище Soul Echo)
/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	Игрок	Рисует отладочные лучи ко всем блокам Target в радиусе 20 блоков на 10 секунд
/mbs skipworld	Игрок	Пропускает текущий мир и переходит к следующему в матче

Примечания

• В plugin.yml MegaBlock Survivors объявлена только корневая команда /mbs с алиасом /megablocksurvivors. Все подкоманды регистрируются во время выполнения через CommandManager из MagmaCore.
• Команды без явно заданного разрешения не требуют никаких прав.
• /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.