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` 佔位符替換為最低玩家數量，因此若要讓數字被代入，請使用 `$amount` 而非 `$count` 來自訂此訊息。
`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> 格式。當玩家開啟容器時，會根據加權機率選擇一個戰利品表。

範例：

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

內容包設定

戰利品表權重格式