Extractioncraft 設定

Extractioncraftは複数の設定ファイルを使用します。主な設定は config.yml と messaging.yml にあります。コンテンツパッケージ、ルートテーブル、ルートプールにはそれぞれ独自の設定フォルダがあります。

config.yml

キー	型	デフォルト	説明
deleteItemsOnFailToExtract	Boolean	true	脱出ポイントのいずれかを使用したマッチからの脱出に失敗した場合、プレイヤーがすべてのアイテムを失うかどうか。有効な場合、プリメイドコンテンツはこのリスクを前提にバランス調整されています。無効にすると、コンテンツのファーミングが容易になり、脱出メカニクスに関わる理由が減ります。

アイテムの消去が適用されるのは、マッチが実際に進行中になってからです。インスタンスがまだ待機状態またはカウントダウン状態のうちに退出したプレイヤーはインベントリを保持します。マッチが動き出したあとは、脱出成功以外のあらゆる退出（退出、切断、死亡、プラグインによる除外）でインベントリ全体が消去されます。

messaging.yml

すべてのメッセージは & カラーコードに対応しています。プレースホルダーは行ごとに記載されています。

キー	デフォルト	説明
failedToJoinOngoingMatchAsPlayerMessage	Can't join this match - it has already started!	プレイヤーが進行中のマッチに参加しようとしたときに表示
failedToJoinOngoingMatchAsPlayerInstanceIsFull	Can't join this match - the instance is already full!	マッチが最大プレイヤー数に達しているときに表示
failedToJoinOngoingMatchAsPlayerNoPermission	Can't join this match - you don't have the permission!	プレイヤーに参加権限がないときに表示
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessage	Can't join this match - spectators are not allowed!	コンテンツパッケージで観戦が無効な場合の設定可能なメッセージ。現在のMagmaCoreマッチランタイムでは送出されません: 観戦の試行はメッセージを送らずに黙って拒否されます。
failedToJoinMatchAsSpectatorNoPermission	Can't spectate this match - you don't have the permission!	プレイヤーに観戦権限がない場合の設定可能なメッセージ。現在のMagmaCoreマッチランタイムでは送出されません: 権限を持たない観戦者には代わりに failedToJoinOngoingMatchAsPlayerNoPermission が表示されます。
matchJoinAsPlayerMessage	[Extractioncraft] You are now in the match, $player!	プレイヤーとしてマッチに参加したときのチャットメッセージ。MagmaCoreランタイムはこの文字列内の $count プレースホルダー（最少プレイヤー数）のみを置換します。$player は置換されないため、デフォルトのテキストでは $player がそのまま表示されます。
matchJoinAsPlayerTitle	Extract!	マッチ参加時に表示されるタイトル
matchJoinAsPlayerSubtitle	Grab the loot and head to an extraction point!	設定可能な参加サブタイトル。現在のMagmaCoreマッチランタイムでは使用されません: 参加時に実際に表示されるサブタイトルは matchStartingSubtitle です。
matchJoinAsSpectatorTitle	（空）	設定可能な観戦参加タイトル。現在のMagmaCoreマッチランタイムでは送出されません。
matchJoinAsSpectatorSubtitle	Now spectating!	設定可能な観戦参加サブタイトル。現在のMagmaCoreマッチランタイムでは送出されません。
matchJoinAsSpectatorMessage	[Extractioncraft] You are now spectating a match! Do &a/extractioncraft quit &fto stop spectating!	設定可能な観戦参加チャットメッセージ。現在のMagmaCoreマッチランタイムでは送出されません。
matchLeaveAsPlayerMessage	[Extractioncraft] You have left the match, $player!	設定可能な退出メッセージ。現在のMagmaCoreマッチランタイムでは送出されず、$player も置換されません。
matchLeaveAsSpectatorMessage	[Extractioncraft] You have left the match, $player!	設定可能な観戦退出メッセージ。現在のMagmaCoreマッチランタイムでは送出されず、$player も置換されません。
matchFailedToStartNotEnoughPlayersMessage	This match requires $count players before starting - can't start yet!	十分なプレイヤーがいない状態で /exc start を使用したときに表示。MagmaCoreランタイムは $amount プレースホルダーを最少プレイヤー数に置換するため、数値を置換したい場合は $count ではなく $amount を使用してこのメッセージをカスタマイズしてください。
matchStartingMessage	[Extractioncraft] Match starting!	設定可能なマッチ開始チャットメッセージ。現在のMagmaCoreマッチランタイムでは送出されません（カウントダウンは代わりにタイトル/サブタイトルで表示されます）。
matchStartingTitle	Match starting!	3秒間のカウントダウン中に表示されるタイトル。$count は残り秒数に置換されます。
matchStartingSubtitle	in $count...	3秒間のカウントダウン中のサブタイトル。$count は残り秒数に置換されます。
preventTeleportInMessage	[Extractioncraft] You have attempted to teleport into an ongoing match - you can't do that!	マッチワールドへのテレポートがブロックされた場合の設定可能なメッセージ。テレポート自体はランタイムによってキャンセルされますが、このメッセージは現在プレイヤーに送信されません。
preventTeleportOutMessage	[Extractioncraft] You have attempted to teleport from an ongoing match - you can't do that!	マッチからのテレポートがブロックされた場合の設定可能なメッセージ。テレポート自体はランタイムによってキャンセルされますが、このメッセージは現在プレイヤーに送信されません。

