HudCompass（Fabric）

一个 HUD 指南针叠加层，显示路径点、基本方位，并（通过原版定位条）显示死亡标记和其他被追踪的路径点 —— “看清你走向何方”。

这是一个 面向 Minecraft 26.2 的非官方 Fabric 移植版，基于 gigaherz 的 HudCompass，原版为 NeoForge 编写。原始设计、美术以及路径点/图标架构的所有功劳均归原作者所有；此移植版将其适配到 Fabric 加载器及 MC 26.2 的 API 上运行。

免责声明： 这是一个社区移植版，并非原模组。它与 gigaherz（David Quintana）或上游 HudCompass 项目没有任何关联、认可、支持或维护关系。如需原版 NeoForge 模组，请前往 gigaherz/HudCompass。在此 Fabric 移植版中发现的 bug 请在此处报告，而不要报到上游仓库 —— 它们是两个独立维护的代码库。

功能

• 指南针 HUD：基本方位、路径点图标/标签、上方/下方箭头、淡出/距离行为
• 路径点：通过按键绑定添加/移除，完整的游戏内路径点编辑器（添加/编辑/删除，按世界分组，可折叠）
• 多人游戏路径点同步 —— 服务器权威，可在重新登录以及真正的断开/重连后保留
• 服务器端路径点来源：床/重生锚重生点、原版地图旗帜/装饰标记、其他玩家追踪（队伍/全部/无 过滤）
• 原版定位条镜像，以及在指南针 HUD 可见时抑制原版定位条（可配置）
• JourneyMap 集成：将 JourneyMap 自身的路径点镜像到指南针上，单向/只读（可选 —— 不需要 JourneyMap）
• 通过 ModMenu + Cloth Config 提供的游戏内配置界面（两者均可选 —— 如果两者都未安装，可以手动编辑 config/hudcompass.json）

原版 NeoForge 模组的每一项功能都已移植，并已在游戏内确认可用。

已知且接受的差异（原样保留自上游自身未完成的状态）：

• 路径点编辑器中的“更改符号”图标选择按钮是一个被禁用的占位符 —— 上游自己的按钮同样无效。
• JourneyMap 镜像的路径点会渲染为一个通用的着色图标，而不是每个路径点真正的自定义纹理 —— 上游也从未完成这一点。

致谢

• gigaherz（David Quintana）—— 原模组
• Romoslayer —— Fabric 26.2 移植

许可证

BSD 3-Clause，与上游一致，未作修改。版权所有 (c) 2020, David Quintana (gigaherz)。