ElytraUtils

模组

· 作者 johnseth97

一款客户端模组,添加了详细的鞘翅工具功能,例如最佳上升/下降角度、预估距离/飞行时间,以及一个可选的沉浸式飞行动力学 HUD,其设计模仿了飞机的仪表盘。扩展了 CoordinatesDisplay 的功能,即使在 CD 隐藏时也能正常工作。

0 本站下载 0 关注 更新于 4 个月前

需要前置:Coordinates Display、BoxLib、Fabric API

最新 1.2.1 · 1.21.11 · Fabric

一键开服(送7天)

ElytraUtils

一款 Fabric 伴侣模组,将 CoordinatesDisplay 的 HUD 转化为 真正的鞘翅飞行仪表板 —— 包含战斗机风格的姿态显示器、撞击伤害预测、滑翔范围以及基于 Minecraft 实际飞行物理而非目测估算的“备用燃油”耐久度警告。

飞行仪表 HUD

在滑翔时,屏幕中央会出现一个姿态显示器 —— 这是一个真正的 HUD,而不是文本读数:

  • 俯仰刻度尺 (Pitch ladder) —— 以地平线为参考的爬升/俯冲刻度(间隔 10°),并在推导出的理想火箭爬升角度 (-34°) 和俯冲警告阈值 (+30°) 处设有绿色/红色参考标记框。
  • 准星 (Boresight) —— 显示你真正朝向的固定水平线标记。
  • 航迹标记 (Flight path marker) —— 一个小浮动十字线,显示你实际正在前往的方向(你的速度矢量),独立于你的视线方向。它与准星之间的间隙即为你的攻角。
  • 攻角指示器 (AoA indexer) —— 一个紧凑的垂直标尺,直接读取攻角数值,其 STALL(失速)标志基于真实的空速下限(约 0.35 方块/刻),而非猜测的角度。
  • 方位标尺 (Bearing tape) —— 位于顶部的罗盘航向条。
  • 空速标尺 (Airspeed tape) —— 水平速度,按方块/秒缩放。
  • 高度标尺 (Altitude tape) —— 滚动标尺上的气压高度 (BALT),下方有一个雷达高度 (RALT) 方框;当没有物体可供射线反射时,它显示“无锁定”而非伪造数字。

显示器上的每一个刻度、标记和阈值都源自与下方文本 HUD 相同的反编译及模拟原版物理数据 —— 如需了解推导过程,请参阅 agents.md。

整个显示器在接近可配置的“沉浸式 HUD 高度”时会逐渐淡出 —— 而非硬性裁剪 —— 使其看起来像真实 HUD 有限的玻璃显示区域,而不是覆盖整个屏幕。比例、颜色(支持 alpha 通道,用于类似 HUD 亮度的透明度控制)以及每个单独元素均可独立配置或切换,且该显示器独立于下方的文本 HUD 运行 —— 关闭其中一个不会影响另一个。

这些仪器也可以在你尚未达到一定高度时隐藏:通过 Min Radar Altitude(最小雷达高度)设置,它们会在低于配置的射线检测(雷达)离地高度时被隐藏,这样就不会在起飞或降落时在屏幕上造成杂乱。开启 Sticky Enable(粘性启用)后,一旦你在飞行中爬升到该高度之上,即使随后跌落到该高度以下(例如在已经爬升后低飞掠过树梢),显示器也会保持开启状态,直到你着陆并再次起飞。

热键

两个热键,默认未绑定(请在 选项 → 控制 → ElytraUtils 中进行绑定):

  • Toggle Immersive HUD —— 切换显示飞行仪表。
  • Toggle Text HUD —— 切换显示鞘翅叠加层。

这两个热键仅翻转配置文件界面所控制的相同设置 —— 它们不改变允许显示的时间点(仍然受限于坠落飞行状态,或者对于文本 HUD 而言,受限于装备鞘翅并手持火箭的状态)。如果在该条件未满足时按下其中一个热键(否则屏幕上不会有任何变化),屏幕中央仍会显示一条淡入淡出的消息进行确认:绿色 "... Enabled" 或红色 "... Disabled",反映其实际切换后的状态。

