琼恩地下城探险

地牢爬行 — 实例化地牢建造器

《地牢爬行》是一个 Forge 1.20.1 模组，允许服务器管理员和地图创作者直接在 Minecraft 内构建自定义、可重复游玩的地牢体验。

从现有建筑创建地牢、选择其边界、添加遭遇战、导入自定义 3D 怪物、设计 Boss 和攻击模式、创建任务、配置战利品，并将每个队伍传送到各自独立的临时地牢实例中。

原始地牢建筑保持不变。每次挑战都会在“地牢实例”维度中获得一份私有副本。

重要提示

《地牢爬行》目前处于积极开发阶段。在测试新版本之前，请备份重要世界。

命令和管理界面需要开启作弊模式或拥有管理员权限。

主要功能

可视化地牢编辑器

使用“地牢控制器”物品打开管理界面。

编辑器包含组织有序的页面，用于管理：

• 地牢地图
  - 自定义生物
  - 房间
  - 预设
  - 模型物品
  - 复杂攻击
  - 生物 AI
  - 地牢规则
  - 队伍

界面采用紫金配色设计，包含按钮、模型下拉菜单、实时预览以及主要编辑工具的快捷方式。

使用以下命令获取控制器：

/give @s dungeoncrawl:dungeon_controller

右键点击控制器即可打开编辑器。

地牢指南书

《地牢爬行》包含一本游戏内指南，逐步解释如何创建地牢。

指南包含：

• 九个教学页面
  - 带注释的界面图示
  - 真实的自定义深渊领主模型截图
  - 直达编辑器页面的按钮
  - 设置说明
  - 模型导入说明
  - 故障排除信息
  - 队伍和实例说明

使用以下物品合成指南：

• 1 本书
  - 1 个指南针
  - 1 个紫水晶碎片

你也可以使用以下命令获得：

/give @s dungeoncrawl:dungeon_guide

从现有建筑创建地牢

你可以将现有的 Minecraft 结构转变为可重复使用的地牢模板。

每个地牢可以包含：

• 唯一地牢 ID
  - 入口或大厅位置
  - 进入位置
  - 终点位置
  - 两个模板边界角
  - 时间限制
  - 敌人遭遇点
  - Boss 遭遇战
  - 任务要求
  - 自定义战利品
  - 自动化规则
  - 检查点

所选结构将成为地牢模板。

大型地牢支持

《地牢爬行》支持极其庞大的地牢模板。

当前安全限制：

• 每个模板最多 50,000,000 个方块
  - 宽度或深度最多 7,000 个方块

大型模板会逐步复制以减少服务器卡顿。

复制过程每 tick 处理最多 32,768 个方块，而清理过程每 tick 处理最多 65,536 个方块。进度每完成 10% 报告一次。

地牢计时器只有在私有副本加载完成后才会开始计时。

私有地牢实例

每次地牢挑战都会在专属维度中创建：

dungeoncrawl:dungeon_instances

当玩家或队伍开始地牢时：

1. 选定的模板被复制到私有位置。
   2. 地牢标记和遭遇点被转换到新位置。
   3. 玩家被传送到私有入口点。
   4. 复制完成后计时器开始。
   5. 完成、失败或超时后，私有副本将被移除。

原始地牢结构保持不变。

方块和方块实体（包括箱子等容器）都会被复制到实例中。

队伍支持

玩家可以组队一起进入地牢。

队伍功能包括：

• 队伍邀请
  - 接受邀请
  - 离开队伍
  - 解散队伍
  - 队长开始地牢
  - 共享地牢进度
  - 共享遭遇战
  - 共享任务进度
  - 共享检查点
  - 共享 Boss 状态
  - 共享完成结果

每个队伍都会获得一份独立的私有地牢副本。

如果任何队员在挑战中死亡，整个地牢挑战即宣告失败。幸存的玩家会立即被传送回，而死亡的玩家将在重生后被传送回。

自定义敌人遭遇战

在地牢中放置敌人出生点并配置：

• 生物档案
  - 敌人数目
  - 激活半径
  - 生命值
  - 伤害
  - 移动速度
  - 护甲
  - 攻击距离
  - 攻击冷却
  - 碰撞箱宽度
  - 碰撞箱高度
  - AI 行为
  - 攻击动画
  - 自定义掉落物

当玩家接近遭遇区域时，敌人就会生成。

自定义生物 AI

自定义生物档案支持多种行为模式：

• 侵略性
  - 守卫
  - 被动
  - 固定不动
  - 逃离

这些模式允许创作者构建普通敌人、防御守卫、环境角色、固定障碍以及躲避玩家的生物。

