Extractioncraft 安裝
本節說明 Extractioncraft 1.0-SNAPSHOT 的原始碼，並非已驗證的發行版本組合。目前的原始碼針對 BetterStructures 2.7.6 與 EliteMobs 10.9.7 編譯，並直接呼叫它們的 API。向玩家開放伺服器前，請使用經過測試且彼此相符的建置版本組合；僅安裝最新的配套外掛無法證明相容性。
需求
- 外掛的目標位元組碼版本為 Java 21；請使用所選伺服器版本要求的 Java 執行環境
- 相容的 Paper/Spigot 伺服器：描述檔宣告
1.21.4，但目前建置使用 Spigot API26.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，Boss 與物品放進 EliteMobs，模型則放進 FreeMinecraftModels。當 BetterStructures 已載入套件 betterStructuresModulesContainerName 中指定的模組生成器時，該套件在 /exc setup 中就算作已下載。
建議的首次設定流程
- 安裝 Extractioncraft 以及 BetterStructures、EliteMobs、FreeMinecraftModels 和 WorldEdit（或 FastAsyncWorldEdit）。啟動伺服器一次。
- 執行
/exc initialize以開啟首次設定選單。WorldEdit 與 FastAsyncWorldEdit 都未啟用時，其狀態窗格為紅色；沒有任何套件同時已啟用且有已載入的模組生成器支援時為黃色；有套件準備就緒後則為綠色。點擊該窗格可查看後續步驟。玩家頭顱會連結到 nightbreak.io 上的 Extractioncraft 頁面與 Discord。 - 從 nightbreak.io 下載內容包。
- 將下載的 ZIP 放入
plugins/Extractioncraft/imports/資料夾。 - 執行
/exc reload或重新啟動伺服器。匯入器會將 ZIP 解壓縮到 Extractioncraft、BetterStructures、EliteMobs 與 FreeMinecraftModels 的資料夾中。接著 Extractioncraft 會重新載入 BetterStructures（若內容包加入了 EliteMobs 內容，也會重新載入 EliteMobs），並等待配套外掛完成載入。 - 執行
/exc setup以瀏覽和管理內容包。每個套件會顯示彩色狀態（綠色 = 已安裝、黃色 = 已下載但未安裝、紅色 = 未下載）。點擊綠色套件會停用它，點擊黃色套件會啟用它，點擊紅色套件則會印出其下載連結，並說明要將檔案放進 imports 資料夾後執行/exc reload。設定選單還包含一個 Recommended Plugins（推薦外掛）項目，以及一個資訊按鈕（玩家頭顱），內含通往 wiki、Discord、您的帳號權杖頁面的連結，以及/extractioncraft recommendedplugins和/nightbreak plugins。
內容包不會在遊戲內下載；請使用下載連結與 imports 資料夾。
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，用於容器戰利品。內容包生成池中的 Boss 也以相同等級生成。每張地圖都有 Normal、Hard 與 Mythic 區域，最困難的區域位於中心；請參閱怪物擊殺戰利品。
所有預製套件使用 BetterStructures、FreeMinecraftModels 和 EliteMobs。PvP 預設為啟用。地圖資料需要從設定選單中顯示的內容連結另外下載。
開始比賽
安裝內容後：
- 執行
/exc createMatch <contentPackage.yml>（例如/exc createMatch kobold_mines_10.yml）。該引數會以 Tab 自動補全啟動時載入的每個內容包。若套件已停用，或其模組生成器缺少、已停用、不是世界生成器，或沒有已安裝的起始模組，指令會拒絕執行。 - 外掛會使用該套件的
betterStructuresModulesContainerName，透過 BetterStructures 產生實例世界。生成不是瞬間完成的，期間會顯示進度 Boss 條；世界準備就緒後，您會被傳送到新世界中的隨機出生點。若生成超過 15 分鐘、您斷線，或執行/exc leave，生成都會被取消。 - Extractioncraft 沒有註冊任何加入指令，所以比賽中只會有建立它的那名玩家。一旦滿足
minPlayers（預設為1），比賽中的任何玩家都可以執行/exc start。 - 任何時候要離開比賽，執行
/exc leave（或/exc quit）。比賽開始後離開視為撤離失敗；請見比賽流程。