方向HUD

方向 HUD

概述

方向 HUD 模组直接在屏幕上显示有用的玩家信息，例如朝向、世界时间、坐标等。所有 HUD 元素均可配置，并可使用命令开启或关闭。其状态会在游戏会话之间保存。

---

功能

• 方向显示 在左上角显示基本方向（N、S、E、W）和中间方向（NE、NW、SE、SW）。

• Minecraft 天数 显示当前世界中经过的天数（左上角）。

• 时间显示 同时显示：

  • 现实世界时间（24 小时制）
  • 游戏内时间（12 小时制，带 AM/PM 和太阳/月亮图标），位于右上角

• 坐标显示 在快捷栏上方显示当前 X、Y、Z 坐标。

• 生物群系显示 在坐标旁显示当前生物群系。

• 坐标保存 使用自定义名称保存当前位置，并在之后取回。

• 可切换功能 每个 HUD 元素均可使用命令独立启用或禁用。

• 持久配置 所有偏好设置和已保存的坐标都存储在： config/direction-hud.json

• 极简 UI 简洁、易读的覆盖层，带有细微背景以提高可见性。

---

工作原理

1. 初始化

• 模组从 config/direction-hud.json 加载配置
• 命令使用 /dh 命名空间注册，以避免与其他模组冲突

2. 方向计算

• 使用玩家的偏航角来确定方向
• 360° 圆被分为 8 个区段（每段 45°）：
  • N、NE、E、SE、S、SW、W、NW

3. 渲染

• 已启用的 HUD 元素会渲染在各自对应的屏幕位置：
  • 左上角：方向 + Minecraft 天数
  • 右上角：时间（现实 + 游戏内）
  • 快捷栏上方：坐标 + 生物群系
• 每个元素都包含半透明背景以提高可读性

4. 命令处理

• 所有功能都通过 /dh 命令控制
• 更改会立即保存到配置文件

---

命令

方向

/dh direction <on|off> 切换方向显示

天数

/dh days <on|off> 切换 Minecraft 天数显示

时间

/dh time <on|off> 切换现实世界和游戏内时间显示

坐标

/dh coords <on|off> 切换坐标显示

/dh coords save <name> 使用自定义名称保存当前坐标

/dh coords list 列出所有已保存的坐标

生物群系

/dh biome <on|off> 切换生物群系显示

---

配置

该模组使用基于 JSON 的配置文件：

config/direction-hud.json

此文件存储：

• 每个 HUD 元素的启用/禁用状态
• 带自定义名称的已保存坐标

---

更新日志

[3.2.1] - 29-04-2026

功能

• 添加了 Minecraft 天数计数器
• 添加了现实世界和游戏内时间显示
• 添加了坐标和生物群系显示
• 添加了坐标保存和列出系统
• 引入了通过命令逐功能切换
• 将配置从 .properties 迁移到 .json
• 将命令命名空间更新为 /dh，以避免模组冲突

---

说明

• 所有设置都会在游戏会话之间持久保存
• 设计轻量且不干扰游戏
• 与大多数基于 Fabric 的整合包兼容