コンテンツパッケージ設定

コンテンツパッケージは content_packages/ フォルダ内のYAMLファイルです。各ファイルはプレイ可能なマップ設定を定義します。

キー	型	デフォルト	説明
isEnabled	Boolean	true	パッケージがインストール済みとみなされるかどうか。/exc setup でのエントリの色（true ＝ インストール済み/緑、false ＝ ダウンロード済み未インストール/黄）を決定し、セットアップメニューが自動で切り替えます。/exc createMatch からパッケージを取り除くことはありません。
name	String	（必須）	パッケージの表示名（& カラーコード対応）
description	String list	（必須）	セットアップメニューに表示される説明文
downloadLink	String	（任意）	セットアップメニューで未ダウンロードのパッケージをクリックしたときにチャットに表示されるURL
version	Integer	0	コンテンツのバージョン番号。Extractioncraftのコンテンツ状態チェックは未ダウンロード / インストール済み / 未インストールしか区別しないため、この値は現在何とも比較されていません。
folderName	String	（必須）	このパッケージ用のスケマティクスサブフォルダ名
usesEliteMobs	Boolean	false	パッケージがEliteMobsコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。
usesBetterStructures	Boolean	false	パッケージがBetterStructuresコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。
usesFreeMinecraftModules	Boolean	false	パッケージがFreeMinecraftModelsコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。ソース上のYAMLキーは usesFreeMinecraftModules（"Modules" の綴り）である点に注意してください。
betterStructuresModulesContainerName	String	（任意）	/exc createMatch の実行時にワールドジェネレーターへ渡されるBetterStructuresモジュールジェネレーターの設定ファイル名（例：kobold_mines_module_generator_10.yml）。どのマップが生成されるかを実際に決定するのはこのキーです。
spectatable	Boolean	false	設定可能な観戦の切り替え。Extractioncraftはこの値を構築するマッチインスタンスに渡していないため、ランタイムは常にマッチを観戦不可として扱い、ここに何を設定しても観戦としての参加は拒否されます。
pvpEnabled	Boolean	true	マッチ中にPvPが有効かどうか。false の場合、マッチワールド全体でフレンドリーファイアがブロックされます。
minPlayers	Integer	1	マッチ開始に必要な最少プレイヤー数。これを下回ると /exc start は拒否され、カウントダウン中に人数がこれを下回るとカウントダウンは中止されます（マッチは終了します）。
maxPlayers	Integer	100	マッチに参加可能な最大プレイヤー数。プリメイドのKobold Minesパッケージ5個はすべてこれを 8 に上書きしています。現在のビルドには参加コマンドが登録されていないため、マッチに入るのは作成者だけであり、この上限に達することはありません。
chestLootTables	String list	[]	チェストに使用されるルートテーブル。filename.yml:weight 形式
barrelLootTables	String list	[]	樽に使用されるルートテーブル。filename.yml:weight 形式

ルートテーブルの重み形式

チェストと樽のルートテーブルエントリは <loot_table_filename.yml>:<weight> の形式を使用します。プレイヤーがコンテナを開くと、重み確率に基づいて1つのルートテーブルが選択されます。

例：

chestLootTables:
  - kobold_mines_chest_high_loot_table_10.yml:.2
  - kobold_mines_chest_low_loot_table_10.yml:.2
barrelLootTables:
  - kobold_mines_barrel_loot_table_10.yml:1

:weight の部分は必須です。コロンと数値のないエントリは解析に失敗し、そのコンテンツパッケージの読み込みが止まります。重みは互いの相対値であるため、上の例では2つのチェストテーブルがそれぞれ50%ずつの割合になります。loot_tables/ 内のファイルに一致しないファイル名は起動時に警告を出力し、そのパッケージのコンテナルーティングを壊します。