文本 HUD 行

在滑翔时 —— 或者在地面上站立且装备了鞘翅并手持火箭(发射前)时 —— 额外的行会附加到 CoordinatesDisplay 叠加层上:

Elytra  -18.4°  ✓ GLIDE  Vy -0.18  H 1.24
  Impact H:2.5❤ V:0.0❤
  Range 342 blocks
  Time to ground ~1:12

飞行行

字段 含义
Pitch 带符号的角度;负值 = 机头向上
Status 飞行模式指示器(见下文)
Vy 垂直速度,方块/刻
H 水平速度,方块/刻

Status 指示器,带有推导出的最佳角度:

状态 何时出现 颜色
LAUNCH 发射前(地面静止,装备鞘翅 + 火箭)。相对于理想起飞角度的渐变 绿→红渐变 + ▲/▼/● 箭头
⚠ STALL 水平速度降至接近 ~0.35 方块/刻的空速下限时 红色
CLIMB 机头向上。以理想火箭爬升角度(≈ -34°)为中心的渐变 绿→红渐变 + 箭头
GLIDE 平缓。水平时呈绿色(最大射程)→ 接近 +30° 时呈红色(最大速度) 绿→红渐变 + 箭头
DIVE 陡峭机头向下。基于下降率的渐变;红色 ≈ “立即拉杆” 绿→红渐变

渐变箭头(▲ 抬头 / ▼ 低头 / ● 目标内)告诉你应向哪个方向修正以达到该模式的最佳角度。驱动上方飞行仪表 HUD 的也是同样的基于物理的颜色和阈值。

撞击行

如果你现在撞到物体,预测的伤害值(以心为单位),已考虑你实际的盔甲附魔:

  • H —— 水平墙壁撞击伤害(受 Protection 保护减少)。
  • V —— 垂直地面撞击伤害(受 Protection 和 摔落保护减少 —— 摔落保护正确地对不减少墙壁撞击伤害)。

射程与距地面时间

在当前滑翔坡度下到达地面的距离和时间,使用配置的气压计模式(见下文)。当你不在下降时,这两项会自动隐藏。

距地面时间是两阶段精确计算的,而非简单的直线外推:如果你的鞘翅会在落地前因耐久度耗尽而破裂,它会模拟破裂后剩余距离的实际自由落体物理,而不是假装滑翔率一直保持不变。当耐久度确实是限制因素时,该数字会与 Master Caution(主警告)同步闪烁红色 —— 因此关闭 Master Caution 的横幅并不会让你失去警告,它只是转移到了这一行。

Master Caution

屏幕中央的缓慢闪烁(癫痫安全 1 Hz)ELYTRA DESTRUCTION IMMINENT(翼翅即将损毁)警告,会在你的翼翅因耐久度耗尽而断裂、且你尚未落地时触发——即你会在半空中坠亡。它采用类似“剩余油量”的时间对比机制,因此不会被火箭推进的速度峰值所误导。

配置

通过 ModMenu(可选)在游戏内配置,或编辑 config/coordinatesdisplay_elytrautils.json。游戏内的屏幕设置分组标题与下方各章节对应。

常规

设置项 默认值 描述
Show Elytra Overlay on 文本 HUD 行(以及主警告)的主开关

主警告 (Master Caution)

设置项 默认值 描述
Caution Threshold 100 在死亡点之前的提前预警方块数;0 = 关闭主警告
Master Caution Color red 警告文字的颜色

高度计

设置项 默认值 描述
Altimeter Mode Auto Radar(射线检测地形)、Barometric(固定参考值),或 Auto(低空雷达,高空气压)
Switchover Height 100 在 Auto 模式下,从雷达切换至气压模式的 AGL(离地)高度
Barometric = Sea Level on 使用维度感知参考值而非固定的 Y 坐标 —— 见下文
Barometric Y 63 当上述选项关闭时的自定义参考高度

