Back to mods
HUD Lib project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which HUD Lib release should I use?

Updated 8 months ago
Latest stable file 1.2.1+1.21.9
Game version 1.21.9, 1.21.10, 1.21.11
Loader Fabric

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.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 4 required mods have matching files

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.

3 listed on this file 1 pulled in by one of those mods
Mod Menu Needed by HUD Lib 1.2.1+1.21.9
required
Matching file found Matched file: 17.0.0
Fabric API Needed by HUD Lib 1.2.1+1.21.9
required
Matching file found Matched file: 0.141.6+1.21.11

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 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.

GUI Editor

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.

16 available setups

Showing 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

17 of 17 releases match

Looking for an older file? The official Modrinth project page is in Resources.