Команды 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 applypluginupdate	Любой	megablocksurvivors.*	Применяет без перезапуска обновление плагина, уже загруженное в папку обновлений сервера. MegaBlock Survivors перезагружается, из-за чего активные матчи завершаются. Команда отклоняется, если более нового действительного обновления в ожидании нет или если от MegaBlock Survivors зависит плагин другого автора
/mbs reload	Любой	megablocksurvivors.*	Полностью отключает, загружает и включает MegaBlock Survivors, завершает активные матчи и перечитывает настройки, переводы, контент, миры, NPC и дисплеи. Если импортируются модели и FreeMinecraftModels включён, общий импортёр также перезагружает контент FMM
/mbs version	Любой	Нет	Отображает текущую версию плагина

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

Заметки о выпусках

MagmaCore также регистрирует отдельную команду верхнего уровня для общего списка заметок о выпусках:

/mbschangelog
/mbschangelog dismiss
/mbschangelog disable

Она открывает непрочитанные заметки о выпусках MegaBlock Survivors, отмечает их прочитанными или отключает для вас напоминание при входе. Команда доступна только игрокам и требует OP или одно из разрешений megablocksurvivors.*, megablocksurvivors.setup или megablocksurvivors.initialize. См. Уведомления об изменениях Nightbreak.

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

Команда	Отправитель	Текущее назначение
/mbs start	Игрок	Начинает новый матч. Отклоняется, если вы уже в матче или ещё настраиваете его, а также если вы уже участвуете в матче другого плагина, использующего общую систему матчей MagmaCore.
/mbs quit	Игрок	Завершает ваш текущий матч или отменяет тот, который вы ещё настраиваете. Игрок, уже находящийся в матче, перемещается в лобби mbs_spawn или, если лобби не загружено, туда, где он выполнил /mbs start
/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.

Внутренние команды

Эти команды вызывают кнопки игровых диалогов. Используйте кнопки: не все обработчики проверяют ожидаемый экран или фазу матча. Ручной вызов Ban или Reroll может потратить жетон, даже если экран награды не открыт.

Команда	Отправитель	Текущее назначение
/mbs selectgamemode <challenge|endless>	Игрок	Выбирает режим игры на первом предматчевом экране
/mbs selectdifficulty <easy|medium|hard>	Игрок	Выбирает сложность на втором предматчевом экране
/mbs selectweapon <weaponType>	Игрок	Выбирает стартовое оружие на экране выбора класса
/mbs reward <number>	Игрок	Выбирает награду на экране наград за уровень
/mbs reward-ban <type>	Игрок	Тратит один жетон Ban и исключает тип снаряжения из следующих розыгрышей. Резервный выбор при исчерпанном пуле может вернуть запрещённые типы
/mbs reward-reroll	Игрок	Перебрасывает текущие варианты наград (расходует один жетон реролла)
/mbs hourglass-reward <number>	Игрок	Выбирает награду на экране награды песочных часов
/mbs chest-reward <number>	Игрок	Выбирает награду на экране награды сундука
/mbs resume	Игрок	Возобновляет игру после выбора награды
/mbs skip	Игрок	Отправляется кнопкой пропуска анимации выбора награды. Завершает анимацию и показывает итоговые варианты наград. Вне матча ничего не делает

Анимации выбора наград отключены, поэтому варианты наград появляются сразу, а /mbs skip сейчас не имеет эффекта. Разрешений он не требует.

Команды отладки и администрирования

Команда	Отправитель	Текущее назначение
/mbs cheat	Игрок	Удаляет всех отслеживаемых врагов без дропа и без засчитывания убийств, заполняет квоту жертвоприношения для портала и делает игрока невосприимчивым к урону матча до конца забега. Контактное убийство призрачной армии по таймеру всё равно действует
/mbs beam	Игрок	На 10 секунд рисует отладочные лучи к блокам Target в кубе, простирающемся от игрока на 20 блоков в обе стороны каждой оси
/mbs skipworld	Игрок	Пропускает текущий мир и переходит к следующему в матче

Эти три отладочные команды сейчас не требуют разрешений. /mbs cheat ставит отметку о читах, а /mbs skipworld только переводит в следующий мир и не ставит её. Фильтр таблицы рекордов не защищает от пропуска миров отладочной командой.

Разрешения

Разрешение	Где объявлено	Что даёт
megablocksurvivors.*	NightbreakPluginSpec	Админские команды: /mbs, /mbs reload, /mbs downloadpluginupdate, /mbs downloadall, /mbs applypluginupdate, а также напоминание о первоначальной настройке
megablocksurvivors.setup	NightbreakPluginSpec	/mbs setup и /mbs recommendedplugins
megablocksurvivors.initialize	NightbreakPluginSpec	Только /mbschangelog. Команда /mbs initialize не регистрируется
megablocksurvivors.match.bypass	plugin.yml (по умолчанию: op)	Телепортация в миры идущих матчей без отказа и без выброса обратно. Обладателей этого права всё равно перемещают наружу перед удалением миров завершённого матча

Примечания

• В plugin.yml MegaBlock Survivors объявлены корневая команда /mbs с алиасом /megablocksurvivors и разрешение megablocksurvivors.match.bypass. Все подкоманды регистрируются во время выполнения через CommandManager из MagmaCore.
• Команды без явно заданного разрешения не требуют никаких прав.
• /mbs setup и /mbs recommendedplugins ограничены разрешением megablocksurvivors.setup; /mbs reload, /mbs downloadpluginupdate, /mbs downloadall и /mbs applypluginupdate ограничены разрешением megablocksurvivors.*. Оба разрешения объявлены в NightbreakPluginSpec плагина, поэтому операторы могут выдавать роль только для настройки отдельно от полной роли администратора.
• MegaBlock Survivors использует упрощённую перегрузку bootstrap без /mbs initialize. При hasContentPackages=false команды скачивания/обновления отдельных пакетов тоже отсутствуют; /mbs downloadall скачивает только JAR плагина. Контентом управляйте через /mbs setup.
• Многие игровые тексты используют plugins/MegaBlockSurvivors/translations.yml. Часть описаний общих команд, сообщений меню контента и текста рейтинга остаётся заданной в коде на английском.