Hudaris

Hudaris — Minecraft HUD 改进

Hudaris是一款客户端 Fabric 模组，可将实用的物品栏、装备和建筑信息整合到精简且可自定义的 Minecraft HUD 中。

主要功能

• 物品栏 HUD — 无需打开物品栏，即可查看主物品栏内容。
• 护甲 HUD — 显示已装备的护甲、耐久条、精简数字和可调节的警告。
• 手持物品耐久度 — 显示选中物品和副手物品的耐久信息。
• 潜影盒预览 — 查看手持或悬停的潜影盒内完整物品栏网格。
• 箭矢计数 — 分别显示不同箭矢类型、各自数量和可选的总数。
• 不死图腾提醒 — 双手都没有拿着不死图腾时发出提醒，并显示可用数量。
• 药水效果计时 — 在状态效果图标下方显示剩余时间。
• 精简 F3 信息 — 简化显示 FPS、游戏内时间、天数和延迟。
• Litematica 检查器 — 以颜色标示原理图错误数量，并随显示图层变化。
• 可拖动 HUD 编辑器 — 支持显示开关、尺寸滑块、位置保存和网格吸附。

物品栏 HUD

按正常的 9×3 布局显示全部27 个主物品栏格，包括物品数量和耐久条。

显示尺寸默认为快捷栏格子的一半，让界面保持紧凑。你可以通过 HUD 编辑器移动和调整大小。

护甲 HUD

随时查看已装备的头盔、胸甲或鞘翅、护腿和靴子。

• 物品图标与快捷栏格子等大，并显示 Minecraft 原版耐久条。
• 每个格子下方显示精简的剩余/最大耐久数值。
• 耐久度警告阈值可在 0–100% 之间调整。
• 耐久度达到或低于所选阈值时，格子和数值会变红。
• 将阈值设为0% 可关闭警告。

未装备任何护甲时，面板会隐藏。

手持物品耐久度

可切换是否在选中的快捷栏物品和副手格上方显示小号耐久数值。

只要手持物品具有耐久度，就会分别检查两只手，方便你查看工具、武器和其他可损坏装备的状态。

潜影盒预览

手持潜影盒

在快捷栏中选中潜影盒，或将其拿在副手时，物品栏 HUD 下方会显示其中的物品。

预览会显示完整的27 格布局，包括空格、物品堆叠数量和耐久条。如果双手都拿着潜影盒，就会分别显示两个带标签的预览。

手持预览会跟随物品栏 HUD 的位置和缩放比例。如果下方空间不足，则会移到上方。

悬停潜影盒

在打开的物品栏或容器中将鼠标悬停在潜影盒上方，即可在其格子上方查看精简的物品网格。如果位置靠近屏幕顶部，预览也可以显示在格子下方。

该网格会替代简略的内容列表，同时保留潜影盒名称、描述和其他提示信息。

手持和悬停预览可分别开关。预览为只读，不会打开或修改潜影盒。服务器发送的物品数据中必须包含潜影盒内容。

箭矢计数

追踪普通箭、光灵箭和药箭，分别显示图标、名称和数量。

普通箭排在最前，其后是光灵箭和不同种类的药箭。不同药水效果的药箭会分别统计；相同箭矢则会合并计算主物品栏和副手中的数量。

还可以选择在列表上方显示总数。选择计数面板的显示时机：

• 手持弓时 — 任意一只手拿着弓或弩时显示。
• 始终 — 持续显示。
• 从不 — 隐藏。

面板可移动和缩放。已装入弩中的箭，以及存放在容器内的箭，不计入数量。

图腾提醒

启用后，当双手都没有拿着不死图腾时，屏幕顶部会显示提醒，并显示主物品栏和副手中拥有的图腾数量。

任意一只手拿着图腾时，提醒都会隐藏。容器中的图腾不计入数量。

药水效果计时器

在 Minecraft 默认的状态效果图标下方添加小型剩余时间计时器。

无限时长的效果会显示无穷大符号，效果图标之间也会留出额外间距来显示计时器。此功能可单独开关。

精简 F3 信息

使用 Minecraft 的F3 + F6选项，或在编辑器的F3 / 时间页面中控制以下信息的显示方式：

• FPS — 精简FPS: 120显示，不包含额外的帧率上限和显示器刷新率详情。
• 时间 — Minecraft 游戏内时间，显示为Time: HH:MM。
• 天数 — Minecraft 原有的天数信息。
• 延迟 — 服务器报告的玩家列表延迟，单位为毫秒。

可选择从不、F3 界面中或始终显示。选择“始终”的信息在关闭 F3 界面后仍会显示。

可选的 Litematica 校验器

安装兼容版本的Litematica和MaLiLib后，Hudaris 可自动比对可见的投影区域与当前世界。

校验器会显示：

• 红色 — 方块错误：当前位置有不同类型的方块。
• 橙色 — 状态错误：方块的朝向、启用状态或其他状态不正确。
• 蓝色 — 尚未放置：缺少所需方块。
• 洋红色 — 多余方块：投影要求此处为空气，但实际存在方块。

启用 Litematica 的不同材料分组时，相关的黄色材料差异会单独显示。

校验器遵循 Litematica 当前的渲染层设置，包括单层、范围、上方/下方模式以及X、Y 或 Z 轴。它会遵循已启用的渲染子区域设置，避免重复计算重叠区域，并遵循 Litematica 的流体、作物生长阶段和忽略已有方块设置。

无需手动运行校验器。没有可见的投影放置区域，或 Litematica 渲染已禁用时，面板会隐藏。

统计仅涵盖已加载的客户端区块。扫描会分批进行，检查和刷新期间会显示进度。校验器会检查方块类型和状态，不检查实体、方块实体数据或容器内容。

HUD 编辑器

按下‘（单引号）打开编辑器。可在选项 → 控制 → 按键绑定 → 调试 → 打开 HUD 编辑器中更改按键。

• 拖动物品栏、护甲、箭矢和投影校验器面板。
• 调整面板大小，范围为25–200%，并可自动适配较小的屏幕。
• 可单独开关各项功能。
• 启用网格吸附，可选择七种网格大小：2、4、8、10、16、20 或 32 个 GUI 像素。
• 重置布局或手动刷新投影校验器。
• 设置会在不同游戏会话间自动保存。

打开可折叠侧边栏以访问设置。左键点击页面按钮前进，右键点击返回。前进和返回都会在页面列表中循环切换。

运行要求

• Minecraft Java 版 26.3
• Fabric Loader 0.19.3 或更高版本
• 适用于 Minecraft 26.3 的 Fabric API
• Java 25
• 可选：用于投影校验的兼容版本 Litematica 和 MaLiLib

Hudaris 在客户端运行，无需安装在服务器上。每次只安装一个版本的 Hudaris，更新时请移除旧版 jar 文件。

作者与测试

由Henry制作，他在 Minecraft 中的名字是Clytron100。

所有功能均已在游戏中测试。