
Modrinth · Minecraft mod
HUD Lib
A library mod that provides a simple way for other mods to add HUD that can be moved with a visual editor.
Quick answer
Which HUD Lib release should I use?
HUD Lib 1.2.1+1.21.9 targets 1.21.9, 1.21.10, 1.21.11 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 4 required mods have matching files.
Where it goes
Is HUD Lib required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does HUD Lib 1.2.1+1.21.9 need?
1.2.1+1.21.9. Change the file and its required mods may change too.
Install YetAnotherConfigLib (YACL), Mod Menu, Fabric API, Text Placeholder API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add HUD Lib without breaking your instance.
Built for HUD Lib 1.2.1+1.21.9. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.2.1+1.21.9. It targets 1.21.9, 1.21.10, 1.21.11 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install YetAnotherConfigLib (YACL), Mod Menu, Fabric API, Text Placeholder API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.2.1+1.21.9. It opens that exact file at the source.
About this project
What does HUD Lib add?
Hud Lib
This mod is a library for other mods to register their own HUD Elements. These HUD Elements has inbuilt repositioning, anchoring, and configuration. They can all be edited after pressing RIGHT SHIFT (Can be rebinded in Key Binds). This mod has no default elements, you will need a mod such as Generic Hud (mentioned below) if you want any features.
Mods using this library
Currently there are 3 mods that uses this library:
The Editor
The editor allows you to reposition and disable any HUD Elements. If you want to hide the Settings button or stop snapping, hold CTRL. The settings menu will allow you to configure each HUD Element, and disable them/reset their position in the 'Generic HUD Options' tab.

For Developers
Currently no documentation exists, but you can use Generic HUD, Armor HUD or the internal HUD Lib testmod as an example, because they are all open source.
What is offered in the library?
- A simple way to render HUD elements, using
DrawContext, when rendering it you are also given an X and a Y coordinate which is where on the screen it should be rendered. - With minimal extra setup they can be repositioned in the editor.
- The repositioning also anchors to the screen (e.g. If you put it in the top right corner, it will stay there with any screen size)
- A way to register your own configuration in the "HUD Lib" configuration screen, this is done with YetAnotherConfigLib (YACL)
- They can also be hidden to only show in the editor, or completely disabled in the configuration.
Versions
The mod has been ported to all 1.21.X versions.
Project description from Modrinth.
Pick your setup
HUD Lib by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader build1.21.3
1 loader build1.21.2
1 loader build1.21.1
1 loader build1.21
1 loader buildShowing the newest 12 of 16 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
HUD Lib versions and loaders
1.2.1+1.21.9
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.21.6
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.21.1
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.21
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.20.5
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.20.4
hudlib-1.2.1.jar
7 Dec 2025
1.2.1+1.20.1
hudlib-1.2.1.jar
7 Dec 2025
1.2.0+1.21.9
hudlib-1.2.0.jar
2 Dec 2025
1.2.0+1.21.6
hudlib-1.2.0.jar
12 Nov 2025
1.2.0+1.21.1
hudlib-1.2.0.jar
10 Nov 2025
1.2.0+1.20.5
hudlib-1.2.0.jar
9 Nov 2025
1.2.0+1.20.4
hudlib-1.2.0.jar
9 Nov 2025
Looking for an older file? The official Modrinth project page is in Resources.