MiraHUD

MiraHUD

你的 Minecraft 屏幕，你来定规则。MiraHUD 是一个客户端 Fabric 模组，可将图片、视频和一键命令按钮添加到你的 HUD 上。边挖矿边看电影。将参考图钉在屏幕角落。无需输入命令即可打开末影箱、拍卖行或商店。无需服务端设置。只需将其放入 mods 文件夹即可。一切就绪。

MiraHUD 能做什么 图片和视频覆盖层 你可以将任何内容置于游戏画面之上。一张图片、一个循环视频、一份参考表、一张地图。想放哪里就放哪里，想多大就多大。

可以叠加任意数量的覆盖层。图片、视频或任意组合，按需搭配。每个覆盖层都有其位置、大小、不透明度和锚点。没有硬性限制。

几乎所有图片格式都适用。PNG、JPG、WEBP、TGA、BMP、GIF，甚至是你从网上下载的杂七杂八的文件，都能处理。

像素级定位。设置精确的 X 和 Y 坐标，自由调整大小，锁定纵横比防止拉伸。不透明度可从完全不透明调至几乎不可见的 1%，非常适合微妙的参考覆盖层。

五个锚点。可将覆盖层吸附到任意角落或中心。无论你使用何种分辨率，它们都会保持在原位。

拖拽模式。如果你不想费力调整数字，直接拖拽覆盖层直到看起来合适即可。右键单击即可将其吸附回锚点。

实时预览。你做出的每一项更改都会立即显示在屏幕上，甚至无需关闭设置菜单。无需反复开关来查看效果。

Minecraft 内置真正的视频播放器 这不是某个粗略的实验。MiraHUD 运行一套 FFmpeg 视频管线。你的视频会连同音轨一起播放，并保持同步。

几乎播放所有格式。MP4、MKV、WEBM、AVI、MOV、FLV、WMV。只要是视频格式，基本都能播放。

音频真正保持同步。音轨为主时钟。视频帧会按照其显示时间戳被保持，确保声音和画面不会漂移。这是帧级精确的，而不是“差不多就行”。

完整的播放控制。按 P 暂停或恢复。使用方向键快进或快退 10 秒。按 R 从头重新开始。可切换循环播放开关。

无缝循环模式。无闪烁、无重新加载、无 GPU 峰值。它会干净利落地重新开始。

每个覆盖层独立音量控制。每个覆盖层都有自己的音量滑块，同时也会遵循你的 Minecraft 主音量。你可以让一个视频在一个角落发声，另一个角落安静播放。

FFmpeg 自行处理。如果你没有安装 FFmpeg，MiraHUD 会在你继续游戏时于后台静默下载一个构建版本。你现有的 FFmpeg 安装（如果有的话）永远不会被触碰、移动或修改。在 Windows 上这完全是自动的。在其他平台上，你可以通过包管理器安装 FFmpeg。

自我修复播放。如果视频管线崩溃或文件加载失败，MiraHUD 会检测到问题，自动退避并重试。它不会卡在一帧上就放弃。

一键背包小部件 如果你厌倦了一遍又一遍地输入 /ec，MiraHUD 可以将这些命令作为可点击按钮放入你的背包界面。

六个内置小部件：末影箱、拍卖行、出售、垃圾桶、商店和市场。单击一次命令即触发。完成。

自动布局。小部件会在你的背包旁整齐排列。如果一行放不下多个，它们会自动换行到第二行。你无需手动安排任何东西。

可切换每个小部件。不使用垃圾桶小部件？关掉它。想要全部六个？全部开启。按 I 打开小部件管理器，在那里可以切换你想要的。每个小部件都会显示提示文本，让你知道它运行什么命令。

整个背包 HUD 可以关闭。如果你想暂时要一个干净的原版背包界面，可以切换小部件管理器中的主开关。当需要按钮时再重新开启。你始终掌控屏幕上的显示内容。

自定义小部件支持。如果你是开发者，你可以构建自定义小部件，包含自定义图标、物品纹理和点击行为。

开箱即用的配置 不会有任何东西隐藏在配置文件中。一切都很直观。

所有内容自动保存。覆盖层位置、大小、音量、启用了哪些小部件，都会写入 config/mirahud/ 下的整洁 JSON 文件中。下次启动时，所有内容都会恢复到你离开时的状态。

覆盖层预设。设置好一个满意的覆盖层？将其保存为命名预设。之后一键即可重新应用。可在不同游戏或场景中循环切换保存的预设。

真正的文件选择器。点击“浏览”。你会看到操作系统原生的文件对话框。它在后台线程中运行，因此你在寻找文件时游戏不会卡顿。

路径修正。路径输入错误，或粘贴了奇怪的东西？MiraHUD 会自动按文件名搜索你的视频、下载、桌面和文档文件夹，为你修正路径。它找东西的能力出乎意料地好。

快速控制 所有按键绑定都可以在原版 Minecraft 控制菜单中修改。

按键 | 功能

O | 打开覆盖层配置界面。添加、调整和定位你的覆盖层

K | 一键切换所有覆盖层的开/关（方便截图或过场动画）

I | 打开背包小部件管理器。切换小部件或整个 HUD

P | 暂停或恢复当前正在播放的视频

右箭头 | 快进 10 秒

左箭头 | 快退 10 秒

R | 从头开始重新播放视频

你需要什么 Minecraft 1.21.11

Fabric Loader 0.19.3 或更高版本

Fabric API

Java 21 或更高版本

MiraHUD 完全是客户端的。安装在你自己的机器上。它适用于任何服务器。原版、模组、小游戏，什么都可以。服务器端无需安装任何东西。在 Windows 上，视频覆盖层会在首次使用时自动下载一个便携版 FFmpeg 构建。在其他平台上，通过你的包管理器（apt、brew、pacman 等）安装 FFmpeg。

安装步骤 为 Minecraft 1.21.11 安装 Fabric Loader。将 Fabric API 的 jar 文件放入 mods 文件夹。

将 jar 文件放入 mods 文件夹。

启动游戏。按 O 打开覆盖层配置。开始设置。

从源码构建

./gradlew build

编译后的 jar 文件位于 build/libs/ 中。

许可证 MiraHUD 以 MIT 许可证发布。