这个维度感知的参考值并非在所有地方都是平坦的海平面:

  • 主世界 (Overworld) — 原版海平面(63)。
  • 下界 (Nether) — 低于基岩天花板时的岩浆海水平面;一旦你飞越屋顶(Y > 127),参考值会切换至屋顶本身,因为远处的岩浆与此无关。
  • 末地 (End) — 没有有意义的“海平面”(世界生成的数值只是一个噪声整形参数,而非地表),因此它会追踪你最后实际所在岛屿的高度,而非一个固定数值。

HUD 线条

设置项 默认值 描述
Show Impact Line on 切换伤害冲击行
Show Range Line on 切换射程行
Show Flight Time Line on 切换落地时间行

飞行仪表

设置项 默认值 描述
Show Flight Instruments on 战斗机风格 HUD 的主开关(独立于 Show Elytra Overlay)
Min Radar Altitude 0 雷达(射线检测)AGL 高度下限,低于此高度时即使处于坠落滑翔状态也会隐藏仪表;0 = 无最低限制
Sticky Enable off 一旦在飞行中超过 Min Radar Altitude,即使再次低于该高度也会保持显示,直到着陆
Instrument Scale 1.0 整个仪表显示的统一大小乘数
Instrument Color yellow 显示结构元素的颜色(含 alpha/透明度)
Show Pitch Ladder on 切换地平线参考的俯仰梯
Show Flight Path Marker on 切换速度矢量准星
Show AoA Indicator on 切换攻角表
Show Bearing Tape on 切换罗盘航向条
Show Airspeed Tape on 切换空速表
Show Altitude Tape on 切换 BALT/RALT 高度表
Immersive HUD Height 120 模拟 HUD 玻璃的半高(像素),超出此高度后元素逐渐淡出

依赖

  • Minecraft 1.21.11, Fabric Loader 0.19.2+
  • CoordinatesDisplay 19.x
  • BoxLib 20.x(CoordinatesDisplay 自身的依赖项)
  • Fabric API
  • ModMenu —— 可选,仅用于游戏内配置界面

构建与开发部署

./gradlew build          # -> build/libs/coordinatesdisplay-elytrautils-fabric-<version>.jar

复制 .env.example 为 .env,编辑路径,然后使用 “Build & Deploy to Dev Instance” 编辑器任务来构建并将 jar 直接复制到你的 PrismLauncher 实例的 mods/ 文件夹中。

发布

./scripts/release.sh 1.0.0

创建 GitHub Release;当设置了 MODRINTH_PROJECT_ID / CURSEFORGE_PROJECT_ID 仓库变量时,也会发布到 Modrinth/CurseForge。


基于 modrinth-curseforge-repo-template 生成。 参见 agents.md 了解架构和约定。 可配置的“沉浸式 HUD 高度”,使其读起来像真实 HUD 有限的玻璃视域,而不是覆盖整个屏幕。缩放、颜色(带 alpha,用于类似 HUD 亮度的透明度控制)以及每个单独元素均可独立配置或切换,且该显示独立于下方的文本 HUD 运行——关闭其中一个不会影响另一个。

文本 HUD 行

在滑翔时——或者在地面上手持翼翅和火箭(发射前)时——额外的行会附加在 CoordinatesDisplay 叠加层上:

Elytra  -18.4°  ✓ GLIDE  Vy -0.18  H 1.24
  Impact H:2.5❤ V:0.0❤
  Range 342 blocks
  Time to ground ~1:12

飞行行

字段 含义
Pitch 有符号度数;负值 = 机头向上
Status 飞行状态指示器(见下文)
Vy 垂直速度,方块/刻
H 水平速度,方块/刻

状态指示器及其派生的最佳角度:

状态 触发条件 颜色
LAUNCH 发射前(地面静止,装备翼翅 + 火箭)。相对于理想起飞角度的渐变 绿→红渐变 + ▲/▼/● 箭头
⚠ STALL 水平速度降至约 0.35 方块/刻的空速底线附近 红色
CLIMB 机头向上。以理想火箭爬升角度(≈ -34°)为中心的渐变 绿→红渐变 + 箭头
GLIDE 平缓。水平时最绿(最大射程)→ 接近 +30° 时变红(最大速度) 绿→红渐变 + 箭头
DIVE 陡峭机头向下。基于下降率的渐变;红色 ≈ “立即拉起” 绿→红渐变

