Zap的增强HUD工具

Zap的增强HUD工具

增强型HUD工具与功能

Zap的增强HUD工具预览查看大图

ZEHU — Zap 增强 HUD 工具

一个高性能、模块化的 Minecraft 1.21.11、26.1.x 和 26.2 Fabric HUD 工具模组。

概述

ZEHU — Zap 增强 HUD 工具 是一款专为 Minecraft 1.21.11、26.1.x 和 26.2 设计的 HUD 模组。ZEHU 旨在以简洁的模组形式提供必要的 HUD 工具，不捆绑专有启动器，支持与分辨率无关的相对缩放，并实现零垃圾回收的渲染例程。

本模组包含必要的 PvP HUD 工具以及其他杂项和生存类工具，并为每项特定工具提供不同主题。

警告

[!警告] 本模组目前并将在未来持续开发中。如果存在错误，或者您发现某些不够完善的地方，这是因为模组仍处于开发阶段。如果您发现任何错误或需要改进的地方，请在 Github 源代码仓库 中提交 issue。我是独立开发者，没有时间检查模组的每一个角落，因此如果您能向我报告，我将非常感激，以便我进行查看。

主要特性与提供的模块

1. 盔甲与装备 HUD

  • 实时耐久追踪：显示已装备的头盔、胸甲、护腿和靴子，并提供实时耐久条、原始数值或百分比显示。
  • 低耐久警告：当装备耐久度低于可配置阈值（百分比或原始耐久值）时，触发视觉警告高亮。
  • 灵活布局：支持垂直或水平堆叠、反转渲染顺序以及可自定义的文本位置。

2. 按键与输入 HUD

  • 实时输入显示：显示 WASD、鼠标左/右键、左 Shift、Ctrl 和空格键的输入。
  • 集成 CPS 指示器：直接在鼠标按键内显示实时每秒点击次数。

3. 战斗工具（连击、距离、延迟、CPS）

  • 连击计数器
  • 攻击距离显示
  • 延迟监视器
  • CPS 计数器
  • FPS 计数器

4. 导航（坐标、速度表和指南针）

  • 坐标 HUD：显示 X、Y、Z 坐标、基本朝向（北、南、东、西）、当前生物群系，以及自动计算下界坐标。
  • 速度表：以米/秒 ((m/s)) 为单位追踪水平移动速度。
  • 指南针条带：平滑的线性指南针条带，带有玩家头部图标（PlayerFaceExtractor）和基本方向刻度标记。

5. 物品追踪器 HUD

  • 自定义物品计数：追踪特定背包物品（末影珍珠、金苹果、箭、图腾等），并带有实时计数覆盖层。
  • 物品搜索与选择界面：内置注册表搜索界面，可快速选择要追踪的物品。
  • 药水与堆叠覆盖层：显示活动药水效果的实时持续时间指示器和物品堆叠数量。

7. 自定义准星

[!警告] 目前正在开发和改进中，尚不可用。

  • 矢量样式：可从 DOT、CROSS、CIRCLE、ARROW 或 VANILLA 中选择。
  • 精确参数：完全可调节的间隙、线条粗细、外部尺寸以及 RGB/Hex 颜色。

8. Boss 血条

[!警告] 目前正在开发和改进中，尚不可用。

  • 单条与多条堆叠：多条活动 Boss 血条的自定义堆叠方向（UP 或 DOWN）。
  • 统一边界框选择：编辑器边界框将所有活动 Boss 血条作为一个整体交互元素包围。

交互式拖放编辑器（HudLayoutScreen）

在游戏中按下 右 Shift（可配置）即可启动 HUD 布局编辑器。

  • 像素网格吸附：将小部件对齐到覆盖网格上，实现整洁的定位。
  • 动态对齐参考线：移动过程中动态出现青色和紫色吸附线，以将元素与屏幕中心或相邻小部件对齐。
  • 八点缩放控制柄：抓取角落或边中点，可独立缩放 X 和 Y 轴尺寸（(25% \text{--} 200%)）。
  • 相对屏幕缩放：将坐标存储为屏幕相对百分比（relativeX、relativeY），确保您的 HUD 布局在不同显示器（1080p、1440p、4K）或 GUI 缩放下保持居中。
  • 编辑器内上下文菜单：点击任意小部件的齿轮图标，打开一个玻璃态弹窗面板，用于调整颜色、缩放和特定模块的开关。

技术架构与性能效率

ZEHU 专门设计用于消除重型 HUD 模组中常见的微卡顿和帧率尖峰。

1. 渲染循环中零垃圾回收分配

标准 HUD 模组每帧都会实例化新的 String、Component 或 Vector 对象，导致频繁的 Java 垃圾回收（GC）暂停。

  • 缓存格式化序列：ZEHU 缓存字符串表示形式和原始颜色整数。
  • 原始缓冲区：CPS、连击和速度表的计算使用固定大小的原始数组（long[] / float[]），以防止渲染期间进行堆分配。

2. 事件驱动的时段采样

不是每刻都持续轮询实体列表或遍历背包：

  • 点击与命中：在原生输入事件时捕获，并存储在环形缓冲区中。
  • 物品追踪：仅在背包刻事件时评估物品数量，从而降低 CPU 开销。

3. 精准 Mixin 拦截

ZEHU 使用定向的 SpongePowered Mixins（GuiMixin、BossHealthOverlayMixin）拦截原版 GUI 渲染例程（extractEffects、extractCrosshair、extractRenderState）：

  • 当 ZEHU 模块启用时，相应的原版渲染例程在 @At("HEAD") 处被取消。
  • 这避免了双重渲染开销，并防止纹理缓冲区冲突。

4. GPU 状态提取（GuiGraphicsExtractor）

专为 Fabric 1.21.11、26.1.x 和 26.2 设计，ZEHU 利用 Mojang 现代 GuiGraphicsExtractor 管线（extractRenderState）。渲染通道直接批量提交到 GPU 管线，避免了不必要的矩阵堆栈推送和绘制调用拆分。

配置与安装

需求

  • Minecraft：1.21.11、26.1.x 或 26.2.x
  • Fabric Loader：>=0.19.0
  • Fabric API

配置文件

配置数据自动保存至：

.minecraft/config/zehu.json

路线图与未来发展

  • HUD 配置文件导入/导出
  • 帧时间与 CPS 迷你趋势图
  • 路径点与信标追踪
  • 自定义着色器背景
  • 疾跑/潜行切换
  • 全亮度切换
  • 可自定义 F3 显示模组
  • 粒子修改器
  • 时钟
  • 背包 HUD
  • 自定义字体及对 HUD 字体的更多控制
  • 背景透明度滑块
  • 彩虹色循环
  • 以及更多模块

许可证

基于 LGPLv3 许可证 分发。作者：Zapaxe。