BeaconHUD

BeaconHUD 让你一眼看清信标信息。将准星对准信标（约 8 格内），左上角会显示一个小面板：

信标
等级：4 / 4
范围：50米
主效果：速度
次效果：急迫

无需打开 GUI，无需点击——只需看向信标，即可了解其等级、增益覆盖范围以及已设置的效果。

显示内容

• 等级 - 已建造的 pyramids 等级（1-4），根据信标下方的基座方块实时计算得出。当金字塔未完成时，显示 等级：0（基座不完整）。
• 范围 - 效果半径（方块数，计算方式为 等级×10+10）：等级 1 = 20 米，最高等级 4 = 50 米。
• 效果 - 选定的主要和次要状态效果，直接从信标读取。未选择任何效果时（或服务器未将选择同步到客户端时），显示 效果：无 / 未解锁。

原因

原版信标仅在打开 GUI 时显示等级和效果，且世界中无法查看增益的实际覆盖范围。当你在规划基地布局，希望每个位置都能被急迫效果覆盖时，或者需要检查多个信标各自的功能时，一个个打开它们非常繁琐。BeaconHUD 让你一眼就能获取所有信息。

工作原理

• 直接从世界中读取金字塔等级：通过扫描信标下方的基座方块（minecraft:beacon_base_blocks 标签）实现——无需方块实体，因此等级和范围始终准确，即使在打开信标前也是如此。
• 从信标方块实体中读取主/次效果：通过字段类型读取（跨版本安全——未硬编码混淆名称），并设有完整保护机制，即使效果数据不可用，HUD 仍会显示等级和范围。
• 通过 Fabric 的 HudRenderCallback 渲染，因此 F1（隐藏 HUD）会像任何原版叠加层一样隐藏它。
• 只读模式——从不打开信标，从不修改方块，从不发送数据包。

控制

• V - 切换 HUD 开 / 关（默认：开）

通过原始 GLFW 轮询按键，因此在所有支持的版本中功能一致，无需重绑定界面。

兼容性

适用于 Minecraft 1.21.8、1.21.9、1.21.10 和 1.21.11，需安装 Fabric Loader 0.16 及以上版本。一个 JAR 文件支持所有四个版本——安装 Fabric API 后，将文件放入 mods/ 文件夹即可。

• 纯客户端模组；可在任何服务器上安全安装。
• 零配置文件；无需设置。
• 按 F1 时与其余 HUD 一起自动隐藏。