DragonMineZ – Breakthrough Flight

DragonMineZ – 突破飞行

💥 别再绕着山飞了。直接穿过去。

DragonMineZ – 突破飞行是适用于 DragonMineZ 2.1.3 的独立附属模组，可将高速飞行变成真正的《龙珠》风格移动能力。

你不再会被以下地形挡住：

• 山脉
• 墙壁
• 建筑
• 洞穴
• 地形
• 地下区域

而是可以在飞行时直接冲破它们。

本模组旨在让 DragonMineZ 的高速飞行更具力量感与电影感。

当你全速前进时，世界就该为你让路。

---

⚡ 默认激活方式

默认情况下，只有同时满足以下条件时，突破飞行才会激活：

搜寻飞行 + 冲刺 + 气蓄力

三个条件必须同时生效。

因此，普通的搜寻飞行不会受到影响。

只有主动进入全速突破状态时，你才会开始撞穿地形。

默认行为：

仅搜寻飞行
❌ 不会突破

搜寻飞行 + 冲刺
❌ 不会突破

搜寻飞行 + 气蓄力
❌ 不会突破

搜寻飞行 + 冲刺 + 气蓄力
✅ 突破已激活

---

🧱 撞穿世界

突破飞行激活时，本附属模组会自动清除飞行路径上的普通方块，形成一条隧道。

你可以穿过：

• 石头
• 泥土
• 深板岩
• 山脉
• 洞穴墙壁
• 建筑
• 地板
• 天花板
• 地下地形

隧道会沿着你实际的移动方向延伸，而不是只在玩家周围破坏固定大小的立方区域。

---

⛏️ 不会刷出一地掉落物

默认情况下：

被破坏的方块不会掉落物品。

这是有意为之。

否则，以全速穿过一座山可能会产生数百甚至数千个物品实体，造成不必要的延迟。

地形会被破坏，但不会留下长长一串方块掉落物。

服务器可以按需启用掉落物。

---

🛡️ 基岩与受保护方块安然无恙

突破飞行威力强大，但并非毫无限制。

基岩始终受到保护。

本附属模组还会强制保护以下特殊方块：

• 基岩
• 屏障
• 末地传送门
• 末地传送门框架
• 末地折跃门
• 下界传送门
• 命令方块
• 结构方块
• 结构空位
• 拼图方块

突破飞行无法破坏这些方块。

---

🔒 领地与受保护区域

突破飞行遵循服务器的常规保护检查。

移除方块前，本附属模组会检查以下内容：

• 世界边界
• 出生点保护
• 原版交互限制
• 冒险模式／旁观模式限制
• Forge 方块破坏事件
• 实体破坏权限
• 受保护的方块实体
• 基于事件的领地与区域保护

如果玩家通常无权破坏某个方块，突破飞行就不应绕过该保护。

本模组并不会刻意把飞行变成破坏他人建筑的工具。

---

🚫 不会穿墙

突破飞行不会赋予玩家穿墙能力。

也就是说：

• 碰撞仍然存在
• 玩家仍有真实的碰撞箱
• 受保护的方块仍会挡住你
• 基岩仍会挡住你
• 领地保护仍可拦住你

本附属模组会从你的路径上移除允许破坏的方块。

它不会让你直接穿过一切。

---

✈️ 搜寻飞行保持激活</numerusform

1.0.3 中最大的改进之一是地面接触的处理方式。

通常情况下，当你的双脚触地时，DragonMineZ 会自动禁用搜索飞行。

这在尝试穿越以下情况时会产生问题：

• 地板
• 狭窄隧道
• 洞穴
• 两格高的空间
• 地下地形

突破飞行会在该模式激活时改变这一行为。

只要你仍然按住所需的突破输入：

触地不会将你踢出搜索飞行。

你可以：

• 贴着地面滑行
• 撞到天花板
• 暂时卡在地形上
• 贴着基岩站立
• 因碰撞而完全无法移动

而搜索飞行仍保持激活。

一旦你不再满足突破要求，正常的 DragonMineZ 着陆行为就会恢复。

---

🧠 智能地面保护

突破飞行并不是简单地禁用 DragonMineZ 的整个飞行关闭系统。

它专门阻止自动的着陆/地面接触关闭，前提是突破处于激活状态。

手动切换飞行仍然有效。

其他合理的关闭条件保持不变。

所以你仍然可以随时有意停止飞行。

---

🎮 个人 X 菜单开关

每位玩家都可以选择是否使用突破飞行。

打开：

X → 移动 → 飞行 → 突破飞行

并切换它：

开 / 关

这只会改变你自己的个人设置。

它不会改变服务器规则。

新玩家默认启用突破飞行。

---

⚙️ 完全可配置

服主可以完全控制突破飞行的激活方式。

你可以配置：

