跳到主要内容

Extractioncraft 配置

Extractioncraft 使用多个配置文件。主要设置位于 config.yml 和 messaging.yml 中。内容包、战利品表和战利品池各有自己的配置文件夹。

config.yml​

键类型默认值描述
deleteItemsOnFailToExtractBooleantrue玩家未能通过某个撤离点从对局中撤离时是否丢失所有物品。启用时，预制内容会围绕此风险进行平衡。禁用会使内容更容易刷取，也降低了参与撤离机制的动力。

物品清除只在对局真正开始后才生效：在实例仍处于等待或倒计时状态时离开的玩家会保留背包。一旦对局进行中，任何非成功撤离的退出方式（离开、断线、死亡或被插件移出）都会清空整个背包。

messaging.yml​

所有消息支持 & 颜色代码。占位符按行进行说明。

键默认值描述
failedToJoinOngoingMatchAsPlayerMessageCan't join this match - it has already started!玩家尝试加入进行中的比赛时显示
failedToJoinOngoingMatchAsPlayerInstanceIsFullCan't join this match - the instance is already full!比赛已达到最大玩家数时显示
failedToJoinOngoingMatchAsPlayerNoPermissionCan't join this match - you don't have the permission!玩家缺少加入权限时显示
failedToJoinMatchAsSpectatorNoSpectatorsAllowedMessageCan't join this match - spectators are not allowed!内容包禁用旁观功能时可配置的消息。目前 MagmaCore 比赛运行时不会发出此消息：旁观尝试会被静默拒绝，不发送任何消息。
failedToJoinMatchAsSpectatorNoPermissionCan'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。
matchJoinAsPlayerTitleExtract!加入比赛时显示的标题
matchJoinAsPlayerSubtitleGrab the loot and head to an extraction point!可配置的加入副标题。目前 MagmaCore 比赛运行时不使用此项：加入时实际显示的副标题是 matchStartingSubtitle。
matchJoinAsSpectatorTitle（空）可配置的旁观者加入标题。目前 MagmaCore 比赛运行时不会发出此项。
matchJoinAsSpectatorSubtitleNow 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 不会被替换。
matchFailedToStartNotEnoughPlayersMessageThis match requires $count players before starting - can't start yet!玩家数不足时使用 /exc start 显示。MagmaCore 运行时会将 $amount 占位符替换为最低玩家数，因此如果你希望该数值被替换，请使用 $amount 而不是 $count 来自定义此消息。
matchStartingMessage[Extractioncraft] Match starting!可配置的比赛开始聊天消息。目前 MagmaCore 比赛运行时不会发出此项（倒计时改为通过标题/副标题显示）。
matchStartingTitleMatch starting!3 秒倒计时期间显示的标题。$count 会被替换为剩余秒数。
matchStartingSubtitlein $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 文件。每个文件定义一个可游玩的地图配置。

键类型默认值描述
isEnabledBooleantrue此内容包是否算作已安装。它决定该条目在 /exc setup 中的颜色（true = 已安装/绿色，false = 已下载但未安装/黄色），设置菜单会替你切换它。它不会把该内容包从 /exc createMatch 中移除。
nameString（必填）内容包的显示名称（支持 & 颜色代码）
descriptionString list（必填）在设置菜单中显示的描述行
downloadLinkString（可选）在设置菜单中点击尚未下载的内容包时，于聊天中显示的 URL
versionInteger0内容版本号。Extractioncraft 的内容状态检查只区分未下载 / 已安装 / 未安装，因此该值目前不会与任何内容作比较。
folderNameString（必填）此内容包的原理图子文件夹名称
usesEliteMobsBooleanfalse声明该内容包使用 EliteMobs 内容的标志。运行时不强制执行。
usesBetterStructuresBooleanfalse声明该内容包使用 BetterStructures 内容的标志。运行时不强制执行。
usesFreeMinecraftModulesBooleanfalse声明该内容包使用 FreeMinecraftModels 内容的标志。运行时不强制执行。注意：源码中的 YAML 键拼写为 usesFreeMinecraftModules（带 "Modules"）。
betterStructuresModulesContainerNameString（可选）运行 /exc createMatch 时传给世界生成器的 BetterStructures 模块生成器配置文件名，例如 kobold_mines_module_generator_10.yml。真正决定生成哪张地图的就是这个键。
spectatableBooleanfalse可配置的旁观开关。Extractioncraft 不会把该值传入它所构建的对局实例，因此无论你在这里如何设置，运行时始终把对局视为不可观战，旁观者的加入请求都会被拒绝。
pvpEnabledBooleantrue对局期间是否启用 PvP。为 false 时，整个对局世界都会禁止友军伤害。
minPlayersInteger1开始对局所需的最低玩家数。低于该值时 /exc start 会拒绝执行；若在倒计时途中人数降到该值以下，倒计时会中止（并结束对局）。
maxPlayersInteger100对局允许的最大玩家数。全部五个预制的 Kobold Mines 内容包都将其覆盖为 8。当前版本没有注册加入命令，因此只有创建者会进入对局，这个上限永远不会被触及。
chestLootTablesString list[]箱子使用的战利品表，格式为 filename.yml:weight
barrelLootTablesString 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/ 中的任何文件都不匹配，启动时会记录一条警告，并会导致该内容包的容器搜刮功能失效。