Extractioncraft セットアップ
必要条件
- Java 21
1.21.4APIラインのPaper/Spigot互換サーバー- BetterStructures（soft-depend、プリメイドコンテンツに必要）
- EliteMobs（soft-depend、プリメイドコンテンツに必要）
- FreeMinecraftModels（soft-depend、プリメイドコンテンツに必要）
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/
plugins/Extractioncraft/schematics/
schematics/ フォルダには、インストールされた各コンテンツパッケージの実際のBetterStructuresマップデータが、パッケージの folderName にちなんだサブフォルダ（例：schematics/kobold_mines_10/）に格納されます。
推奨される初回セットアップ手順
- ExtractioncraftをBetterStructures、EliteMobs、FreeMinecraftModels、WorldEdit（またはFastAsyncWorldEdit）とともにインストールし、サーバーを一度起動します。
/exc initializeを実行して初回セットアップメニューを開きます。WorldEditがインストールされていること、および少なくとも1つのBetterStructuresスケマティック設定が利用可能であることを確認したうえで、「初回セットアップを完了」ボタンが表示されます。- nightbreak.io からコンテンツパッケージをダウンロードします。
- ダウンロードしたコンテンツを
plugins/Extractioncraft/imports/フォルダに配置します。プラグインは次回起動時にサポートされているアーカイブを展開します。 /exc reloadを実行するか、サーバーを再起動します。/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はデフォルトで有効です。マップデータはセットアップメニューに表示されるコンテンツリンクから別途ダウンロードする必要があります。
マッチの開始
コンテンツがインストールされたら：
/exc createMatch <contentPackage.yml>を実行します（例：/exc createMatch kobold_mines_10.yml）。引数では利用可能なコンテンツパッケージのファイル名がタブ補完されます。- プラグインがBetterStructuresを介してインスタンスワールドを非同期で生成します。準備が完了するとテレポートされます。
- 他のプレイヤーが参加できます。最少プレイヤー数を満たしたら、マッチ内のいずれかのプレイヤーが
/exc startを実行できます。 - マッチからいつでも退出するには、
/exc leave（または/exc quit）を実行します。