Настройка Extractioncraft

Требования

• Java 21
• Сервер на базе Paper/Spigot с API линии 1.21.4
• BetterStructures (мягкая зависимость, требуется для готового контента)
• EliteMobs (мягкая зависимость, требуется для готового контента)
• FreeMinecraftModels (мягкая зависимость, требуется для готового контента)

Что создаёт 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_chest_high_loot_table_10.yml и подобные), поставляются вместе со скачиваемым пакетом контента, а не с jar-файлом плагина.

Папка schematics/ при запуске не создаётся. Она появляется после установки контента и содержит данные карт для каждого пакета контента в подпапке, имя которой соответствует значению folderName пакета (например, schematics/kobold_mines_10/). Extractioncraft использует наличие этой подпапки, чтобы определить, считается ли пакет скачанным в /exc setup.

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

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

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

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

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

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

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

Пакет	Имя файла конфигурации	Диапазон уровней EliteMobs	Максимум игроков
Kobold Mines 10	kobold_mines_10.yml	0-10	8
Kobold Mines 20	kobold_mines_20.yml	11-20	8
Kobold Mines 30	kobold_mines_30.yml	21-30	8
Kobold Mines 40	kobold_mines_40.yml	31-40	8
Kobold Mines 50	kobold_mines_50.yml	41-50	8

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

Запуск матча

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

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