Description
A client-side mod that allows displaying various "info lines" on the screen ("mini-F3"). The alignment (screen corner), background and text color and font size are configurable. Note: This is a client-side-only mod! You can't put it on a server.
The mod also has various "overlay renderers", such as:
- Structure Bounding Boxes (These only work in single player, without a server-side mod! Currently the only server-side mods that send the data in a format that MiniHUD knows about are Servux and QuickCarpet. If you have FabricCarpet, then you also need Servux.
- Spawn Chunks
- Light Level overlay with markers and/or numbers (configurable)
- Region File Boundaries
- Random Tick range
- Shapes: A mob Despawn Sphere, plus 24 and 32 block Spawn Spheres, a generic configurable radius Sphere, a Circle/Cylinder. More shapes are also planned.
- Block Grid
- Mob spawn algorithm chunks range (< 1.14 only, in 1.14+ it's the same as the random ticked chunks)
- Height map (used by the mob spawn algorithm)
(note that many of these currently are only available in the more recent LiteLoader, Rift and Fabric versions.)
The mod also adds hotkeys for toggling on/off the vanilla debug renderers for blocks collision boxes, heightmap, entity path finding etc.
The displayed information lines can also be toggled on/off with hotkeys, and the HUD itself can be toggled ON and OFF.
Some example screenshots are on the Images page.
Generic info
- The default in-game config menu hotkey is H + C
- The default on/off toggle key is H
- You can provide the world seed for MiniHUD (only used for the Slime Chunks info line and overlay) in multiplayer either by running the vanilla /seed command if you have the permission, or you can give it manually with a regular chat message in the form minihud-seed 12345. In single player the mod grabs the seed directly.
NOTE: MiniHUD also requires the MaLiLib library mod.
Be sure to download the correct version of both mods from the Files page!
https://www.curseforge.com/minecraft/mc-mods/malilib
Overlay colors are all opaque, what to do?!
In the current 0.19.0-dev versions for MC 1.16+, there are a bunch of features that are temporarily ported over from the main development version on 1.12.2. Due to it being a temporary port, I didn't bother trying to fix everything that is broken due to there being missing things in malilib, and there is currently also a bug in malilib's Color Edit menu in 1.13.2+ which causes the alpha channel (transparency) to reset to fully opaque when you use the Color Editor menu.
So currently, until the new malilib and other mod updates with the latest code from 1.12.2 can happen, you just have to manually fix the color value after using the color editor. Basically you just need to change the first two letters (after the #) in the hex color code from FF (fully opaque) to something between 30 to 60 or so, and then toggle off/on the overlay or shape in question to update it.
Different mod loaders vs. mod versions
Be sure to download the correct version for the mod loader you are using!
The newer builds will all include the mod loader name in the mod filename.
(Also note that the 1.13.2 versions ONLY work on MC 1.13.2, and NOT on the earlier 1.13 versions!)
For MC 1.14.x there are currently versions for the Fabric mod loader, those versions have '-fabric' in their filename.
Future Forge versions will also include -forge in the mod file name.
Key combinations
The mod's main rendering toggle key is by default H.
The in-game config menu hotkey is by default H + C.
Recent MiniHUD versions that use malilib
For the more recent versions of MiniHUD that use malilib, all the hotkeys are in MiniHUD's own in-game config menu, which by default opens with H + C.
Old Forge versions of MiniHUD
For the old Forge versions of the mod, the keybinds can be changed in the vanilla Controls menu.
For the old Forge versions:
- Toggle Mode key (by itself): Toggle the HUD state ON/OFF.
- Toggle Mode key + "info key": Toggle ON/OFF the different pieces of information (the keys can be set in the mod configs).
Available information
NOTE: The information below this is outdated and doesn't include everything that is in the recent LiteLoader, Rift and Fabric versions of the mod.
Look through the in-game config menu to see everything that is available in addition to the things mentioned below.
The following information is currently available:
- Real time (ie. a clock...)
- World time in ticks
- World time formatted to days, hours, minutes
- Player's current block position
- Player's current position in chunk
- Player's coordinates
- Player's current dimension ID
- Player's yaw rotation
- Player's pitch rotation
- Player's current moving speed
- Player's facing
- The Chunk the player is currently in
- The region file the player is currently in
- Looked-at-entity's name and health
- Looked-at-entity's registry name (1.11+) or ID (1.10.2)
- The block the player is looking at
- Block's registry name and the BlockState properties of the looked-at-block (like on the F3 screen)
- Current light level
- Current biome
- Current biome's registry name.
- Current FPS
- Entity count
- C value (rendered chunk sections) from F3
- P value (number of particles) from F3
- Current local difficulty number (from F3)
- Is the current chunk a slime chunk. Note: in multiplayer you need to manually run the /seed command!
Starting from version 0.13.0, there is now a region file boundary overlay renderer. The default hotkey to toggle it ON/OFF is Toggle (H) + J.
Note: Starting from version 0.9.0, you can change all these quick toggle keys via the config file or the in-game config menu.
Note: Starting from version 0.11.0, you can change the order of these info lines via the config file or the in-game config menu.
To temporarily (= not saved in the configs) toggle the info types while in-game, do this:
- In version 0.9.0 or later, press and hold the main Toggle key, and then press the configured hotkey for the info type you want to toggle
- Before version 0.9.0, first press and hold the indicated info type key and then press the Toggle key
Old Configuration options
Below are the bit mask values for the different information types. This is now redundant, just use the on/off options in the in-game config menu instead!
These were removed entirely in version 0.11.0.
- 1 = coordinates
- 2 = yaw
- 4 = pitch
- 8 = speed
- 16 = biome
- 32 = light level
- 64 = facing
- 128 = block position
- 256 = chunk position
- 512 = block looking at
- 1024 = fps
- 2048 = entity count
- 4096 = dimension id
- 8192 = world time (ticks)
- 16384 = world time (formatted)
- 32768 = IRL time (ie. a clock)
- 65536 = looking at entity
- 131072 = slime chunk
- 262144 = blockstate properties
Configuration
There are a few things that can be adjusted either via the in-game configuration menu or in the configuration file.
- The information to be displayed on the Info Lines HUD
- Font scale factor
- The font and backgrond colors
- Whether to use a font shadow in the text rendering
- Whether to use a background color for the text
- Whether to sort the displayed information lines by their length
- Whether to reverse the above mentioned sorting order
- Whether to use a custom format string for the coordinate line, and the format string to use
- Multiple options to configure the Light Level overlay
- The colors of all the overlay renderers
Note: The custom format string for the coordinates has to have three float number format specifiers.
An example of that would be "X: %.1f Y: %.1f Z: %.1f" (without the quotes) to give an output like: X: 1234.2 Y: 64.0 Z: 4321.7.
Vanilla debug renderers
Starting from mod version 0.12.0, there are hotkeys to toggle ON/OFF the debug renderers that exist in vanilla, but are normally not usable/accessible. The hotkeys for these can be set in the Hotkeys config category. Note: The neighbor updates debug renderer only works in single player.
Note: The pathfinding debug renderer also only works in single player, unless another mod sends the appropriate custom payload vanilla packet from the server, to add the path data to the debug renderer. Currently I'm not aware of any such mods however.
Some example screenshots of the debug renderers: Collision boxes:
Height map:
Neighbor updates:
Pathfinding:
Solid block faces:
Water:
Snapshot versions and latest development builds
There are (at least at times) versions of my mods available for the latest Minecraft snapshots here: https://masa.dy.fi/mcmods/client_mods/
That page also sometimes includes newer development builds than what is available here on CurseForge.
If you encounter bugs, then try to update all the mods (from the ones that you use) from that page to see if the issue has been fixed already.
(There are at times changes in malilib or the mods that require both of them to be updated at the same time!)
If you have questions or need help with something, the best/fastest way to get answers is on my Discord server.
I suggest adding an "overlaySculkSensorRange." Basically shows the 3D range of Sculk Sensor vibration pickup.
I think I have encountered a bug. Playing a server the "infoBeeCount" does not work. It always says there are 0 bees in the hive. It does work in a single-player world, however. The server does have Servux installed. The version game version is 1.19.3
In reply to WeatheredSphere:
Neither MiniHUD nor Servux have support for block entity data sync yet. It will arrive once the (still WIP) rewritten/cleaned up mod code from 1.12.2 gets ported to the modern MC versions.
In reply to masady:
Ahh ok. Thanks for clearing that up!
I downloaded this mod to view the bounding box of an Ancient City, but unfortunately there is no option to do so. Is that something that could be implemented in the future or does it just not work for some reason?
In reply to SombreroKid:
I had totally forgotten that got added as a new structure. Did you try the "Unknown" option? I think it should show it (and any other structures that haven't been specifically added to the configs), assuming it has a structure bounding box. (And the usual thing still applies with bounding boxes - they only work in single player, unless the server has the Servux mod installed on it.)
In reply to masady:
The "Unknown" option worked. Thanks!
Hey! I know there is no forge version yet, and I don't mean at all to put any pressure on you, but do you know any forge alternatives for getting an overlay of a radius? Trying to figure out how much I need to light up for a mob farm.
In reply to sylviathepotato:
The Bounding Box Outlines Reloaded mod is the closest one that I know of. But I don't really know much of anything about the available mods these days, there may be many other ones as well.
In reply to sylviathepotato:
Check vanillatweaks for the spawning spheres datapack. It should work with all versions of Minecraft.
Well, for some reason whenever i toggle on or off the ShapeRenderer or just the option to see the light level on the floor my minecraft crashes, but when i open it up again and enter the world, that thing that i turned on before the crash is there turned on. I play on 1.19.2 and already tried to change the version of the fabric and of the mod. Could you help me?
In reply to yukari_kin:
Post the crash log. Does it also crash if you have only malilib and MiniHUD installed and no other mods?
In reply to masady:
---- Minecraft Crash Report -------- Minecraft Crash Report ----// Daisy, daisy...
Time: 2023-01-01 19:41:57Description: Unexpected error
java.lang.NoSuchFieldError: field_11733 at fi.dy.masa.malilib.util.InfoUtils.printActionbarMessage(InfoUtils.java:146) at fi.dy.masa.malilib.util.InfoUtils.printBooleanConfigToggleMessage(InfoUtils.java:178) at fi.dy.masa.malilib.hotkeys.KeyCallbackToggleBooleanConfigWithMessage.onKeyAction(KeyCallbackToggleBooleanConfigWithMessage.java:18) at fi.dy.masa.minihud.hotkeys.KeyCallbackToggleRenderer.onKeyAction(KeyCallbackToggleRenderer.java:34) at fi.dy.masa.malilib.hotkeys.KeybindMulti.triggerKeyAction(KeybindMulti.java:185) at fi.dy.masa.malilib.hotkeys.KeybindMulti.updateIsPressed(KeybindMulti.java:145) at fi.dy.masa.malilib.event.InputEventHandler.checkKeyBindsForChanges(InputEventHandler.java:270) at fi.dy.masa.malilib.event.InputEventHandler.onKeyInput(InputEventHandler.java:143) at net.minecraft.class_309.handler$zba000$onKeyboardInput(class_309.java:583) at net.minecraft.class_309.method_1466(class_309.java:316) at net.minecraft.class_309.method_22678(class_309.java:462) at net.minecraft.class_1255.execute(class_1255.java:103) at net.minecraft.class_309.method_22676(class_309.java:462) at org.lwjgl.glfw.GLFWKeyCallbackI.callback(GLFWKeyCallbackI.java:44) at org.lwjgl.system.JNI.invokeV(Native Method) at org.lwjgl.glfw.GLFW.glfwPollEvents(GLFW.java:3403) at com.mojang.blaze3d.systems.RenderSystem.flipFrame(RenderSystem.java:197) at net.minecraft.class_1041.method_15998(class_1041.java:315) at net.minecraft.class_310.method_1523(class_310.java:1205) at net.minecraft.class_310.method_1514(class_310.java:768) at net.minecraft.client.main.Main.method_44604(Main.java:244) at net.minecraft.client.main.Main.main(Main.java:51) at net.fabricmc.loader.impl.game.minecraft.MinecraftGameProvider.launch(MinecraftGameProvider.java:461) at net.fabricmc.loader.impl.launch.knot.Knot.launch(Knot.java:74) at net.fabricmc.loader.impl.launch.knot.KnotClient.main(KnotClient.java:23)
A detailed walkthrough of the error, its code path and all known details is as follows:---------------------------------------------------------------------------------------
-- Head --Thread: Render threadStacktrace: at fi.dy.masa.malilib.util.InfoUtils.printActionbarMessage(InfoUtils.java:146) at fi.dy.masa.malilib.util.InfoUtils.printBooleanConfigToggleMessage(InfoUtils.java:178) at fi.dy.masa.malilib.hotkeys.KeyCallbackToggleBooleanConfigWithMessage.onKeyAction(KeyCallbackToggleBooleanConfigWithMessage.java:18) at fi.dy.masa.minihud.hotkeys.KeyCallbackToggleRenderer.onKeyAction(KeyCallbackToggleRenderer.java:34) at fi.dy.masa.malilib.hotkeys.KeybindMulti.triggerKeyAction(KeybindMulti.java:185) at fi.dy.masa.malilib.hotkeys.KeybindMulti.updateIsPressed(KeybindMulti.java:145) at fi.dy.masa.malilib.event.InputEventHandler.checkKeyBindsForChanges(InputEventHandler.java:270) at fi.dy.masa.malilib.event.InputEventHandler.onKeyInput(InputEventHandler.java:143) at net.minecraft.class_309.handler$zba000$onKeyboardInput(class_309.java:583) at net.minecraft.class_309.method_1466(class_309.java:316) at net.minecraft.class_309.method_22678(class_309.java:462) at net.minecraft.class_1255.execute(class_1255.java:103) at net.minecraft.class_309.method_22676(class_309.java:462) at org.lwjgl.glfw.GLFWKeyCallbackI.callback(GLFWKeyCallbackI.java:44) at org.lwjgl.system.JNI.invokeV(Native Method) at org.lwjgl.glfw.GLFW.glfwPollEvents(GLFW.java:3403) at com.mojang.blaze3d.systems.RenderSystem.flipFrame(RenderSystem.java:197)
-- Affected level --Details: All players: 1 total; [class_746['imSunnie'/58, l='ClientLevel', x=76.69, y=1.00, z=-157.01]] Chunk stats: 961, 614 Level dimension: minecraft:overworld Level spawn location: World: (0,0,0), Section: (at 0,0,0 in 0,0,0; chunk contains blocks 0,-64,0 to 15,319,15), Region: (0,0; contains chunks 0,0 to 31,31, blocks 0,-64,0 to 511,319,511) Level time: 47012 game time, 80186 day time Server brand: fabric Server type: Integrated singleplayer serverStacktrace: at net.minecraft.class_638.method_8538(class_638.java:453) at net.minecraft.class_310.method_1587(class_310.java:2341) at net.minecraft.class_310.method_1514(class_310.java:792) at net.minecraft.client.main.Main.method_44604(Main.java:244) at net.minecraft.client.main.Main.main(Main.java:51) at net.fabricmc.loader.impl.game.minecraft.MinecraftGameProvider.launch(MinecraftGameProvider.java:461) at net.fabricmc.loader.impl.launch.knot.Knot.launch(Knot.java:74) at net.fabricmc.loader.impl.launch.knot.KnotClient.main(KnotClient.java:23)
-- Last reload --Details: Reload number: 1 Reload reason: initial Finished: Yes Packs: Default, Fabric Mods
And yes, it also crashes even when i have only malilib and MiniHUD installed without any other mods.
Oh, and happy New Year!
In reply to yukari_kin:
You are using malilib that is for the wrong Minecraft version compared to what you are trying to use.
In reply to masady:
Well, i guess i'm not the smart one, thanks man!
in 1.19.3 i didn't find the Toggled Structure Bounding Boxes option, please help me thanks!
.
Any chance this could get updated to Forge ? Especially 1.18.2 ?
In reply to Sharkieyy:
At some point yes, but that will only happen once I port the newer rewritten code from 1.12.2. Not sure when that will happen, but it's possible that it might happen relatively soon for MiniHUD, as it's getting somewhat close to finishing its rewrites in 1.12.2. So I'll probably relatively soon want to make a "test port" to 1.19.x Fabric and then to 1.18.2 or 1.19.3 Forge to check for any required changes between MC versions and what should still be better abstracted in 1.12.2. If/when those early test ports happen, they will be posted on my Discord, but probably not here (unless I just mark them as alpha builds).
it's making minecraft crash whenever i use a nether portal...
edit: nevermind, it was litematica, i don't know why litematica is doing this. please help.