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

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

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

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

Теперь эти плагины используют один и тот же общий жизненный цикл:

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

Что именно MagmaCore делает общим

MagmaCore является общей прослойкой за потоком Nightbreak-managed плагинов. Он предоставляет:

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

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

Общий шаблон первичной настройки

Большинство актуальных Nightbreak-managed плагинов поддерживают:

Плагин	Команда первичной настройки	Меню настройки	Массовая установка	Массовое обновление
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-managed пакетами, которые:

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

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

Общие понятия

Скачано и установлено - это не одно и то же

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

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

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

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

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

Ручной импорт все еще поддерживается

Nightbreak-managed плагины по-прежнему поддерживают ручной импорт. Теперь это запасной путь, а не путь по умолчанию. См. Ручной импорт и управление в игре.

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

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

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