メインコンテンツまでスキップ

Extractioncraft セットアップ

必要条件​

  • Java 21
  • 1.21.4 APIラインの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/

content_packages/ にはプリメイドのKobold Mines設定ファイル5個があらかじめ格納されています。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）がインストールされていること、および少なくとも1つの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 10kobold_mines_10.yml0-108
Kobold Mines 20kobold_mines_20.yml11-208
Kobold Mines 30kobold_mines_30.yml21-308
Kobold Mines 40kobold_mines_40.yml31-408
Kobold Mines 50kobold_mines_50.yml41-508

すべてのプリメイドパッケージはBetterStructures、FreeMinecraftModels、EliteMobsを使用します。PvPはデフォルトで有効です。マップデータはセットアップメニューに表示されるコンテンツリンクから別途ダウンロードする必要があります。

マッチの開始​

コンテンツがインストールされたら：

  1. /exc createMatch <contentPackage.yml> を実行します（例：/exc createMatch kobold_mines_10.yml）。引数では利用可能なコンテンツパッケージのファイル名がタブ補完されます。現在インストールされていないとマークされているパッケージも補完対象に含まれるため、誤った選択はコマンド段階ではなくワールド生成の段階で失敗します。
  2. プラグインは、パッケージの betterStructuresModulesContainerName を使ってBetterStructures経由でインスタンスワールドを非同期に生成します。生成は即座には終わりません。準備が完了すると、新しいワールドのランダムなスポーン地点にテレポートされます。
  3. 現在のビルドには参加コマンドが登録されていないため、マッチにはそれを作成したプレイヤーしか存在しません。パッケージの maxPlayers（すべてのプリメイドパッケージで8）は共通のマッチランタイムに読み込まれますが、その値に到達する手段はありません。minPlayers（デフォルトは 1）を満たすと、マッチ内のプレイヤーが /exc start を実行できます。
  4. マッチからいつでも退出するには、/exc leave（または /exc quit）を実行します。進行中のマッチを脱出せずに離れると、デフォルトではインベントリが消去されます — マッチの流れ を参照してください。