Настройка BetterStructures

BetterStructures по-прежнему поддерживает ручной импорт, но текущий рекомендуемый рабочий процесс — Nightbreak в первую очередь и внутриигровой.

Требования

• Поддержка схематик, совместимая с WorldEdit или FAWE
• Среда выполнения Java 21 для текущей линейки сборки

Рекомендуемый рабочий процесс

1. Установите BetterStructures и WorldEdit, затем запустите сервер один раз.
2. Выполните /bs initialize.
3. Свяжите токен Nightbreak с помощью /nightbreaklogin <token>.
4. Откройте /bs setup для просмотра пакетов структур и пакетов модулей.
5. Используйте /bs downloadall для быстрой начальной загрузки (она получает ожидающее обновление плагина и весь контент).
6. Используйте /bs updatecontent, когда доступны обновления пакетов.

Меню первоначальной настройки

/bs initialize открывает небольшое пошаговое меню. Пока не выбран один из его пунктов, каждый игрок с правом betterstructures.* получает напоминание через десять секунд после входа. Все три варианта помечают настройку как завершённую, записывая setupDone: true в config.yml.

Вариант	Что он делает
Recommended Setup	Помечает настройку как завершённую и выводит путь из трёх шагов: получить токен на nightbreak.io/account, привязать его командой /nightbreaklogin <token>, затем открыть /bs setup.
Manual Setup	Помечает настройку как завершённую и оставляет управление контентом на вас, указывая на /bs setup и папку imports.
Use Current Content	Убирает подсказку и сохраняет текущий контент. Если реестр схематик не пуст, выполняет перезагрузку; иначе сообщает об отсутствии установленного контента и направляет к /bs setup. Эта проверка не учитывает модули.

Если не установлен ни WorldEdit, ни FastAsyncWorldEdit, третий слот заменяется предупреждением с просьбой установить один из них, прежде чем продолжать.

Меню настройки

/bs setup открывает постраничное меню с двумя фильтрами: Structure Packs и Module Packs. Каждый пакет показывает своё состояние: установлен, скачан, но отключён, устарел или требует доступа Nightbreak. Действие при нажатии зависит от состояния: скачивание, установка, обновление, удаление или показ сведений о доступе.

Наряду с пакетами меню также предоставляет общие элементы управления MagmaCore, встроенные в BetterStructures:

• Plugin Update — показывает, доступна ли новая сборка BetterStructures, и позволяет загрузить её. Обновление применяется при перезапуске, если только вы не выполните /bs applypluginupdate или не зададите nightbreak.applyPluginUpdatesWithoutRestart в config.yml значение when-empty или immediately. Проверка выполняется автоматически при запуске и обновляется примерно раз в час, поэтому только что запущенный сервер может некоторое время показывать «Plugin Update Pending».
• Recommended Plugins — открывает представление с рекомендациями сопутствующих плагинов (то же, что и /bs recommendedplugins). Значок становится зелёным, когда установлены все перечисленные рекомендации.
• Download All Content — массовый пункт, добавляемый после списка пакетов, эквивалент /bs downloadall.
• Automatic Updates — переключатель автоматического скачивания обновлений плагина и контента при запуске. По умолчанию он отключён и соответствует ключу nightbreak.autoDownloadPluginUpdates в config.yml. Автоматически скачанный контент подготавливается к следующему перезапуску, без немедленной перезагрузки. Перезапуск также применяет скачанное обновление плагина, если только nightbreak.applyPluginUpdatesWithoutRestart не задан как when-empty или immediately (см. Конфигурация).
• Installation tips — информационная кнопка, которая выводит в чат руководство по настройке, страницу токена аккаунта, Discord поддержки и кликабельные команды настройки.

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

Меню не проверяет целостность файлов. Повреждённый или частично удалённый пакет может по-прежнему отображаться как актуальный, если его путь существует и версия совпадает. Для восстановления используйте /bs forcereinstallcontent <package|all>; если папка пакета отсутствует целиком, укажите slug напрямую. Удаление пакета сохраняет файлы на диске. Оно устанавливает isEnabled пакета в false и выполняет перезагрузку, а перезагрузка пропускает все схематики и модули в папке этого пакета, включая вложенные папки.

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

Ручной импорт по-прежнему работает через:

plugins/BetterStructures/imports

Оставляйте zip-файлы пакетов нетронутыми, затем выполните /bs reload при необходимости. /bs reload импортирует всё, что лежит в этой папке, как часть перезагрузки, поэтому перезапуск для подхвата закинутого пакета не нужен.

Учтите, что оставленные в imports файлы замедляют запуск: когда папка не пуста, BetterStructures ждёт завершения инициализации плагинов, перечисленных в его softdepend, прежде чем стартовать, потому что импорт контента в папку данных другого плагина означает, что этот плагин придётся перезагрузить. Как только папка снова пуста, BetterStructures инициализируется без ожидания.

Смотрите общее руководство: Ручной импорт vs внутриигровое управление.