Перейти к основному содержимому

Пакеты контента CannonRTP

CannonRTP управляет официальными моделями пушек как пакетами контента Nightbreak. Текущие загрузки Free Cannon и Premium Cannon содержат модель FreeMinecraftModels и отметку версии пакета в content_packages/. Соответствующие конфиги пушек CannonRTP сам создаёт в cannons/; в загрузках нет конфигов размещения.

Основные команды​

КомандаНазначение
/wc setupОткрывает меню браузера контента Nightbreak (перечисляет установленные и доступные к загрузке пакеты пушек)
/wc downloadallСкачивает обновление плагина CannonRTP и все доступные пакеты контента Nightbreak
/wc updatecontentМассово обновляет устаревшие пакеты контента CannonRTP (алиас: /wc updateallcontent)
/wc reloadПерезагружает CannonRTP после ручного импорта
/nightbreaklogin <token>Общая регистрация токена Nightbreak — требуется для премиум-пакетов

Команды управления /wc требуют cannonrtp.admin. Отдельная команда учётной записи /nightbreaklogin <token> требует nightbreak.login.

Помимо пакетов пушек, меню /wc setup показывает пункт обновления плагина (нажмите его, чтобы загрузить доступное обновление), пункт рекомендуемых плагинов, пункт загрузки всего, который выполняет /wc downloadall, и переключатель автоматических обновлений, записывающий nightbreak.autoDownloadPluginUpdates в config.yml (см. Конфигурация).

Встроенные пакеты​

CannonRTP по умолчанию поставляется с определениями для двух комплектов Nightbreak:

Id пакетаОтображаемое имяИсточник
cannonrtpFree CannonRTPБесплатная загрузка Nightbreak
cannonrtp_premiumPremium CannonRTPТребует премиум-доступ покровителя Nightbreak

Каждое определение находится в plugins/CannonRTP/content_packages/<id>.yml и хранит:

  • isEnabled — включён ли пакет; меню /wc setup записывает его при включении или отключении пакета
  • version — локально установленная версия (используется /wc updatecontent для определения, что устарело)
  • name и description — отображаются в меню /wc setup
  • downloadLink — страница Nightbreak, на которую CannonRTP направляет вас, если у пакета нет nightbreakSlug и его нужно скачать вручную, а также ссылка в предупреждении консоли об устаревшем пакете
  • folderName и contentFilePrefixes — какие файлы внутри пакета CannonRTP считает его частью
  • nightbreakSlug — слаг проекта Nightbreak, используемый эндпойнтом загрузки/обновления

Эти файлы обычно не редактируются вручную — они регенерируются и перезаписываются плагином.

Состояния пакета​

Внутри меню /wc setup каждый пакет отображается как один из:

  • установлен — пакет проходит описанные ниже проверки загрузки, его метаданные содержат isEnabled: true, а соответствующие записи пушек присутствуют в plugins/CannonRTP/cannons/
  • скачан, но отключён — загрузка модели распознана, однако пакет не активен; отключение через меню перемещает файлы пушек в plugins/CannonRTP/cannons_disabled/
  • устарел — пакет установлен, и на Nightbreak доступна более новая версия; если у вашего привязанного аккаунта больше нет доступа, меню сообщает об этом вместо предложения обновления
  • требуется доступ — пакет не скачан, вы вошли в систему, но у вашего аккаунта Nightbreak нет доступа к нему
  • не скачан — нет положительного локального номера версии или не найдены файлы модели

Одних сгенерированных YAML-файлов пушек недостаточно для подтверждения загрузки. CannonRTP требует локальную version пакета больше нуля и хотя бы один файл .bbmodel внутри каталога пакета folderName в plugins/FreeMinecraftModels/models/ или plugins/FreeMinecraftModels/Models/. Если каталог модели отсутствует, пакет снова предлагается скачать, даже когда сгенерированная конфигурация пушки ещё существует.

Клик по пакету в меню загружает, устанавливает, включает или отключает его. Отключение пакета перемещает его конфиги пушек из cannons/ в cannons_disabled/ без удаления, поэтому повторное включение восстанавливает те же файлы. CannonRTP заново создаёт встроенные cannonrtp_free_cannon.yml и cannonrtp_premium_cannon.yml, если их нет в cannons/, поэтому после отключения перезагрузка оставляет там копии по умолчанию без размещений; повторное включение перемещает сохранённые файлы поверх них.

Структура папок пушек​

ПапкаНазначение
plugins/CannonRTP/cannons/Активные конфиги пушек. Всё, что здесь находится, загружается при старте или /wc reload.
plugins/CannonRTP/cannons_disabled/Упакованные конфиги пушек, которые в данный момент выключены. Файлы здесь игнорируются загрузчиком, но сохраняются для последующего повторного включения.
plugins/CannonRTP/imports/Папка для ручного импорта пакетов. CannonRTP сканирует её при старте и объединяет её содержимое в папки пакетов.

Резервный ручной импорт​

Вы по-прежнему можете установить пакет вручную:

  1. Скачайте zip-архив пакета с Nightbreak.
  2. Положите zip (как есть) в plugins/CannonRTP/imports/.
  3. Выполните /wc reload.

CannonRTP подхватит пакет, переместит файлы в соответствующие папки и перезагрузит конфиги пушек. Ручной импорт по-прежнему поддерживается, но больше не является рекомендуемым процессом — /wc setup и /wc downloadall обрабатывают это автоматически.

Премиум-доступ​

Премиум-пакеты контента (такие как cannonrtp_premium) требуют связанного аккаунта Nightbreak. Один раз выполните /nightbreaklogin <token> с токеном со страницы вашего аккаунта Nightbreak, после чего /wc downloadall или меню /wc setup смогут загрузить премиум-контент.

Если вы не вошли в систему, премиум-пакеты всё равно отображаются в меню настройки, но не могут быть загружены.