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（soft-dependとして宣言、起動に必須）
- EliteMobs（soft-dependとして宣言、起動に必須）
- FreeMinecraftModels（soft-dependとして宣言、起動に必須）
- 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設定ファイル5個があらかじめ格納されています。loot_pools/ と loot_tables/ は最初は空です。プリメイドパッケージが参照するルートテーブル（kobold_mines_equipment_loot_table.yml と kobold_mines_supplies_loot_table.yml）は、プラグインのjarではなくダウンロード可能なコンテンツパックに同梱されています。
コンテンツパックにはマップデータも含まれており、それらは連携プラグイン側に配置されます。モジュールジェネレーター、モジュール、コンポーネント、スポーンプールはBetterStructuresへ、ボスとアイテムはEliteMobsへ、モデルはFreeMinecraftModelsへ配置されます。パッケージの betterStructuresModulesContainerName で指定されたモジュールジェネレーターをBetterStructuresが読み込むと、そのパッケージは /exc setup でダウンロード済みとみなされます。
推奨される初回セットアップ手順
- ExtractioncraftをBetterStructures、EliteMobs、FreeMinecraftModels、WorldEdit（またはFastAsyncWorldEdit）とともにインストールし、サーバーを一度起動します。
/exc initializeを実行して初回セットアップメニューを開きます。ステータス欄は、WorldEditもFastAsyncWorldEditも有効でない場合は赤、有効かつ読み込み済みのモジュールジェネレーターに対応したパッケージが1つもない場合は黄、パッケージの準備が整うと緑になります。欄をクリックすると次の手順が表示されます。プレイヤーの頭は、nightbreak.ioのExtractioncraftページとDiscordへのリンクです。- nightbreak.io からコンテンツパックをダウンロードします。
- ダウンロードしたZIPを
plugins/Extractioncraft/imports/フォルダに配置します。 /exc reloadを実行するか、サーバーを再起動します。インポーターがZIPをExtractioncraft、BetterStructures、EliteMobs、FreeMinecraftModelsの各フォルダに展開します。その後ExtractioncraftはBetterStructuresをリロードし、パックがEliteMobsのコンテンツを追加した場合はEliteMobsもリロードして、連携プラグインの読み込み完了を待ちます。/exc setupを実行して、コンテンツパッケージを閲覧・管理します。各パッケージには色付きステータス（緑＝インストール済み、黄＝ダウンロード済み未インストール、赤＝未ダウンロード）が表示されます。緑のパッケージをクリックすると無効化され、黄のパッケージをクリックすると有効化されます。赤のパッケージをクリックすると、ダウンロードリンクと、ファイルをインポートフォルダに置いて/exc reloadを実行するよう案内する説明が表示されます。セットアップメニューには Recommended Plugins エントリと情報ボタン（プレイヤーの頭）も含まれ、wiki、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はデフォルトで有効です。マップデータはセットアップメニューに表示されるコンテンツリンクから別途ダウンロードする必要があります。
マッチの開始
コンテンツがインストールされたら：
/exc createMatch <contentPackage.yml>を実行します（例：/exc createMatch kobold_mines_10.yml）。引数では起動時に読み込まれたすべてのコンテンツパッケージがタブ補完されます。パッケージが無効な場合や、そのモジュールジェネレーターが存在しない、無効である、ワールドジェネレーターでない、またはインストール済みの開始モジュールがない場合、コマンドは拒否されます。- プラグインは、パッケージの
betterStructuresModulesContainerNameを使ってBetterStructures経由でインスタンスワールドを生成します。生成は即座には終わらず、進行状況がボスバーに表示されます。準備が完了すると、新しいワールドのランダムなスポーン地点にテレポートされます。生成に15分以上かかった場合、切断した場合、または/exc leaveを実行した場合、生成はキャンセルされます。 - Extractioncraftは参加コマンドを登録していないため、マッチにはそれを作成したプレイヤーしか存在しません。
minPlayers（デフォルトは1）を満たすと、マッチ内のプレイヤーが/exc startを実行できます。 - マッチからいつでも退出するには、
/exc leave（または/exc quit）を実行します。マッチ開始後の退出は脱出失敗として扱われます。マッチの流れを参照してください。