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

Настройка Nightbreak и управление контентом

Эта страница является общим руководством по настройке плагинов, управляемых Nightbreak.

Оно напрямую применяется к:

  • EliteMobs
  • BetterStructures
  • FreeMinecraftModels
  • EternalTD

Эти плагины теперь разделяют один и тот же общий жизненный цикл:

  1. Установите плагин и все обязательные зависимости.
  2. Запустите сервер один раз, чтобы были сгенерированы файлы и меню.
  3. Выполните команду первоначальной настройки плагина, если она есть.
  4. Привяжите токен Nightbreak с помощью /nightbreaklogin <token>.
  5. Используйте меню настройки плагина для просмотра, установки, включения, отключения и обновления контента.
  6. Используйте команды массовой загрузки/обновления плагина, когда хотите ускорить начальную настройку.

Что именно предоставляет MagmaCore​

MagmaCore — это общий слой за управляемым Nightbreak потоком. Он предоставляет:

  • общую команду /nightbreaklogin <token>
  • общее хранилище токенов в plugins/MagmaCore/nightbreak.yml
  • общие примитивы меню настройки, используемые меню настройки плагинов
  • общие проверки доступа, версий и загрузок Nightbreak
  • общую логику массовой загрузки, которая скачивает файлы в папку imports владеющего плагина

Специфичные для плагинов команды, такие как /em initialize или /bs setup, по-прежнему реализуются каждым плагином. MagmaCore предоставляет общие системы, которые эти команды используют.

Общий шаблон первого запуска​

Большинство текущих плагинов, управляемых Nightbreak, предоставляют:

ПлагинКоманда первого запускаМеню настройкиМассовая установкаМассовое обновление
EliteMobs/em initialize/em setup/em downloadall/em updatecontent
BetterStructures/bs initialize/bs setup/bs downloadall/bs updatecontent
FreeMinecraftModels/fmm initialize/fmm setup/fmm downloadall/fmm updatecontent
EternalTD/etd initialize/etd setup/etd downloadall/etd updatecontent

initialize — это поток начального руководства. Он не заменяет специфичное для плагина меню настройки или команды управления контентом.

MagmaCore также имеет отдельную систему инициализации при запуске плагина, но это не то же самое, что документированные здесь команды initialize, ориентированные на игрока.

Рекомендованный порядок действий для владельцев серверов​

1. Сначала установите плагин​

Поместите jar-файл плагина и все необходимые зависимости в plugins/, затем запустите сервер один раз.

2. Выполните процесс первоначальной настройки​

Если плагин предоставляет команду initialize, используйте её первой. Текущие меню предназначены для того, чтобы:

  • отметить первоначальную настройку как завершённую
  • направить вас к привязке аккаунта Nightbreak
  • направить вас к текущему меню настройки
  • уточнить, когда ручной импорт всё ещё допустим

Поведение меню первого запуска является общим, но точное имя команды и логика продолжения остаются специфичными для плагина.

3. Привяжите свой аккаунт Nightbreak​

Перейдите на страницу аккаунта Nightbreak, получите серверный токен и выполните:

/nightbreaklogin <token>

Токен используется совместно через MagmaCore, поэтому один привязанный токен может использоваться всеми совместимыми плагинами MagmaGuy на этом сервере.

4. Используйте меню настройки для повседневного управления контентом​

Меню настройки являются текущим первоисточником для:

  • состояний пакетов
  • состояний доступа
  • установленного и загруженного контента
  • частично установленного контента, требующего исправления
  • устаревшего контента
  • фильтров контента по категориям

Если у вас есть привязанный токен, меню настройки — рекомендуемое место для установки и обновления контента.

5. Используйте массовую установку/обновление, когда нужна скорость​

Используйте команду downloadall, когда хотите быстро настроить сервер, и команду updatecontent, когда хотите обновить всё устаревшее.

Общий массовый загрузчик пытается загрузить только пакеты, управляемые Nightbreak, которые:

  • имеют slug Nightbreak
  • доступны для привязанного токена
  • ещё не загружены или отмечены как устаревшие

Большинство текущих плагинов автоматически перезагружаются после успешных массовых загрузок.

Общие концепции​

Загружено и установлено​

Пакет может существовать локально, не будучи включённым. Точное значение немного варьируется в зависимости от плагина, но состояние в меню настройки важнее, чем наличие zip-файла в imports.

Массовые загрузки также попадают в ту же папку imports плагина, которая используется ручным импортом, до завершения этапа импорта/перезагрузки, специфичного для плагина.

Контент с учётом доступа​

Меню настройки теперь могут различать контент, который:

  • доступен для вашего токена
  • необходимо приобрести или разблокировать
  • установлен
  • установлен лишь частично
  • загружен, но отключён
  • устарел

Ручной импорт по-прежнему допустим​

Плагины, управляемые Nightbreak, по-прежнему поддерживают рабочие процессы ручного импорта. Ручной импорт теперь является запасным путём, а не путём по умолчанию. См. Ручной импорт и внутриигровое управление.

Плагины, не использующие этот поток​

Не каждый плагин в этой вики использует загружаемый контент, управляемый Nightbreak.

  • BetterFood не использует управление пакетами Nightbreak
  • ResurrectionChest не использует управление пакетами Nightbreak
  • WorldCannon не использует управление пакетами Nightbreak
  • ResourcePackManager управляет ресурс-паками, а не DLC-пакетами Nightbreak