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
步骤
- 为你的 Minecraft 版本安装 Fabric Loader。
- 下载 Fabric API 并将其放入
.minecraft/mods 文件夹。
- 下载匹配的 PowerHUD 版本(26.3 使用
powerhud-1.14.0.jar,1.21.4 使用 powerhud-1.13.0.jar)。
- 将
.jar 文件放入 .minecraft/mods 文件夹。
- 使用 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 调整: 配置显示复杂度(Minimal / Normal / Full)、阈值截止点和动画圆点指示器。
- 物品栏调整: 选择显示样式(Grid / Percent / Fraction)。
- 氧气设置: 调整居中覆盖层的高度并切换原版气泡。
- HUD 配置文件: 保存、加载、重命名、删除、导出和导入多个 HUD 布局。
导出与导入配置文件
- 导出: 点击 Export 将当前配置文件保存为
.json 文件到你的主文件夹。
- 导入: 将名为
import_profile.json 的文件放在你的主文件夹中,然后点击 Import 将其加载到你的配置文件列表中。
? 路线图
正在考虑用于未来更新的功能:
- 动画过渡和淡入淡出效果
- 光照等级指示器
- 护甲与工具耐久度警告
- 扩展会话统计
? 贡献
欢迎贡献和反馈!
- 报告错误: 在 GitHub 上打开问题,附上复现步骤和崩溃日志。
- 建议功能: 在 GitHub 问题部分分享你的想法。
- 拉取请求: Fork 代码库,编写代码并提交 PR!
? 许可证
本项目采用 MIT License 许可。
? 版本历史
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日)
- 新增: 无障碍颜色预设(色盲、高对比度、阅读障碍)现在按配置文件存储
- 更改: “Default”颜色预设重命名为“Off”;仅在选中“Off”时才提供手动颜色选择
- 改进: 无障碍预设强制使用深色背景和粗体数据
- README 和
version.txt 已更新以反映这些更改
v1.12.0 – (2026年2月13日)
- 新增: 全面重构的配置文件管理功能(保存、重命名、删除、导出和导入配置文件)
- 保存按钮始终可用:留空表示保存到当前配置,输入文字表示新建/覆盖
- 配置文件名称验证(仅限字母、数字、
-、_,最多 32 个字符)
- 所有配置文件操作均提供视觉反馈和工具提示
- 支持使用键盘快捷键进行保存/取消,并在配置文件输入框自动聚焦
v1.11.5 – (2026年2月13日)
- 优化: 配置文件管理器在顶部显示当前加载的配置文件
- 优化: 配置文件列表包含紧凑的加载 (
L) 和删除 (x) 按钮
- 新增: 删除确认对话框,防止意外删除配置文件
- 修复了按钮大小和布局的用户界面问题
v1.11.4 – (2026年2月12日)
- 新增: HUD 配置文件 – 保存/加载/删除 HUD 布局以便快速切换
- 优化: 氧气叠加层用户界面 – 更低的透明度、固定宽度、改进的文字对比度
- 优化: HUD 工作台 – 拖拽框在任何缩放比例下都能与 HUD 边界精确对齐
- 修复: 在所有气泡状态下隐藏原版空气气泡的问题
v1.11.1 – (2026年2月12日)
- 新增: WYSIWYG HUD 工作台 – 带有实时预览功能的可视化拖放编辑器
- 新增: 基于区域的吸附 – 元素自动吸附到左、中或右区域
- 新增: 间隔元素 – 在元素之间添加垂直间距
? 致谢
- 基于 Fabric 构建
- 字体资源来自开源等宽字体项目
- 灵感源自 Minecraft 模组社区
PowerHUD
A modern, highly customizable HUD overlay mod for Minecraft Fabric, supporting Minecraft 26.3 ("Wilderness Bound") and 1.21.4.
✨ Features
? Performance & Diagnostics
- Real-time FPS Display with color-coded performance indicators
- Animated FPS Dot that pulses based on real-time performance
- Min/Max/Average FPS Tracking with one-key reset capability
- Custom F3 Debug Screen – Cleaner, tabbed debug interface
?️️ Navigation & World Info
- Coordinates Display (XYZ) with current block position
- Facing Direction with cardinal directions and degrees
- Biome Information – Real-time biome detection
- Time Display – In-game clock with day/night and sunset/sunrise indicator
- Gamemode Indicator – Shows current game mode
? Inventory & Equipment
- Visual Inventory Display – Grid, percentage, or fractional count visualization
- Best Tool Suggestions – Displays the optimal tool for the block in crosshairs
- Target Block Information – Displays the exact block you're looking at
- Block Statistics – Tracks blocks mined and placed in the current session
? Survival Stats
- Oxygen Level Indicator – Visual, color-coded oxygen bar for underwater exploration
- Vitality Display – Health and status information
? Default Keybindings
| Key |
Action |
Notes |
U |
Open Config Screen |
Default on Minecraft 26.3 (avoids conflict with vanilla Friends List) |
O |
Open Config Screen |
Default on legacy Minecraft 1.21.4 |
H |
Toggle HUD Visibility |
Instantly show or hide the overlay |
R |
Reset FPS Statistics |
Resets min/max/average FPS trackers |
Z |
Cycle Debug Screen Modes |
Cycles through custom tabbed debug screens |
TIP: All keybindings are fully remappable in Options ➔ Controls ➔ Key Binds under the dedicated PowerHUD category.
? Installation & Compatibility
Choose the release file matching your Minecraft version:
For Minecraft 26.3 (v1.14.0+)
- Minecraft:
26.3
- Fabric Loader:
>= 0.19.5
- Fabric API:
>= 0.161.0+26.3
- Java:
25 LTS
For 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
Steps
- Install Fabric Loader for your Minecraft version.
- Download Fabric API and place it in your
.minecraft/mods folder.
- Download the matching PowerHUD version (
powerhud-1.14.0.jar for 26.3, or powerhud-1.13.0.jar for 1.21.4).
- Place the
.jar file in your .minecraft/mods folder.
- Launch Minecraft using the Fabric profile.
⚙️ Configuration
Press U (or O on 1.21.4) in-game to open the configuration screen.
Available Options
- Toggle Elements: Show or hide individual HUD components.
- Font Selection: Choose from 9 included custom monospace fonts (JetBrains Mono, Roboto Mono, Fira Code, Cascadia Code, Source Code Pro, Comic Mono, Monofur, Ubuntu Mono, Inter Mono).
- Color Customization: Select from 20+ colors for text, data, and titles.
- Bold Titles: Toggle bold formatting for element titles.
- HUD Workbench: Visual drag-and-drop editor featuring:
- Live interactive HUD preview.
- Zone-based snapping (Left, Center, Right).
- Spacer elements for flexible vertical gaps.
- Auto-stacking with precise hitbox alignment.
- Scaling: Adjust global HUD scale from 50% to 250%.
- FPS Tweaks: Configure display complexity (Minimal / Normal / Full), threshold cutoffs, and animated dot indicator.
- Inventory Tweaks: Choose display style (Grid / Percent / Fraction).
- Oxygen Settings: Adjust centered overlay height and toggle vanilla air bubbles.
- HUD Profiles: Save, load, rename, delete, export, and import multiple HUD layouts.
Export & Import Profiles
- Export: Click Export to save the active profile as a
.json file to your home folder.
- Import: Place a file named
import_profile.json in your home folder and click Import to load it into your profile list.
? Roadmap
Under consideration for future updates:
- Animated transitions and fade effects
- Light level indicator
- Armor & tool durability warnings
- Extended session statistics
? Contributing
Contributions and feedback are always welcome!
- Report Bugs: Open an issue on GitHub with steps to reproduce and crash logs.
- Suggest Features: Share ideas in the GitHub issues section.
- Pull Requests: Fork, code, and submit a PR!
? License
This project is licensed under the MIT License.
? Version History
v1.14.1 – (October 2, 2026)
- NEW: Full compatibility with Minecraft 26.3 ("Wilderness Bound")
- NEW: Updated toolchain to Java 25 LTS and Gradle 9.8.0
- NEW: Modernized rendering engine to Minecraft 26.3's
GuiGraphicsExtractor and RenderPearl pipeline
- NEW: Native oxygen bubble bar replacement via Fabric API
HudElementRegistry
- CHANGED: Default configuration key changed from
O to U to avoid conflict with vanilla 26.3 Friends List / Social menu
- NEW: Dedicated PowerHUD category in Controls / Key Binds with full translation support
- FIXED: Workbench layout state persistence and live re-render after closing editor
- FIXED: About screen:** the donation QR code no longer renders as a white box.
v1.13.0 – (February 13, 2026)
- NEW: Accessibility color presets (color blindness, high contrast, dyslexia) are now stored per profile
- CHANGED: 'Default' color preset renamed to 'Off'; manual color selection is only available when 'Off' is selected
- IMPROVED: Accessibility presets enforce dark background and bold data
- README and
version.txt updated to reflect these changes
v1.12.0 – (February 13, 2026)
- NEW: Complete profile management overhaul (save, rename, delete, export, and import profiles)
- Save button always enabled: blank = save to current, text = new/overwrite
- Profile name validation (letters, numbers,
-, _, max 32 chars)
- Visual feedback and tooltips for all profile actions
- Keyboard shortcuts for save/cancel with auto-focus on profile input
v1.11.5 – (February 13, 2026)
- IMPROVED: Profile manager displays the currently loaded profile at the top
- IMPROVED: Profile list includes compact Load (
L) and Delete (x) buttons
- NEW: Delete confirmation dialog prevents accidental profile deletion
- UI fixes for button sizing and layout
v1.11.4 – (February 12, 2026)
- NEW: HUD Profiles – Save/load/delete HUD layouts for quick switching
- IMPROVED: Oxygen overlay UI – Lighter opacity, fixed width, improved text contrast
- IMPROVED: HUD Workbench – Drag boxes align exactly with HUD bounds at any scale
- FIXED: Vanilla air bubble hiding across all bubble states
v1.11.1 – (February 12, 2026)
- NEW: WYSIWYG HUD Workbench – Visual drag-and-drop editor with live preview
- NEW: Zone-Based Snapping – Elements auto-snap to left, center, or right zones
- NEW: Spacer Elements – Add vertical spacing between elements
? Acknowledgments
- Built with Fabric
- Font resources from open-source monospace font projects
- Inspired by the Minecraft modding community
评论 0
登录后参与评分
还没有评论,来抢沙发吧