跳到主要内容

Extractioncraft 安装设置

开发版本兼容性

本节描述 Extractioncraft 的 1.0-SNAPSHOT 源代码，并不代表已验证的发布版本组合。当前源码针对 BetterStructures 2.7.6 和 EliteMobs 10.9.7 编译，并直接调用它们的 API。向玩家开放服务器前，请使用经过组合测试且彼此兼容的构建；仅安装最新的配套插件无法证明兼容性。

需求​

  • 插件的目标字节码版本为 Java 21；请使用所选服务器版本要求的 Java 运行环境
  • 兼容的 Paper/Spigot 服务器：描述文件声明 1.21.4，但当前构建使用 Spigot API 26.3-R0.1-SNAPSHOT。这些值不能证明已测试的服务器版本范围
  • BetterStructures（声明为软依赖，启动必需）
  • EliteMobs（声明为软依赖，启动必需）
  • FreeMinecraftModels（声明为软依赖，启动必需）
  • WorldEdit 或 FastAsyncWorldEdit，BetterStructures 用它来生成地图

启动期间，Extractioncraft 会等待 BetterStructures、EliteMobs 和 FreeMinecraftModels 完成加载，然后给它们最多 5 分钟来重载刚刚导入的内容。如果其中任何一个缺失、加载失败，或超过这段时间仍在重载，Extractioncraft 会记录 ExtractionCraft initialization failed，并且不会注册它的命令。

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_equipment_loot_table.yml 和 kobold_mines_supplies_loot_table.yml）随可下载的内容包一起提供，而不是随插件 jar 提供。

内容包还携带地图数据，这些数据存放在配套插件中：模块生成器、模块、组件和生成池进入 BetterStructures，Boss 和物品进入 EliteMobs，模型进入 FreeMinecraftModels。当 BetterStructures 加载了内容包 betterStructuresModulesContainerName 中指定的模块生成器后，该内容包在 /exc setup 中就算作已下载。

  1. 安装 Extractioncraft 以及 BetterStructures、EliteMobs、FreeMinecraftModels 和 WorldEdit（或 FastAsyncWorldEdit）。启动服务器一次。
  2. 运行 /exc initialize 打开首次设置菜单。当 WorldEdit 和 FastAsyncWorldEdit 都未启用时，其状态面板为红色；当没有任何内容包既已启用又有已加载的模块生成器支撑时，为黄色；一旦有内容包就绪，则为绿色。点击该面板可查看后续步骤。玩家头颅链接到 nightbreak.io 上的 Extractioncraft 页面和 Discord。
  3. 从 nightbreak.io 下载内容包。
  4. 将下载的 ZIP 放入 plugins/Extractioncraft/imports/ 文件夹。
  5. 运行 /exc reload 或重启服务器。导入器会将 ZIP 解压到 Extractioncraft、BetterStructures、EliteMobs 和 FreeMinecraftModels 的文件夹中。随后 Extractioncraft 会重载 BetterStructures（如果内容包添加了 EliteMobs 内容，也会重载 EliteMobs），并等待配套插件完成加载。
  6. 运行 /exc setup 浏览和管理内容包。每个内容包会显示一个彩色状态（绿色 = 已安装，黄色 = 已下载但未安装，红色 = 未下载）。点击绿色内容包会将其禁用，点击黄色内容包会将其启用，点击红色内容包则会输出其下载链接，并说明要把文件放入 imports 文件夹后运行 /exc reload。设置菜单还包含一个 Recommended Plugins（推荐插件）条目和一个信息按钮（玩家头颅），其中含有指向 wiki、Discord、你的账户令牌页面、/extractioncraft recommendedplugins 和 /nightbreak plugins 的链接。

内容包无法在游戏内下载；请使用下载链接和 imports 文件夹。

MagmaCore 共享设置功能​

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

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

预制内容​

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

内容包配置文件名等级最大玩家数
Kobold Mines 10kobold_mines_10.yml108
Kobold Mines 20kobold_mines_20.yml208
Kobold Mines 30kobold_mines_30.yml308
Kobold Mines 40kobold_mines_40.yml408
Kobold Mines 50kobold_mines_50.yml508

等级即内容包的 contentLevel，用于容器战利品。内容包生成池中的 Boss 也以相同等级生成。每张地图都有 Normal、Hard 和 Mythic 区域，最难的区域位于中心；参见怪物击杀战利品。

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

开始一场对局​

安装好内容后：

  1. 运行 /exc createMatch <contentPackage.yml>（例如 /exc createMatch kobold_mines_10.yml）。该参数会 Tab 补全启动时加载的每个内容包。如果内容包已禁用，或其模块生成器缺失、已禁用、不是世界生成器，或没有已安装的起始模块，该命令会拒绝执行。
  2. 插件会使用该内容包的 betterStructuresModulesContainerName，通过 BetterStructures 生成实例化世界。生成不是瞬时的，会显示一条进度 Boss 血条；准备就绪后你会被传送到新世界中的一个随机出生点。如果生成耗时超过 15 分钟、你断开连接，或你运行了 /exc leave，生成都会被取消。
  3. Extractioncraft 没有注册加入命令，因此对局中只有创建它的那名玩家。一旦满足 minPlayers（默认为 1），对局中的任何玩家都可以运行 /exc start。
  4. 要随时离开对局，运行 /exc leave（或 /exc quit）。对局开始后离开会被视为撤离失败；参见对局流程。