ITM的空中冲刺

Aerial Dash

添加响应式空中移动，无需额外按键绑定。

Aerial Dash 为 Minecraft 添加了一个可配置的空中冲刺能力。在空中时再次按下现有的跳跃键，即可朝你注视的方向冲刺。

该机制使用即时客户端预测以获得响应式操控，同时服务器会独立验证并应用每一次冲刺。

功能特性

• 使用 Minecraft 现有的跳跃绑定 - 无需额外按键。
• 默认拥有一次空中冲刺，落地、入水或接触可攀爬方块时恢复。
• 水平冲刺距离默认随最终移动速度缩放。
• 独立的水平和垂直缩放选项。
• 可配置的饥饿值、疲劳度、充能、音效、粒子和摔落保护设置。
• 服务器控制的游戏玩法设置与连接的客户端同步。
• 支持 Forge、NeoForge 和 Fabric。

操作方式

Aerial Dash 使用 Minecraft 常规的跳跃绑定 - 默认为空格键 - 支持键盘和鼠标按键重绑定。

• 在空中按下跳跃键以进行冲刺。
• 普通跳跃后，松开并再次按下跳跃键以进行冲刺。
• 从水中或可攀爬方块快速连按两次跳跃键以直接冲刺。
• 按住跳跃键不会重复触发冲刺。
• 从地面进行的普通跳跃保持不变。

水体和可攀爬方块的双击时间窗口可在客户端配置中调整。

冲刺次数与恢复

默认情况下，每位玩家拥有一次空中冲刺。

冲刺次数通过接触以下物体恢复：

• 地面
• 水或其他受支持的可游泳流体
• 梯子、藤蔓和其他可攀爬方块

支持直接从水中或可攀爬方块冲刺。这些状态下使用快速双击，以便该机制不干扰正常的游泳和攀爬。

持续接触表面时，使用可配置的充能延迟以防止冲刺滥用。也可以禁用基于表面的恢复，转而使用基于计时器的冷却。

冲刺激活还可以要求最低食物水平，并消耗可配置的疲劳度。

速度相关的冲刺距离

水平冲刺强度默认随玩家最终的 MOVEMENT_SPEED 属性缩放。

这意味着：

• 速度效果会增加水平冲刺距离。
• 缓慢效果会减少它。
• 来自其他模组的基于属性的移动加成或惩罚会自然与冲刺相互作用。

垂直缩放是独立配置的，默认禁用，以保持垂直移动的可预测性。水平和垂直缩放可以独立启用、禁用和限制。

基于时机的摔落保护

Aerial Dash 可以使普通探索更加宽容，而不会让所有大幅度坠落都变得无害。

三个设置独立控制摔落保护：

• 安全摔落距离： 默认从原版的 3 格增加到 6 格。
• 冲刺时重置摔落距离： 在服务器批准冲刺时清除累积的摔落距离。
• 完整落地保护： 可选地取消冲刺后首次落地时的全部摔落伤害。

完整落地保护默认为禁用。使用默认设置时，要避免长距离坠落伤害，需要在接近地面时保存冲刺机会。

音效与粒子

服务器可以配置：

• 冲刺音效及其音量
• 音效的最小和最大音高
• 粒子类型和数量
• 粒子扩散和速度
• 是否产生冲刺音效或粒子

每个客户端可以独立隐藏 Aerial Dash 的音效或粒子，而不影响 Minecraft 或其他模组产生的效果。

无效或不支持的效果 ID 会安全地回退到默认的幻翼振翅音效和云粒子。

配置

游戏玩法设置由服务器控制，并与客户端同步以确保正确的移动预测。

服务器配置包括：

• 全局启用开关
• 冲刺强度和垂直提升
• 水平和垂直移动速度缩放
• 参考速度和缩放限制
• 冲刺次数
• 地面、水和可攀爬方块的充能规则
• 表面充能延迟或计时器冷却
• 食物要求和疲劳度消耗
• 安全摔落距离
• 摔落距离重置
• 可选的完整落地保护
• 音效和粒子设置

客户端配置包括：

• 水/可攀爬方块双击窗口
• 本地冲刺音效开关
• 本地冲刺粒子开关
• 抑制受保护落地音效的选项

配置文件在首次启动后自动生成。手动编辑配置文件后，建议重新启动相关的客户端或服务器。

安装与要求

支持的平台：

• Minecraft 1.20.1 - Forge
• Minecraft 1.21.1 - NeoForge
• Minecraft 26.1.2 - NeoForge
• Minecraft 26.1.2 - Fabric

安装与你的确切 Minecraft 版本和模组加载器匹配的文件。

该模组必须同时安装在客户端和服务器上。在单人游戏中，将其安装到常规的客户端模组文件夹即可覆盖两端。

Fabric 安装还需要 Fabric API。

兼容性

Aerial Dash 使用标准的移动属性和平台 API。

它旨在与以下内容自然配合：

• 速度和缓慢效果
• 基于属性的移动修饰符
• 模组添加的可攀爬方块
• 受支持的可游泳流体

替换相同移动或输入行为的模组可能需要进行兼容性测试。

整合包

你可以在未经许可的情况下，将未修改的模组包含在公开或私人的整合包中。

Aerial Dash 根据 Apache License 2.0 分发。