自定义碰撞箱

导入的怪物不受限于标准僵尸大小的碰撞箱。

每个生物档案都可以配置：

• 碰撞箱宽度
  - 碰撞箱高度
  - 攻击距离
  - 模型缩放

这使创建小型生物、大型怪物和超大型 Boss 成为可能。

复杂攻击模式

自定义生物可以使用多步骤攻击模式。

每个攻击步骤都可以配置：

• 动画
  - 蓄力时间
  - 伤害倍率
  - 攻击距离
  - 向前突进
  - 范围效果半径

攻击模式可以组合多个步骤来创建各种技能，例如：

• 快速连击
  - 重型延迟打击
  - 突进攻击
  - 广域攻击
  - Boss 攻击序列
  - 动画斩击
  - 多阶段技能

自定义攻击动画

BBMODEL 怪物可以使用 Blockbench 中创建的动画。

可以为攻击选择动画，让模型的四肢、身体、武器和其他骨骼在技能释放时运动。

预览动画速度已调整，方便更清楚地检查肢体运动。

OBJ 模型导入

《地牢爬行》可以为敌人和模型物品加载自定义 OBJ 模型。

将模型文件夹放置在：

<Minecraft 实例>/dungeoncrawl/models/<模型名称>/

将模型和纹理文件放在该文件夹内，然后运行：

/dungeon reload

你可以从模型下拉菜单中选择成功加载的模型，而不必手动输入所有资源路径。

Blockbench BBMODEL 支持

《地牢爬行》支持 Blockbench 导出或保存的 .bbmodel 文件。

BBMODEL 支持包括：

• 模型几何
  - 骨骼层级
  - 枢轴点
  - UV 信息
  - 内嵌或附带的纹理
  - GeckoLib 动画集成
  - 实时 3D 预览
  - 动画生物渲染

将 BBMODEL 及其所需纹理放置在以下目录下的文件夹中：

<Minecraft 实例>/dungeoncrawl/models/<模型名称>/

然后重新加载《地牢爬行》。

对于多人游戏，每个需要看到导入模型的玩家都应拥有相同的外部模型文件夹。

实时 3D 模型预览

生物和物品编辑器包含实时 3D 预览。

该预览有助于验证：

• 纹理放置
  - 模型朝向
  - 缩放
  - 动画
  - 模型选择
  - 导入的几何体

这让创作者可以在将模型生成到地牢之前进行检查。

模型下拉菜单

成功加载的外部模型会出现在下拉菜单中。

这免去了手动搜索或反复输入模型路径的麻烦。

生物模型和物品模型是分开的，因此模型物品不会出现在生物选择列表中。

自定义模型物品

导入的模型还可以转化为可使用的 Minecraft 物品。

支持的物品种类包括：

• 通用物品
  - 武器
  - 盾牌
  - 头盔
  - 胸甲
  - 护腿
  - 靴子

模型物品可以：

• 手持
  - 丢弃
  - 存放在物品栏中
  - 通过编辑器给予
  - 用作武器
  - 用作盾牌
  - 作为护甲装备

该模组带有示例模型物品，例如：

• 桶骑士
  - 干草叉
  - 木桶
  - 木轮
  - 格挡轮

Boss 遭遇战

每个地牢都可以配置一场 Boss 遭遇战。

Boss 可以使用：

• 导入的 OBJ 或 BBMODEL 外观
  - 自定义生命值
  - 自定义伤害
  - 自定义护甲
  - 自定义移动速度
  - 大型碰撞箱
  - 扩展攻击距离
  - 自定义攻击冷却
  - 复杂攻击模式
  - 自定义动画
  - 自定义战利品
  - AI 行为设置

Boss 可以放置在地牢尽头，并与任务或自动化规则相关联。

地牢任务

地牢可以要求玩家在完成之前达成特定目标。

任务设置包括：

• 所需生物档案
  - 所需击杀数
  - 共享队伍进度
  - 自动化条件支持

任务完成可以解锁后续事件、检查点、Boss、消息或地牢完成条件。

自定义战利品

自定义敌人和 Boss 可以拥有自己的掉落物配置。

这允许地牢创作者决定敌人提供什么奖励，并构建地牢专属的进展体系。

地牢自动化

《地牢爬行》包含一个“触发器 → 条件 → 功能”的自动化系统。

自动化规则与地牢数据一起持久化存储。

可用的触发器包括：

• 进入区域
  - 生物被击杀
  - 方块被交互
  - 方块被破坏
  - 地牢开始

可用的条件包括：

• 始终成立
  - 任务已完成
  - 达到最低击杀数
  - 达到最低玩家人数
  - 剩余时间低于设定值

