HUD Icon Lib
HUD Icon Lib is a Fabric library that lets other mods draw customizable graphical icons on the screen through a simple API.
What it does
Other Fabric mods call the library to show icons for status indicators such as health, mana and stamina, for buff and debuff notifications like speed boost or strength, and for quest markers that track objectives. Custom HUD elements and temporary notifications with timers can be built on the same API. Icons can be shown in several at once, and a permanent icon or a timed one is removed automatically after its set duration.
The library is lightweight and needs only Fabric API as an extra dependency. It is a Fabric mod for 1.20.1, and it runs on client and server, so the server and every player need it. Its latest Fabric file, 0.2.0 for 1.20.1, is in the beta channel and was published on 2025-11-25. The code is under All rights reserved, so the library is not open source. A guide in the mod's documentation explains how to add the library as a dependency in fabric.mod.json and how to integrate it into an existing Fabric mod, with a complete example of initialization.
Key features
Status and buff indicators
Icons can display health, mana, stamina, and buff or debuff effects such as speed boost and strength, for other mods to use.
Positioning and size
Icons can be placed anywhere on screen, with the top-left corner as the default, and their default size is 16x16 pixels, which can be adjusted.
Image and text support
Icons load from PNG or JPG files, and optional text labels can sit next to each icon, with Minecraft color codes for colored text.
Code-based configuration
Icons are defined through the API rather than config files, and icon files are stored in a predictable location with IDs prefixed by the mod ID.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Chat Icon API is a client-side only library for Fabric 1.16.5, open source under the MIT License, so it covers chat rather than the HUD. AXHud is a client-side only Fabric mod for 1.21.7 under All rights reserved, and it is not open source. PinLib is open source under the MIT License, runs on client and server, and targets Fabric for 1.19 – 1.19.3, a range that does not include 1.20.1.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| HUD Icon Lib | Fabric | 1.20.1 | Client and server | 2025-11-25 |
| Chat Icon API | Fabric | 1.16.5 | Client-side only | 2021-01-25 |
| AXHud | Fabric | 1.21.7 | Client-side only | 2025-12-13 |
| PinLib | Fabric | 1.19 – 1.19.3 | Client and server | 2022-12-21 |
Questions
Does HUD Icon Lib need Fabric API?
Does the server need HUD Icon Lib installed?
Which Minecraft version does HUD Icon Lib support?
How does a mod add a dependency on HUD Icon Lib?
In the catalog
HUD Icon Lib is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 34,764 mods support Minecraft 1.20.1.
Similar mods
What the author says
✨ Multiple Icons: Display multiple icons simultaneously ⏱️ Timer Support: Icons can be permanent or auto-remove after a set duration 🎯 Flexible Positioning: Position icons anywhere on screen (default: top-left) 📐 Customizable Size: Default 16x16 pixels (inventory item size), fully adjustable 🖼️ Image Support: PNG…
Official listing
- Modrinth page
- modrinth.com/mod/hudiconlib
- Owner
- TheChickenHulk
- Published
- 2025-11-25
- Updated on Modrinth
- 2025-11-25
- Facts verified
- 2026-10-15