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`	このコンテンツパッケージが有効かどうか
`name`	String	（必須）	パッケージの表示名（`&` カラーコード対応）
`description`	String list	（必須）	セットアップメニューに表示される説明文
`downloadLink`	String	（任意）	コンテンツをダウンロードできるURL
`version`	Integer	`0`	コンテンツのバージョン番号。更新チェックに使用
`folderName`	String	（必須）	このパッケージ用のスケマティクスサブフォルダ名
`usesEliteMobs`	Boolean	`false`	パッケージがEliteMobsコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。
`usesBetterStructures`	Boolean	`false`	パッケージがBetterStructuresコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。
`usesFreeMinecraftModules`	Boolean	`false`	パッケージがFreeMinecraftModelsコンテンツを使用することを示す宣言フラグ。ランタイムでは強制されません。ソース上のYAMLキーは `usesFreeMinecraftModules`（"Modules" の綴り）である点に注意してください。
`betterStructuresModulesContainerName`	String	（任意）	BetterStructuresモジュールジェネレーターの設定ファイル名
`spectatable`	Boolean	`false`	観戦者がこのパッケージを使用するマッチに参加できるかどうか
`pvpEnabled`	Boolean	`true`	マッチ中にPvPが有効かどうか
`minPlayers`	Integer	`1`	マッチ開始に必要な最少プレイヤー数
`maxPlayers`	Integer	`100`	マッチに参加可能な最大プレイヤー数
`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

config.yml​

messaging.yml​

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

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

config.yml

messaging.yml

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

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