史诗任务地下城

EpicQuest Dungeoning 允许整合包作者和服务器管理员通过配置文件加载自定义地牢结构，并通过简单的传送门流程将玩家送入其中——无需编写任何代码。

使用 WorldEdit 或结构方块导出建筑，放入文件夹，编辑一个 JSON 文件，玩家即可选择地牢，踏上传送门方块，进行探索，结束后返回出生点。

特性

• 地牢选择 GUI —— 预览图片、描述、确认对话框，以及每位玩家的地牢选择。
• 可配置传送门方块 —— 踏上任意方块 ID 即可进入所选地牢。
• 共享虚空维度 —— 所有地牢都位于 epicquest_dungeoning:dungeons 维度中，沿 X 轴间隔分布，确保大型原理图不会重叠。
• 原理图支持 —— 支持原版结构 .nbt 文件和 WorldEdit Sponge .schem（v1/v2/v3 版本）文件。
• 返回出生点 —— 物品栏按钮可将你传送回床/重生锚/世界出生点（而非下界传送门）。
• 传送充能 —— 进入或返回时伴有粒子和音效；充能时间可配置；移动或受到伤害会打断；创造模式可跳过。
• 实时配置重载 —— 编辑 dungeons.json 后，打开 /dungeon select 即可应用更改，无需完全重启服务器。
• 重载进度条 —— 在选择、重载或重置地牢时，显示逐步骤的实时加载覆盖层。
• 重置所有地牢 —— 从磁盘重新加载所有原理图（冷却时间限制；创造模式可跳过）。
• 结构保护 —— 可选择的，在地牢内禁止破坏/放置方块。
• 摔落伤害免疫 —— 可选择的，从地牢返回后短时间摔落伤害免疫。
• 一次性试炼刷怪笼 —— 放置在原理图中的试炼刷怪笼在地牢每次重置时只触发一次。

玩家流程

1. 运行 /dungeon select（或 /dungeons select）并选择一个地牢。
2. 站在已配置的传送门方块上，等待传送充能完成。
3. 探索地牢。使用物品栏中的返回按钮返回出生点（也有充能过程）。
4. 管理员可以在选择界面上使用 重置所有地牢 来清除并重新加载所有原理图。

作者设置

首次启动时，模组会创建以下目录：

config/epicquest_dungeoning/
  dungeons.json
  schematics/
  images/

1. 将 .nbt 或 .schem 文件放入 schematics/ 文件夹。
2. 在 dungeons.json 中添加地牢条目（ID、名称、描述、原理图文件名、出生点）。
3. 可选：将预览 PNG 图片添加到 images/ 文件夹，并使用 "image": "preview.png" 引用它们。
4. 运行 /dungeon select 或 /dungeon reload 加载更改——更新列表无需重启。

示例地牢条目

出生点坐标 默认是相对于每个地牢的放置原点（第1个地牢在 X=0，第2个在 X=10000，依此类推）。设置 "absolute_position": true 以直接使用世界坐标。

配置 (dungeons.json)

字段	描述
teleport_block	入口传送门的方块 ID（例如 minecraft:emerald_block）
return_button_item	物品栏返回按钮的物品图标
return_cooldown_minutes	两次返回之间的冷却时间（默认20分钟）
reset_cooldown_minutes	两次全局重置之间的冷却时间（默认60分钟）
teleport_charge_seconds	进入/返回传送前的充能持续时间（0 = 立即；创造模式可跳过）
protect_structures	防止在地牢内破坏/放置方块
return_fall_damage_immunity	返回后拥有5秒的摔落伤害免疫

命令

• /dungeon select —— 打开地牢选择器（带进度条地重载配置和原理图）。
• /dungeon return —— 从地牢内返回出生点。
• /dungeon list —— 显示当前激活的地牢 ID 和正在使用的配置文件路径。
• /dungeon reload —— （管理员） 重载配置，清除地牢维度中的非玩家实体，并预加载原理图。

默认情况下，每个地牢的 spawn 使用 相对坐标（相对于原理图放置原点）。设置 "absolute_position": true 以使用原始世界坐标。出生点的 Y 坐标会尊重你的配置值（仅当该位置无法站立时，会有一个安全的备选方案）。

需求

• Minecraft: 1.21.1
• 加载器: NeoForge

专为那些希望拥有实例化地牢内容，但又不想编写自定义维度代码的冒险整合包和 RPG 服务器而设计。