PowerHUD

PowerHUD

一个现代、高度可自定义的Minecraft HUD叠加模组

游戏机制

PowerHUD

一个面向 Minecraft Fabric 的现代化、高度可定制的 HUD 叠加模组,支持 Minecraft 26.3(“Wilderness Bound”) 和 1.21.4。


✨ 特性

📊 性能与诊断

  • 实时 FPS 显示,配有颜色编码的性能指示器
  • 动态 FPS 圆点,根据实时性能脉冲
  • 最小/最大/平均 FPS 追踪,支持一键重置
  • 自定义 F3 调试屏幕 – 更简洁的标签页式调试界面

🗺️️ 导航与世界信息

  • 坐标显示(XYZ),包含当前方块位置
  • 朝向方向,包含基本方位和度数
  • 生物群系信息 – 实时生物群系检测
  • 时间显示 – 游戏内时钟,带昼夜与日落/日出指示
  • 游戏模式指示器 – 显示当前游戏模式

🎒 背包与装备

  • 可视化背包显示 – 网格、百分比或分数计数可视化
  • 最佳工具建议 – 显示准星所指方块的理想工具
  • 目标方块信息 – 显示你正在注视的确切方块
  • 方块统计 – 追踪当前会话中挖掘和放置的方块

🌊 生存统计

  • 氧气等级指示器 – 用于水下探索的可视化、颜色编码氧气条
  • 生命值显示 – 生命值与状态信息

🎮 默认键位绑定

按键 动作 备注
U 打开配置界面 Minecraft 26.3 上的默认键(避免与原版好友列表冲突)
O 打开配置界面 旧版 Minecraft 1.21.4 上的默认键
H 切换 HUD 可见性 立即显示或隐藏叠加层
R 重置 FPS 统计 重置最小/最大/平均 FPS 追踪器
Z 循环调试屏幕模式 在自定义标签页调试屏幕之间循环

提示: 所有键位绑定均可在 选项 ➔ 控制 ➔ 按键绑定 下的专用 PowerHUD 分类中完全重新映射。


📦 安装与兼容性

选择与你的 Minecraft 版本匹配的发布文件:

适用于 Minecraft 26.3(v1.14.0+)

  • Minecraft: 26.3
  • Fabric Loader: >= 0.19.5
  • Fabric API: >= 0.161.0+26.3
  • Java: 25 LTS

适用于 Minecraft 1.21.4(v1.13.0)

  • Minecraft: 1.21.4
  • Fabric Loader: >= 0.16.9
  • Fabric API: 0.110.0+1.21.4
  • Java: 21

步骤

  1. 为你的 Minecraft 版本安装 Fabric Loader。
  2. 下载 Fabric API 并将其放入 .minecraft/mods 文件夹。
  3. 下载匹配的 PowerHUD 版本(26.3 使用 powerhud-1.14.0.jar,1.21.4 使用 powerhud-1.13.0.jar)。
  4. 将 .jar 文件放入 .minecraft/mods 文件夹。
  5. 使用 Fabric 配置文件启动 Minecraft。

⚙️ 配置

在游戏中按 U(1.21.4 上为 O)打开配置界面。

可用选项

  • 开关元素: 显示或隐藏各个 HUD 组件。
  • 字体选择: 从 9 种内置自定义等宽字体中选择(JetBrains Mono、Roboto Mono、Fira Code、Cascadia Code、Source Code Pro、Comic Mono、Monofur、Ubuntu Mono、Inter Mono)。
  • 颜色自定义: 从 20+ 种颜色中选择文本、数据和标题颜色。
  • 粗体标题: 切换元素标题的粗体格式。
  • HUD 工作台: 可视化拖放编辑器,具有:
    • 实时交互式 HUD 预览。
    • 基于区域的吸附(左、中、右)。
    • 用于灵活垂直间距的间隔元素。
    • 自动堆叠,精确的碰撞箱对齐。
  • 缩放: 将全局 HUD 缩放从 50% 调整到 250%。
  • FPS 调整: 配置显示复杂度(极简 / 普通 / 完整)、阈值截断和动态圆点指示器。
  • 背包调整: 选择显示样式(网格 / 百分比 / 分数)。
  • 氧气设置: 调整居中叠加层高度并切换原版气泡。
  • HUD 配置文件: 保存、加载、重命名、删除、导出和导入多个 HUD 布局。

