Команды и разрешения 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	Игрок	Создаёт новый матч с использованием указанного пакета контента и помещает игрока в него. Автодополнение доступных имён файлов пакетов контента.
/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, чтобы упростить отправку отчётов об ошибках для администраторов. Регистрируется глобально один раз через MagmaCore.
/extractioncraftchangelog	op, extractioncraft.*, extractioncraft.setup или extractioncraft.initialize	op	Игрок	Показывает непрочитанные заметки о выпусках Extractioncraft из Nightbreak. 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, поэтому это не зарегистрированный узел разрешений. Операторы проходят проверку автоматически; всем остальным его нужно выдать явно через плагин прав.
• quit и leave — два алиаса одной и той же команды, у которой нет проверки разрешений. Узел extractioncraft.leave никогда не проверяется.
• /logify, /nightbreak, /nightbreaklogin и /nightbreaklogout регистрируются глобально через MagmaCore (входящий в комплект плагина), каждая только один раз среди всех плагинов MagmaCore на сервере. Если другой плагин MagmaGuy уже занял одно из этих имён, Extractioncraft пропускает его регистрацию и используется уже существующая команда.
• /exc без аргументов выводит зарегистрированные подкоманды, доступные с учётом разрешений и типа отправителя. У обработчика quit/leave нет строки использования, поэтому его запись в справке неполная.
• Подкоманда, зарегистрированная без узла разрешений (сейчас только quit/leave), проходит проверку разрешений для любого отправителя.
• Все подкоманды Extractioncraft, кроме /exc reload и /exc recommendedplugins, доступны только игрокам. Консоль получает This command must be run as a player!.
• /exc createMatch отказывает игроку, который уже находится в матче или ждёт генерации матча, включая матч другого плагина, использующего встроенную систему матчей MagmaCore.
• Extractioncraft не регистрирует общую подкоманду downloadall, поэтому информационная кнопка внутри /exc setup её не предлагает. Используйте само меню настройки для управления контентом.
• Extractioncraft не регистрирует и общие подкоманды downloadpluginupdate и applypluginupdate, а уведомление после автоматической загрузки обновления плагина не предлагает applypluginupdate. Чтобы применить обновление, перезапустите сервер или задайте nightbreak.applyPluginUpdatesWithoutRestart в config.yml до загрузки.