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	（可选）	内容的下载地址
`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

内容包配置

战利品表权重格式