方向平视显示器

方向HUD

概览

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

---

功能特性

• 方向显示 在左上角显示基本方向（北、南、东、西）和中间方向（东北、西北、东南、西南）。

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

• 时间显示 同时显示：

  • 真实世界时间（24小时制）
  • 游戏内时间（12小时制，带上午/下午及太阳/月亮图标），位于右上角

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

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

• 坐标保存 使用自定义名称保存当前位置，并可随时调取。

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

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

• 极简界面 清晰、易读的覆盖层，带有半透明背景以保证可读性。

---

工作原理

1. 初始化

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

2. 方向计算

• 使用玩家的偏航角来确定方向
• 360°圆周被划分为8个扇区（每个45°）：
  • 北、东北、东、东南、南、西南、西、西北

3. 渲染

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

4. 命令处理

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

---

命令

方向

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

天数

/dh days <on|off> 切换我的世界天数显示

时间

/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] - 2026年4月29日

新增功能

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

---

注意事项

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