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

BetterStructures теперь обрабатывает официальный контент как управляемые пакеты, а не чисто ручной рабочий процесс импорта.

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

Команда	Назначение
/bs initialize	Процесс первоначальной настройки
/bs setup	Просмотр и управление состоянием пакетов
/bs downloadall	Загружает обновление плагина (если оно есть) и весь доступный контент, затем перезагружается
/bs downloadallcontent	Загружает только весь доступный контент (без обновления плагина)
/bs updatecontent	Обновляет устаревший контент (алиас: /bs updateallcontent)
/bs forcereinstallcontent <package|all>	Повторно загружает контент, даже если установленная версия уже актуальна, — команда восстановления для повреждённых или частично удалённых паков
/bs recommendedplugins	Перечисляет сопутствующие плагины, которые хорошо сочетаются с BetterStructures
/nightbreaklogin <token>	Общая регистрация токена Nightbreak

Эти команды контента предоставляются общей системой MagmaCore Nightbreak, встроенной в BetterStructures, поэтому один и тот же жизненный цикл (проверка токена, проверка доступа, загрузка, автоперезагрузка) идентичен во всех плагинах MagmaGuy.

Типы пакетов

Каждый пакет объявляет contentPackageType, и меню настройки предлагает по одному фильтру на тип:

contentPackageType	Фильтр в меню настройки	Файлы попадают в
STRUCTURE (по умолчанию)	Structure Packs	plugins/BetterStructures/schematics/<folderNameV2>
MODULAR	Module Packs	plugins/BetterStructures/modules/<folderNameV2>

Используйте /bs setup для фильтрации и проверки пакетов вместо того, чтобы полагаться на старые статические списки.

Поля конфигурации пакета

Каждый пакет описывается конфигом в plugins/BetterStructures/content_packages. Редактировать их вручную требуется редко — они поставляются вместе с плагином и служат для отслеживания состояния пакета, — но вот их поля:

Ключ	По умолчанию	Описание
isEnabled	true	Активен ли контент пакета. Переключается автоматически, когда вы устанавливаете или удаляете пакет через меню настройки.
name	—	Отображаемое имя, показываемое в меню настройки
description	—	Строки описания, показываемые в меню настройки
downloadLink	—	Откуда загружается пакет
version	0	Локальная версия контента, сравниваемая с удалённой версией, чтобы определить, устарел ли пакет
folderNameV2	—	Подпапка, в которой находятся файлы пакета, внутри schematics или modules в зависимости от типа
contentPackageType	STRUCTURE	STRUCTURE или MODULAR
nightbreakSlug	—	Идентификатор Nightbreak, используемый для проверок доступа, загрузок и как селектор для /bs forcereinstallcontent

Установка или удаление пакета STRUCTURE также переключает isEnabled во всех конфигах схематик внутри его папки, после чего запускается перезагрузка. Пакеты MODULAR переключаются только на уровне пакета.

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

В зависимости от пакета и состояния вашего токена, BetterStructures может различать:

• установленный контент
• загруженный, но не активированный контент
• устаревший контент
• контент, требующий доступа Nightbreak

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

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

Ручной импорт по-прежнему использует:

plugins/BetterStructures/imports

Оставляйте zip-файлы пакетов нетронутыми, затем перезагрузите BetterStructures при необходимости. Ручной импорт по-прежнему поддерживается, но больше не является основным документированным рабочим процессом.