Настройка Extractioncraft

Совместимость версии в разработке

Этот раздел описывает исходный код Extractioncraft 1.0-SNAPSHOT, а не проверенное сочетание выпущенных версий. Текущий исходный код компилируется с BetterStructures 2.7.6 и EliteMobs 10.9.7 и напрямую вызывает их API. Прежде чем открывать сервер игрокам, используйте совместимые сборки, проверенные вместе: установка последних версий сопутствующих плагинов сама по себе не доказывает совместимость.

Требования

• Плагин компилируется в байт-код Java 21; используйте среду Java, требуемую выбранной версией сервера
• Совместимый сервер Paper/Spigot: дескриптор объявляет 1.21.4, а текущая сборка компилируется с Spigot API 26.3-R0.1-SNAPSHOT. Эти значения не определяют проверенный диапазон версий сервера
• BetterStructures (объявлен как мягкая зависимость, необходим для запуска)
• EliteMobs (объявлен как мягкая зависимость, необходим для запуска)
• FreeMinecraftModels (объявлен как мягкая зависимость, необходим для запуска)
• WorldEdit или FastAsyncWorldEdit, которые BetterStructures использует для генерации карт

При запуске Extractioncraft ждёт, пока BetterStructures, EliteMobs и FreeMinecraftModels завершат загрузку, а затем даёт им до 5 минут на перезагрузку только что импортированного контента. Если какой-либо из них отсутствует, не загружается или всё ещё перезагружается по истечении этого времени, Extractioncraft записывает в журнал ExtractionCraft initialization failed, и его команды не регистрируются.

Что создаёт Extractioncraft

При запуске Extractioncraft инициализирует следующие пути:

plugins/Extractioncraft/config.yml
plugins/Extractioncraft/messaging.yml
plugins/Extractioncraft/content_packages/
plugins/Extractioncraft/loot_pools/
plugins/Extractioncraft/loot_tables/
plugins/Extractioncraft/imports/

Папка content_packages/ заранее заполнена пятью готовыми файлами конфигурации Kobold Mines. Папки loot_pools/ и loot_tables/ изначально пусты. Таблицы добычи, на которые ссылаются готовые пакеты (kobold_mines_equipment_loot_table.yml и kobold_mines_supplies_loot_table.yml), поставляются вместе со скачиваемым пакетом контента, а не с jar-файлом плагина.

Пакет контента также содержит данные карт, которые размещаются в сопутствующих плагинах: модульные генераторы, модули, компоненты и пулы спавна попадают в BetterStructures, боссы и предметы — в EliteMobs, а модели — в FreeMinecraftModels. Пакет считается скачанным в /exc setup, когда BetterStructures загрузил модульный генератор, указанный в betterStructuresModulesContainerName пакета.

Рекомендуемый порядок первой настройки

1. Установите Extractioncraft вместе с BetterStructures, EliteMobs, FreeMinecraftModels и WorldEdit (или FastAsyncWorldEdit). Запустите сервер один раз.
2. Выполните /exc initialize, чтобы открыть меню первоначальной настройки. Его панель статуса красная, если не включены ни WorldEdit, ни FastAsyncWorldEdit, жёлтая, если нет пакета, который одновременно включён и опирается на загруженный модульный генератор, и зелёная, как только пакет готов. Нажмите на панель, чтобы увидеть следующие шаги. Голова игрока ведёт на страницу Extractioncraft на nightbreak.io и в Discord.
3. Скачайте пакет контента с nightbreak.io.
4. Поместите скачанный ZIP-архив в папку plugins/Extractioncraft/imports/.
5. Выполните /exc reload или перезапустите сервер. Импортёр распаковывает ZIP в папки Extractioncraft, BetterStructures, EliteMobs и FreeMinecraftModels. Затем Extractioncraft перезагружает BetterStructures, а также EliteMobs, если пакет добавил контент EliteMobs, и ждёт, пока сопутствующие плагины завершат загрузку.
6. Выполните /exc setup для просмотра и управления пакетами контента. Каждый пакет имеет цветовой статус (зелёный = установлен, жёлтый = загружен, но не установлен, красный = не загружен). Нажатие на зелёный пакет отключает его, на жёлтый — включает, а на красный — выводит ссылку для скачивания с инструкцией поместить файл в папку импорта и выполнить /exc reload. Меню настройки также включает пункт Recommended Plugins и информационную кнопку (голова игрока) со ссылками на вики, Discord, страницу токена вашего аккаунта, /extractioncraft recommendedplugins и /nightbreak plugins.

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

Общие функции настройки MagmaCore

Поскольку MagmaCore входит в комплект Extractioncraft, плагин поставляется с общими инструментами настройки Nightbreak:

• Рекомендуемые плагины — /exc recommendedplugins (или пункт внутри /exc setup) перечисляет сопутствующие плагины, которые хорошо сочетаются с Extractioncraft, и показывает, какие из них уже установлены.
• Токен аккаунта / лицензионный контент — /nightbreaklogin регистрирует токен вашего аккаунта nightbreak.io, чтобы сервер мог скачивать лицензионный контент прямо в игре.
• Каталог плагинов — /nightbreak plugins открывает просматриваемый каталог других плагинов MagmaGuy.

Готовый контент

Extractioncraft поставляется с конфигурацией для следующих готовых пакетов контента (серия Kobold Mines):

Пакет	Имя файла конфигурации	Уровень	Максимум игроков
Kobold Mines 10	kobold_mines_10.yml	10	8
Kobold Mines 20	kobold_mines_20.yml	20	8
Kobold Mines 30	kobold_mines_30.yml	30	8
Kobold Mines 40	kobold_mines_40.yml	40	8
Kobold Mines 50	kobold_mines_50.yml	50	8

Уровень — это contentLevel пакета, используемый для добычи из контейнеров. Боссы из пулов спавна пакета контента появляются с тем же уровнем. На каждой карте есть зоны Normal, Hard и Mythic, причём самая сложная зона находится в центре; см. добыча при убийстве мобов.

Все готовые пакеты используют BetterStructures, FreeMinecraftModels и EliteMobs. PvP включено по умолчанию. Данные карт необходимо скачать отдельно по ссылке на контент, отображаемой в меню настройки.

Запуск матча

После установки контента:

1. Выполните /exc createMatch <contentPackage.yml> (например, /exc createMatch kobold_mines_10.yml). Аргумент поддерживает автодополнение по всем пакетам контента, загруженным при запуске. Команда отказывается работать с пакетом, который отключён или чей модульный генератор отсутствует, отключён, не является генератором мира или не содержит установленных стартовых модулей.
2. Плагин генерирует инстансированный мир через BetterStructures, используя значение betterStructuresModulesContainerName из пакета. Генерация не мгновенная, и её ход отображается на полосе босса; вы телепортируетесь в случайную точку спавна в новом мире, как только он будет готов. Генерация отменяется, если длится дольше 15 минут, если вы отключаетесь или если выполняете /exc leave.
3. Extractioncraft не регистрирует команду присоединения, поэтому в матче находится только создавший его игрок. Как только выполнено условие minPlayers (1 по умолчанию), любой игрок в матче может выполнить /exc start.
4. Чтобы покинуть матч в любое время, выполните /exc leave (или /exc quit). Выход после начала матча считается неудачной эвакуацией; см. ход матча.