导出与导入配置文件

  • 导出: 点击 导出 将当前活动配置文件保存为 .json 文件到你的主文件夹。
  • 导入: 将名为 import_profile.json 的文件放入你的主文件夹,然后点击 导入 将其加载到你的配置文件列表中。

📋 路线图

未来更新中正在考虑:

  • 动画过渡和淡入淡出效果
  • 光照等级指示器
  • 盔甲与工具耐久度警告
  • 扩展的会话统计

🤝 贡献

欢迎贡献和反馈!

  • 报告 Bug: 在 GitHub 上打开 issue,附上复现步骤和崩溃日志。
  • 建议功能: 在 GitHub issues 区分享想法。
  • 拉取请求: Fork、编码并提交 PR!

📄 许可证

本项目根据 MIT 许可证 授权。


📊 版本历史

v1.14.1 – (2026 年 10 月 2 日)

  • 新增: 与 Minecraft 26.3(“Wilderness Bound”) 完全兼容
  • 新增: 工具链更新至 Java 25 LTS 和 Gradle 9.8.0
  • 新增: 渲染引擎现代化至 Minecraft 26.3 的 GuiGraphicsExtractor 和 RenderPearl 管线
  • 新增: 通过 Fabric API HudElementRegistry 实现原生氧气气泡条替换
  • 变更: 默认配置键从 O 改为 U,以避免与原版 26.3 好友列表 / 社交菜单冲突
  • 新增: 在控制 / 按键绑定中新增专用 PowerHUD 分类,支持完整翻译
  • 修复: 工作台布局状态持久化及关闭编辑器后的实时重渲染
  • 修复: 关于屏幕:捐赠二维码不再渲染为白色方块。

v1.13.0 – (2026 年 2 月 13 日)

  • 新增: 无障碍颜色预设(色盲、高对比度、阅读障碍)现在按配置文件存储
  • 变更: “默认”颜色预设重命名为“关闭”;仅在选中“关闭”时才能手动选择颜色
  • 改进: 无障碍预设强制使用深色背景和粗体数据
  • README 和 version.txt 已更新以反映这些变更

v1.12.0 – (2026 年 2 月 13 日)

  • 新增: 完整的配置文件管理 overhaul(保存、重命名、删除、导出和导入配置文件)
    • 保存按钮始终可用:空白 = 保存到当前,文本 = 新建/覆盖
    • 配置文件名称验证(字母、数字、-、_,最多 32 个字符)
    • 所有配置文件操作的视觉反馈和工具提示
    • 保存/取消的键盘快捷键,自动聚焦配置文件输入框

v1.11.5 – (2026 年 2 月 13 日)

  • 改进: 配置文件管理器在顶部显示当前加载的配置文件
  • 改进: 配置文件列表包含紧凑的加载(L)和删除(x)按钮
  • 新增: 删除确认对话框防止意外删除配置文件
  • 按钮尺寸和布局的 UI 修复

v1.11.4 – (2026 年 2 月 12 日)

  • 新增: HUD 配置文件 – 保存/加载/删除 HUD 布局以快速切换
  • 改进: 氧气叠加层 UI – 更浅的不透明度,固定宽度,改进文本对比度
  • 改进: HUD 工作台 – 拖动框在任何缩放下都精确对齐 HUD 边界
  • 修复: 在所有气泡状态下隐藏原版空气气泡

v1.11.1 – (2026 年 2 月 12 日)

  • 新增: 所见即所得 HUD 工作台 – 带实时预览的可视化拖放编辑器
  • 新增: 基于区域的吸附 – 元素自动吸附到左侧、中间或右侧区域
  • 新增: 间隔元素 – 在元素之间添加垂直间距

🙏 致谢

  • 使用 Fabric 构建
  • 字体资源来自开源等宽字体项目
  • 灵感来自 Minecraft 模组社区