Extractioncraft 安装设置

需求

• Java 21
• 基于 1.21.4 API 的 Paper/Spigot 兼容服务器
• BetterStructures（软依赖，预制内容需要）
• EliteMobs（软依赖，预制内容需要）
• FreeMinecraftModels（软依赖，预制内容需要）

Extractioncraft 创建的内容

启动时，Extractioncraft 会初始化以下路径：

plugins/Extractioncraft/config.yml
plugins/Extractioncraft/messaging.yml
plugins/Extractioncraft/content_packages/
plugins/Extractioncraft/loot_pools/
plugins/Extractioncraft/loot_tables/
plugins/Extractioncraft/imports/

content_packages/ 预先填充了五个预制的 Kobold Mines 配置文件。loot_pools/ 和 loot_tables/ 初始为空—— 预制内容包所引用的战利品表（kobold_mines_chest_high_loot_table_10.yml 等）随可下载的内容包一起提供，而不是随插件 jar 提供。

schematics/ 文件夹在启动时不会被创建。它会在安装内容后出现，保存每个内容包的地图数据，存放于以该内容包 folderName 命名的子文件夹下（例如 schematics/kobold_mines_10/）。Extractioncraft 会依据该子文件夹是否存在，来判断某个内容包在 /exc setup 中是否算作已下载。

推荐的首次设置流程

1. 安装 Extractioncraft 以及 BetterStructures、EliteMobs、FreeMinecraftModels 和 WorldEdit（或 FastAsyncWorldEdit）。启动服务器一次。
2. 运行 /exc initialize 打开首次设置菜单。它会检查 WorldEdit（或 FastAsyncWorldEdit）是否已安装以及至少一个 BetterStructures 原理图配置是否可用，然后提供一个"完成首次设置"按钮。由于这些地图属于 BetterStructures 内容，该菜单的帮助链接会指向 BetterStructures 设置页面和共享 Discord。
3. 从 nightbreak.io 下载内容包。
4. 将下载的内容放入 plugins/Extractioncraft/imports/ 文件夹。插件将在下次启动时解压支持的归档文件。
5. 运行 /exc reload 或重启服务器。
6. 运行 /exc setup 浏览和管理已安装的内容包。每个内容包会显示一个彩色状态（绿色 = 已安装，黄色 = 已下载但未安装，红色 = 未下载）以及一个点击操作。设置菜单还包含一个 Recommended Plugins（推荐插件）条目和一个信息按钮（玩家头颅），其中含有指向 wiki、Discord、你的账户令牌页面以及更新命令的链接。

MagmaCore 共享设置功能

由于 MagmaCore 已内置于 Extractioncraft 中，插件随附了共享的 Nightbreak 设置工具：

• 推荐插件 — /exc recommendedplugins（或 /exc setup 内的条目）列出与 Extractioncraft 搭配良好的配套插件，并显示哪些已安装。
• 账户令牌 / 授权内容 — /nightbreaklogin 注册你的 nightbreak.io 账户令牌，使服务器能够在游戏内下载授权内容。
• 插件目录 — /nightbreak plugins 打开可浏览的 MagmaGuy 其他插件目录。

预制内容

Extractioncraft 附带以下预制内容包的配置（Kobold Mines 系列）：

内容包	配置文件名	EliteMobs 等级范围	最大玩家数
Kobold Mines 10	kobold_mines_10.yml	0-10	8
Kobold Mines 20	kobold_mines_20.yml	11-20	8
Kobold Mines 30	kobold_mines_30.yml	21-30	8
Kobold Mines 40	kobold_mines_40.yml	31-40	8
Kobold Mines 50	kobold_mines_50.yml	41-50	8

所有预制内容包都使用 BetterStructures、FreeMinecraftModels 和 EliteMobs。默认启用 PvP。地图数据必须从设置菜单中显示的内容链接单独下载。

开始一场对局

安装好内容后：

1. 运行 /exc createMatch <contentPackage.yml>（例如 /exc createMatch kobold_mines_10.yml）。该参数会 Tab 补全可用的内容包文件名 —— 其中也包括当前标记为未安装的内容包，因此选错时会在世界生成阶段失败，而不是在命令阶段失败。
2. 插件会使用该内容包的 betterStructuresModulesContainerName，通过 BetterStructures 异步生成实例化世界。生成不是瞬时的；准备就绪后你会被传送到新世界中的一个随机出生点。
3. 当前版本没有注册加入命令，因此对局中只有创建它的那名玩家 —— 内容包的 maxPlayers（所有预制内容包均为 8）虽被共享对局运行时读取，但没有任何途径能触达它。一旦满足 minPlayers（默认为 1），对局中的任何玩家都可以运行 /exc start。
4. 要随时离开一场对局，运行 /exc leave（或 /exc quit）。在进行中的对局里未撤离就离开，默认会销毁你的背包 —— 参见对局流程。