渐变箭头(▲ 抬头 / ▼ 低头 / ● 目标)指示你应朝哪个方向调整,以进入该飞行状态的最佳角度。相同的基于物理学的颜色和阈值也驱动着上方的飞行仪表 HUD。

撞击线

如果你现在撞到物体,预计会受到的心数伤害,已考虑你的实际盔甲附魔:

  • H — 水平撞墙伤害(受保护附魔减免)。
  • V — 垂直地面撞击伤害(受保护附魔和摔落保护附魔减免——摔落保护附魔正确地不减免撞墙伤害)。

距离与落地时间

在当前滑翔坡度下,到达地面所需的距离和时间,使用配置的测高仪模式(见下文)。当你未处于下降状态时,这两项信息会自动隐藏。

主警告

屏幕居中、缓慢闪烁(癫痫安全频率 1 Hz)的 ELYTRA DESTRUCTION IMMINENT(鞘翅即将损毁)警告。当你的鞘翅耐久度损失将在你触地前导致其断裂时触发——即你会在半空中坠亡。这是一种“剩余油量”式的时间对比逻辑,因此不会因火箭加速的速度峰值而产生误判。

配置

通过游戏内的 ModMenu(可选)进行配置,或编辑 config/coordinatesdisplay_elytrautils.json。

设置项 默认值 描述
Show Elytra Overlay on 文本 HUD 行(及主警告)的主开关
Caution Threshold 100 在死亡点之前的提前预警方块数;0 = 关闭主警告
Master Caution Color red 警告文本的颜色
Altimeter Mode Auto Radar(射线投射地形)、Barometric(固定参考基准)或 Auto(低空雷达,高空气压)
Switchover Height 100 在 Auto 模式下,从雷达切换至气压测高的 AGL(离地高度)
Barometric = Sea Level on 使用该维度的海平面作为气压参考基准
Barometric Y 63 当上述选项关闭时的自定义参考高度
Show Impact Line on 切换撞击伤害显示行
Show Range Line on 切换距离显示行
Show Flight Time Line on 切换落地时间显示行
Show Flight Instruments on 战斗机风格 HUD 的主开关(独立于 Show Elytra Overlay)
Instrument Scale 1.0 整个仪表显示区域的统一尺寸倍率
Instrument Color yellow 显示结构元素的颜色(含透明度)
Show Pitch Ladder on 切换参照地平线的俯仰梯
Show Flight Path Marker on 切换速度矢量准星
Show AoA Indicator on 切换攻角刻度带
Show Bearing Tape on 切换罗盘航向条
Show Airspeed Tape on 切换空速刻度带
Show Altitude Tape on 切换 BALT/RALT 高度刻度带
Immersive HUD Height 120 模拟 HUD 玻璃的半高(像素),在此高度以下元素开始淡出

依赖要求

  • Minecraft 1.21.11, Fabric Loader 0.19.2+
  • CoordinatesDisplay 19.x
  • BoxLib 20.x(CoordinatesDisplay 自身的依赖项)
  • Fabric API
  • ModMenu — 可选,仅用于游戏内配置界面

构建与开发部署

./gradlew build          # -> build/libs/coordinatesdisplay-elytrautils-fabric-<version>.jar

复制 .env.example 为 .env,编辑路径,然后使用 “Build & Deploy to Dev Instance” 编辑器任务来构建 jar 包并直接复制到你的 PrismLauncher 实例的 mods/ 文件夹中。

发布

./scripts/release.sh 1.0.0

创建 GitHub Release;当设置了 MODRINTH_PROJECT_ID / CURSEFORGE_PROJECT_ID 仓库变量时,也会发布到 Modrinth/CurseForge。


本项目基于 modrinth-curseforge-repo-template 搭建。 请参阅 agents.md 了解架构和约定。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源