MiraHUD

MiraHUD

Your Minecraft screen, your rules. MiraHUD is a client-side Fabric mod that puts images, videos and one-click command buttons onto your HUD. Watch a movie while you mine. Pin a reference image to the corner of your screen. Open your ender chest the auction house or the shop without typing a command. No server-side setup needed. Just drop it in your mods folder. You're good to go.

What MiraHUD Can Do Image and Video Overlays You can put anything on top of your game screen. An image, a looping video, a reference sheet, a map. Wherever you want it at whatever size feels right.

Stack many overlays as you want. Images, videos whatever combination you need. Each one gets its position, size, opacity and anchor point. No hard limits.

much any image format works. PNG, JPG, WEBP, TGA, BMP, GIF. Random stuff you downloaded off the internet. It handles all of them.

Pixel- positioning. Set exact X and Y coordinates, resize freely lock the aspect ratio so nothing stretches. Opacity goes from solid down to a barely-visible 1%, which is great for subtle reference overlays.

Five anchor points. Snap overlays to any corner or the center. They stay put regardless of what resolution you run at.

Drag Mode. If you don't want to mess with numbers just drag the overlay around until it looks right. Right-click snaps it back to an anchor point.

preview. Every change you make shows up on screen immediately before you even close the settings menu. No. Reopening to see what you did.

A Real Video Player Inside Minecraft This is not some baked experiment. MiraHUD runs a FFmpeg video pipeline. Your videos play with their audio track and they stay in sync.

Plays pretty much everything. MP4, MKV, WEBM, AVI, MOV, FLV, WMV. If its a video format it probably works.

Audio that actually stays in sync. The audio track is the master clock. Video frames are held back to their presentation timestamps so the sound and picture never drift apart. It's frame-accurate, not "close enough."

Full playback controls.. Resume with P. Skip forward or back 10 seconds with the arrow keys. Restart from the beginning with R. Toggle looping on or off.

Loop mode is seamless. No flicker, no reloading no GPU spikes. It just restarts cleanly.

Per-overlay volume control. Each overlay has its volume slider and it respects your Minecraft master volume too. You can have a video in one corner and a quiet one in another.

FFmpeg handles itself. If you don't have FFmpeg installed MiraHUD quietly downloads a build in the background while you keep playing. Your own FFmpeg installation (if you even have one) is never touched, moved or modified. On Windows this is fully automatic. On platforms you can install FFmpeg through your package manager.

Self-healing playback. If a video pipeline crashes or a file fails to load MiraHUD notices, backs off and retries on its own. It doesn't just freeze on a frame and give up.

One-Click Inventory Widgets If you're tired of typing /ec. Over and over MiraHUD puts those commands into your inventory screen as clickable buttons.

Six built-in widgets: Ender Chest, Auction House, Sell, Trash, Shop and Market. Click once the command fires. Done.

auto-layout. Widgets line up neatly next to your inventory. If there are many for one row they automatically wrap to a second row. You don't have to arrange anything by hand.

Toggle each widget. Don't use the Trash widget? Turn it off. Want all six? Turn them all on. Press I to open the widget manager where you can flip the ones you want. Each widget shows a tooltip so you know what command it runs.

The entire inventory HUD can be turned off. If you want a clean vanilla inventory for a while flip the master switch in the widget manager. Turn it on when you need your buttons again. You're always in control of what shows up.

Custom widget support. If you're a developer you can build your widgets with custom icons, item textures and click behavior.

Configuration That Just Works Nothing is hidden in config files. Everything is straightforward.

Everything saves automatically. Overlay positions, sizes, volumes which widgets are enabled. All written to clean JSON files inside config/mirahud/. Everything comes back how you left it the next time you launch.

Overlay presets. Got an overlay set up how you like it? Save it as a named preset. Reapply it later with one click. Cycle through your saved presets for games or situations.

A real file picker. Click Browse. You get your operating systems actual file dialog. It runs on a background thread so the game never freezes while you look for a file.

path resolution. Typed a path wrong. Pasted something weird? MiraHUD automatically searches your Videos, Downloads, Desktop and Documents folders by filename. Fixes the path for you. It's surprisingly good at finding things.

Quick Controls Every keybind can be changed in the vanilla Minecraft Controls menu.

Key | What It Does

O | Open the Overlay Config screen. Add, tweak and position your overlays

K | Toggle all overlays on or off at once (handy for screenshots or cutscenes)

I | Open the Inventory Widget manager. Toggle widgets or the whole HUD

P | Pause or resume whatever video is currently playing

Right Arrow | Skip forward 10 seconds

Left Arrow | Skip backward 10 seconds

R | Restart the video from the beginning

What You'll Need Minecraft 1.21.11

Fabric Loader 0.19.3 or newer

Fabric API

Java 21 or newer

MiraHUD is completely client-side. Install it on your machine. It works on any server. Vanilla, modded, minigames, anything. The server doesn't need anything installed. On Windows video overlays automatically download a portable FFmpeg build the time you use them. On platforms install FFmpeg through your package manager (apt, brew, pacman, etc.).

Installation Install Fabric Loader for Minecraft 1.21.11. Drop the Fabric API jar into your mods folder.

Drop the jar into your mods folder.

Launch the game. Press O to open the overlay config. Start setting things up.

Building from Source

./gradlew build

The compiled jar lands, in build/libs/.

License MiraHUD is released under the MIT License.