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`	此套件是否算作已安裝。這會決定它在 `/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 套件都把它覆寫為 `8`。目前的建置版本並未註冊任何加入指令，所以只有建立者會進入比賽，這個上限永遠不會被達到。
`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

:weight 這一半是必填的——沒有冒號和數字的項目會解析失敗，並導致該內容包無法載入。權重是彼此相對的，因此上面的範例讓兩張箱子戰利品表各占 50%。若檔案名稱在 loot_tables/ 中找不到對應檔案，啟動時會記錄警告，並使該套件的容器掠奪功能失效。

config.yml​

messaging.yml​

內容包設定​

戰利品表權重格式​

config.yml

messaging.yml

內容包設定

戰利品表權重格式