• 搜索飞行支持
• 战斗飞行支持
• 疾跑要求
• 气充能要求
• 最低飞行速度
• 隧道宽度
• 隧道高度
• 方块掉落
• 粒子效果
• 音效
• 每 tick 最大破坏方块数
• 个人玩家开关
• BlockEntity 破坏
• 保护区处理

---

🔥 随心所欲地使用

默认激活条件为：

搜索飞行 + 疾跑 + 气充能

但服主可以更改它。

例如：

搜索飞行 + 疾跑

关闭气充能要求。

仅搜索飞行

同时关闭疾跑和气的要求。

战斗飞行

启用战斗飞行支持。

基于速度的突破

设置最低飞行速度。

这使系统足够灵活，以适应不同的整合包和服务器平衡。

---

🛠️ 命令

玩家可以通过以下方式控制自己的突破设置：

/breakthrough on

/breakthrough off

/breakthrough status

服务器管理员可以通过以下命令控制全局行为：

/breakthrough global on|off

/breakthrough searchflight on|off

/breakthrough combatflight on|off

/breakthrough requiresprint on|off

/breakthrough requireki on|off

/breakthrough minspeed <value>

/breakthrough width <value>

/breakthrough height <value>

/breakthrough drops on|off

/breakthrough particles on|off

/breakthrough sounds on|off

/breakthrough reload

这些命令更新的是同一个活动服务器配置，而不是维护一套单独的临时规则集。

---

📐 智能高速扫掠

在高速下，仅仅检查玩家正前方的方块是不够的。

玩家可能会在一个游戏刻内穿过多个方块。

因此，Breakthrough Flight 会检查不同位置之间的移动路径，并沿着该路径处理飞行通道。

这样可以避免玩家已经穿过多个方块后，附加模组才发现障碍物的情况。

系统还设有性能限制，以避免扫描过大的世界区域。

---

🚀 默认 3×3 隧道

默认的突破通道大约为：

3 × 3 个方块

这样玩家就有足够的空间穿过地形，不会总是卡在拐角处。

服务器可以更改宽度和高度。

---

📦 性能保护

默认全局上限为：

每个服务器游戏刻最多破坏 64 个方块

附加模组还会限制：

• 移动路段长度
• 扫描范围候选数
• 候选检查次数
• 区块交互

它不会为了破坏地形而生成区块。

这能让 Breakthrough Flight 在多人服务器上运行得更加安全。

---

🟣 与 Noea 兼容

Noea 为可选项。

Breakthrough Flight 已使用与 DragonMineZ 2.1.3 搭配的 Noea 版本进行测试。

附加模组使用 DragonMineZ 原生的飞行状态，而不会替换 Noea 的系统。

测试情况包括：

• 使用 Noea
• 不使用 Noea
• 集成服务器
• 专用服务器

---

🌲 与采矿模组兼容

已针对以下模组加入特殊兼容处理：

FallingTree

以及

Vein Mining

使用 Breakthrough Flight 时，这些模组不会在预期飞行通道之外触发额外的连锁采矿行为。

正常采矿不受影响。

---

✅ 测试

最终的 1.0.3 版本已使用真实的 Minecraft 客户端和服务器进程进行测试。

已验证的行为包括：

• 激活 Search Flight + Sprint + Ki
• 个人 ON/OFF 开关
• 全局 ON/OFF
• 两格高的隧道
• 反复接触地面
• 反复接触天花板
• 长时间静止不动
• 长时间onGround = true
• 向下突破
• 斜向突破
• 墙壁
• 地板
• 天花板
• 基岩保护
• 出生点保护
• Forge BreakEvent 保护
• 无穿墙
• 手动切换 Flight
• Breakthrough 保持启用时，Search Flight 仍持续生效
• 松开所需按键后，Search Flight 恢复正常行为
• 集成服务器
• 专用服务器
• 使用 Noea
• 不使用 Noea

最终测试中，Search Flight 在数百个游戏刻的碰撞和接触地面过程中始终保持启用。最终报告

---

📦 要求

Minecraft： 1.20.1
Forge： 47.4.x
DragonMineZ： 2.1.3
Noea：可选

---

📥 安装

在以下环境中安装相同版本的附加模组：

客户端 + 服务器

必需：

1. Minecraft 1.20.1
2. Forge 47.4.x
3. DragonMineZ 2.1.3
4. DragonMineZ – Breakthrough Flight

将其放入：

DragonMineZ-Breakthrough-Flight-1.0.3.jar

mods文件夹内。

---

⚠️ 兼容性说明

此版本已专门针对DragonMineZ 2.1.3进行验证。

不保证与未知的未来版本 DragonMineZ 兼容，因为内部类和飞行逻辑可能会发生变化。

兼容性声明基于 Forge BreakEvent 和常规保护钩子。使用完全自定义系统的保护类模组可能需要额外的兼容处理。