Extractioncraft 安裝

需求

• Java 21
• 在 1.21.4 API 線上的 Paper/Spigot 相容伺服器
• 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 建築圖設定可用，然後提供一個「完成首次設定」按鈕。由於這些地圖屬於 BetterStructures 內容，此選單的說明連結會指向 BetterStructures 的安裝頁面與共用的 Discord。
3. 從 nightbreak.io 下載內容包。
4. 將下載的內容放入 plugins/Extractioncraft/imports/ 資料夾。外掛會在下次啟動時解壓縮支援的壓縮檔。
5. 執行 /exc reload 或重新啟動伺服器。
6. 執行 /exc setup 以瀏覽和管理已安裝的內容包。每個套件會顯示彩色狀態（綠色 = 已安裝、黃色 = 已下載但未安裝、紅色 = 未下載）以及一個點擊動作。設定選單還包含一個 Recommended Plugins（推薦外掛）項目，以及一個資訊按鈕（玩家頭顱），內含通往 wiki、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）。該引數會以 Tab 自動補全可用的內容包檔案名稱——其中也包含目前標記為未安裝的套件，所以選錯的話會在世界生成階段失敗，而不是在指令階段。
2. 外掛會使用該套件的 betterStructuresModulesContainerName，透過 BetterStructures 非同步產生實例世界。生成不是瞬間完成的；世界準備就緒後，您會被傳送到新世界中的隨機出生點。
3. 目前的建置版本並未註冊任何加入指令，所以比賽中只會有建立它的那名玩家——套件的 maxPlayers（所有預製套件皆為 8）雖然會被共用的比賽執行環境讀取，卻沒有任何東西能達到它。一旦滿足 minPlayers（預設為 1），比賽中的任何玩家都可以執行 /exc start。
4. 任何時候要離開比賽，執行 /exc leave（或 /exc quit）。在比賽進行中未撤離就離開，預設會摧毀您的物品欄——請見比賽流程。