可用的功能包括：

• 显示消息
  - 生成自定义生物
  - 设置检查点
  - 将玩家传送到检查点
  - 播放音效
  - 执行命令
  - 完成地牢

单个自动化规则可以执行多个功能，允许创作者构建脚本化的地牢序列，而无需编写 Java 代码。

示例包括：

• 进入房间并关闭出口。
  - 生成数波敌人。
  - 等待任务击杀数达成。
  - 显示 Boss 消息。
  - 生成 Boss。
  - Boss 死亡后设置检查点。
  - 当玩家到达出口时完成地牢。

编辑模式

编辑模式让创作者可以在不意外开始地牢的情况下进行编辑。

使用：

/dungeon edit <地牢ID>

使用以下命令关闭：

/dungeon editoff

编辑模式激活时，特殊标记会显示重要的地牢位置。

标记只对正在编辑地牢的玩家可见。

标记类型包括：

• 地牢入口的传送门标记
  - 进入点的绿色村民标记
  - 终点位置的烟花标记
  - 敌人遭遇战的火焰标记
  - Boss 的灵魂火焰标记
  - 自动化位置的经验附魔标记

查看标记附近会显示一个快捷栏标签，说明其代表的含义。

地牢列表

地图页面显示所有已创建的地牢。

创作者可以查看他们的地牢 ID，并选择要编辑的地牢，而不必记住每个名称。

对应的命令版本为：

/dungeon list

基本设置

一个标准的地牢设置遵循以下步骤：

1. 在主世界建造地牢。
   2. 创建地牢 ID。
   3. 为地牢启用编辑模式。
   4. 设置入口位置。
   5. 设置地牢进入点位置。
   6. 设置终点位置。
   7. 选择模板角一。
   8. 选择模板角二。
   9. 设置时间限制。
   10. 添加敌人遭遇点。
   11. 配置任务。
   12. 配置 Boss。
   13. 添加战利品和自动化规则。
   14. 保存地牢。
   15. 开始测试运行。
   16. 完成后关闭编辑模式。

常用命令

所有《地牢爬行》管理命令都需要开启作弊模式或拥有管理员权限。

主要命令：

• /dungeon create <ID>
  - /dungeon list
  - /dungeon delete <ID>
  - /dungeon edit <ID>
  - /dungeon editoff
  - /dungeon setopening <ID>
  - /dungeon setentry <ID>
  - /dungeon setfinish <ID>
  - /dungeon setcorner1 <ID>
  - /dungeon setcorner2 <ID>
  - /dungeon time <ID> <秒>
  - /dungeon addspawn ...
  - /dungeon quest ...
  - /dungeon boss ...
  - /dungeon start <ID>
  - /dungeon save
  - /dungeon reload

队伍命令：

• /dungeon party invite <玩家>
  - /dungeon party accept <玩家>
  - /dungeon party leave

自定义生物工具：

• /dungeon mob create ...
  - /dungeon mob spawn ...
  - /dungeon mob stats ...
  - /dungeon mob hitbox ...
  - /dungeon mob attack ...
  - /dungeon mob behavior ...
  - /dungeon mob model ...
  - /dungeon mob pattern ...
  - /dungeon mob drop ...

模型物品工具：

• /dungeon item give ...

自动化工具：

• /dungeon automation create ...
  - /dungeon automation condition ...
  - /dungeon automation function ...
  - /dungeon automation remove ...

对于大多数设置任务，推荐使用游戏内管理 GUI。

要求

• Minecraft 1.20.1
  - Minecraft Forge 47 或更高版本
  - GeckoLib 4.4.9
  - Java 17

GeckoLib 是必需依赖，必须安装。

《地牢爬行》必须同时安装在服务器和连接的客户端上。

安装

1. 为 Minecraft 1.20.1 安装 Minecraft Forge。
   2. 安装 GeckoLib 4.4.9。
   3. 将《地牢爬行》的 JAR 文件放入 mods 文件夹。
   4. 启动 Minecraft。
   5. 创建或打开一个已开启作弊的世界。
   6. 给自己一个地牢控制器或地牢指南。
   7. 开始创建你的第一个地牢。

兼容性

《地牢爬行》是一个原创的 Forge 模组，灵感来自可视化和脚本化的地牢构建系统。

它不需要 CustomNPCs、MythicMobs 或 MythicDungeons。

除非自定义模型资源随《地牢爬行》或其示例内容一同提供，否则需单独提供。

当前版本

版本：0.2.0

Minecraft：1.20.1

模组加载器：Forge

许可证：MIT

作者：V-Fusion