Команды и права CannonRTP

CannonRTP регистрирует свои команды в пространстве имён cannonrtp.

• Корневая команда: /cannonrtp
• Алиасы: /crtp, /wc

/wc — короткий алиас, который будут использовать большинство администраторов, но для каждой подкоманды используется одно и то же право cannonrtp.admin.

Команды администратора

Команда	Отправитель	Описание
/cannonrtp	Любой	Показывает заголовок справки, за которым следуют все доступные отправителю зарегистрированные подкоманды
/wc help	Любой	То же, что и /cannonrtp — выводит справочный список
/wc create <id>	Игрок	Создаёт новую конфигурацию пушки и размещает первый экземпляр в вашей текущей позиции
/wc create <id> <display_name>	Игрок	То же, что выше, но задаёт пользовательское отображаемое имя (подчёркивания заменяются пробелами)
/wc place <id>	Игрок	Добавляет ещё одно размещение существующей пушки в вашей текущей позиции
/wc remove <id>	Игрок	Удаляет ближайшее размещение <id> в вашем текущем мире (файл конфигурации сохраняется)
/wc delete <id>	Любой	Полностью удаляет файл конфигурации пушки
/wc target <id> <world>	Игрок	Меняет целевой мир приземления пушки
/wc center <id>	Игрок	Устанавливает центр поиска пушки на вашу текущую позицию
/wc list	Любой	Перечисляет все размещения с отображаемым именем, статусом, размером очереди и последней деталью статуса
/wc status	Любой	Тот же вывод, что и /wc list
/wc probe	Игрок	Проверяет, прошла бы ваша текущая позиция все включённые проверки защиты
/wc reload	Любой	Перезагружает глобальный конфиг, все конфиги пушек, задачи и адаптеры защиты
/wc setup	Игрок	Открывает меню браузера контента в стиле Nightbreak (перечисляет установленные и доступные к загрузке пакеты пушек)
/wc recommendedplugins	Любой	Открывает каталог Nightbreak с рекомендуемыми сопутствующими плагинами для CannonRTP
/wc downloadpluginupdate	Любой	Загружает более новый jar-файл плагина CannonRTP из Nightbreak (применяется после следующего перезапуска сервера)
/wc downloadall	Любой	Загружает обновление плагина CannonRTP и все доступные пакеты контента из Nightbreak
/wc downloadallcontent	Любой	Загружает все доступные пакеты контента CannonRTP из Nightbreak (только контент, без jar-файла плагина)
/wc updatecontent	Любой	Загружает обновления для устаревших пакетов контента CannonRTP (алиас: /wc updateallcontent)

CannonRTP не поставляется с отдельным меню первоначальной настройки /wc initialize — у него нет преднастроенных режимов. При первом входе администратора после установки в чате появится предупреждение Nightbreak с предложением запустить /wc setup.

Все перечисленные выше команды администратора требуют право cannonrtp.admin.

Эти команды Nightbreak входят в состав CannonRTP

/wc setup, /wc recommendedplugins, /wc downloadpluginupdate, /wc downloadall, /wc downloadallcontent и /wc updatecontent предоставляются общей библиотекой MagmaCore, встроенной (shaded) в CannonRTP. Они регистрируются автоматически — вы не увидите их в plugin.yml. Отдельная команда /nightbreaklogin <token> (также из MagmaCore) регистрирует токен вашего аккаунта Nightbreak для премиум-загрузок.

Подробности о том, чем именно управляют /wc setup, /wc downloadall и /wc updatecontent, см. на странице Пакеты контента.

create против place против remove против delete

Одна конфигурация пушки (plugins/CannonRTP/cannons/<id>.yml) может управлять многими размещениями в мире. create создаёт конфиг и добавляет первое размещение. place добавляет ещё одно размещение к существующему конфигу. remove удаляет одно размещение (ближайшее к вам в вашем мире), но сохраняет конфиг. delete полностью удаляет файл конфигурации, удаляя все размещения.

Взаимодействие с игроком

Для активации пушки нет игровой команды. Игроки используют CannonRTP, входя в радиус срабатывания пушки (triggerRadius, по умолчанию 1,75 блока).

Права

В plugin.yml зарегистрированы два права:

Право	По умолчанию	Описание
cannonrtp.admin	op	Требуется для каждой подкоманды администратора (включая встроенные команды Nightbreak setup / downloadall / updatecontent)
cannonrtp.use	true	Требуется, чтобы игрок мог активировать любую пушку

Общая команда /nightbreaklogin <token> (предоставляется MagmaCore, не объявлена в plugin.yml CannonRTP) использует собственное право nightbreak.login.

Как работает cannonrtp.use

Если у игрока нет права cannonrtp.use, пушка молча игнорирует этого игрока. Никакое сообщение об отказе не отправляется для этой базовой проверки — игрок просто проходит через зону пушки без запуска.

Гейт прав на конкретную пушку

Конфигурация каждой пушки также может определять поле requiredPermission.

• Если requiredPermission пустое (по умолчанию), пушка проверяет только cannonrtp.use.
• Если requiredPermission задано и у игрока есть cannonrtp.use, но нет права на конкретную пушку, CannonRTP отправляет настроенное сообщение noPermission, включающее отображаемое имя пушки. Сообщение ограничено одним отправлением в три секунды на игрока на пушку.

Автодополнение по Tab

Команды, принимающие аргумент <id> пушки, автодополняются из списка известных идентификаторов конфигов пушек. Команды, принимающие аргумент <world>, автодополняются из списка имён загруженных в данный момент миров.