Настройка BetterStructures
BetterStructures по-прежнему поддерживает ручной импорт, но текущий рекомендуемый рабочий процесс — Nightbreak в первую очередь и внутриигровой.
Требования
- Поддержка схематик, совместимая с WorldEdit или FAWE
- Среда выполнения Java 21 для текущей линейки сборки
Рекомендуемый рабочий процесс
- Установите BetterStructures и WorldEdit, затем запустите сервер один раз.
- Выполните
/bs initialize. - Свяжите токен Nightbreak с помощью
/nightbreaklogin <token>. - Откройте
/bs setupдля просмотра пакетов структур и пакетов модулей. - Используйте
/bs downloadallдля быстрой начальной загрузки (она получает ожидающее обновление плагина и весь контент). - Используйте
/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, и позволяет загрузить её (для применения требуется перезапуск). Проверка выполняется автоматически при запуске и обновляется примерно раз в час, поэтому только что запущенный сервер может некоторое время показывать «Plugin Update Pending».
- Recommended Plugins — открывает представление с рекомендациями сопутствующих плагинов (то же, что и
/bs recommendedplugins). Значок становится зелёным, когда установлены все перечисленные рекомендации. - Download All Content — массовый пункт, добавляемый после списка пакетов, эквивалент
/bs downloadall. - Automatic Updates — переключатель на панели инструментов, определяющий, загружает ли BetterStructures обновления плагина и контента автоматически при запуске. По умолчанию он отключён и привязан к ключу
nightbreak.autoDownloadPluginUpdatesвconfig.yml. Для применения загруженного обновления плагина всё равно требуется перезапуск. - Installation tips — информационная кнопка, которая выводит в чат руководство по настройке, страницу токена аккаунта, Discord поддержки и кликабельные команды настройки.
/bs setup не открывается, пока выполняется перезагрузка контента, поскольку меню читает те же реестры, которые перестраивает процесс перезагрузки. Дождитесь сообщения об успешной перезагрузке и откройте меню снова.
Если файлы пакета оказались повреждены или частично удалены, /bs setup их не восстановит — он сравнивает версии и считает пакет актуальным. Вместо этого используйте /bs forcereinstallcontent <package|all>.
Резервный ручной импорт
Ручной импорт по-прежнему работает через:
plugins/BetterStructures/imports
Оставляйте zip-файлы пакетов нетронутыми, затем выполните /bs reload при необходимости. /bs reload импортирует всё, что лежит в этой папке, как часть перезагрузки, поэтому перезапуск для подхвата закинутого пакета не нужен.
Учтите, что оставленные в imports файлы замедляют запуск: когда папка не пуста, BetterStructures ждёт завершения инициализации плагинов, перечисленных в его softdepend, прежде чем стартовать, потому что импорт контента в папку данных другого плагина означает, что этот плагин придётся перезагрузить. Как только папка снова пуста, BetterStructures инициализируется без ожидания.
Смотрите общее руководство: Ручной импорт vs внутриигровое управление.