Minescript HUD Addon
Minescript HUD Addon lets Minescript scripts draw custom HUD elements, including text, shapes, items and textures, on the client screen.
What it does
Scripts can place text, rectangles, gradient rectangles, items, textures and custom shapes on the screen as HUD elements. Each element can be animated by changing its properties over time with animation functions, and can report mouse hover and click events. Display duration and a layer system control which elements appear, and elements on higher layers are drawn above those on lower layers.
The addon requires Fabric API and Minescript, and it runs on Fabric for 1.21.6 – 26.1.2, with eight release versions published. Only the client needs it. The code is released under the GNU General Public License v3.0 only and is open source. Source code, an issue tracker and a wiki are public, and the wiki holds the detailed API overview.
Key features
Text and shapes
Elements can show plain text, text with a background, advanced text, rectangles and gradient rectangles.
Items and textures
Scripts can render item icons, image textures and custom shapes as HUD elements.
Animated properties
Animation functions change element properties over time, so text and backgrounds can move or fade.
Mouse events
Elements detect hover and click events, so a script can respond when a player points at or clicks an element.
Layers and duration
Each element has a render layer and a display duration, which together decide what is visible and what draws on top.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Use cases
Status overlays
A script can show health, timers or other values as text on a background, updated while the game runs.
Interactive panels
Clickable elements let a script build simple menus or buttons on top of the game screen.
Who it’s for: Players and script writers who already use Minescript and want their scripts to draw on the HUD. It is not needed for plain play without Minescript scripts.
How it compares
Minescript Addons is open source under the MIT License, runs on Fabric for 1.21.5 – 1.21.11 and is client-side only, so it covers a different part of the scripting setup. PureHUD is client-side only for 1.21.11 – 26.2 under All rights reserved, and its code is not open source. Simple Hud is client-side only for 1.21 – 1.21.1 under the MIT License and is not open source, so it does not cover the current versions.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Minescript HUD Addon | Fabric | 1.21.6 – 26.1.2 | Client-side only | 2026-08-14 |
| Minescript Addons | Fabric | 1.21.5 – 1.21.11 | Client-side only | 2026-07-19 |
| PureHUD | Fabric | 1.21.11 – 26.2 | Client-side only | 2026-09-19 |
| Simple Hud | Fabric | 1.21 – 1.21.1 | Client-side only | 2025-08-27 |
Questions
Does Minescript HUD Addon need Minescript installed?
Which game versions does the addon support?
Does the server need the addon?
In the catalog
Minescript HUD Addon is one of 8,499 Technology mods on ModsFinder, and one of 4,201 Technology mods for Fabric. 15,189 mods support Minecraft 26.1.2.
Similar mods
What the author says
This mod adds the ability to draw custom HUD elements in Minescript. For rendering objects in the world, I will be making a seperate mod.
Official listing
- Modrinth page
- modrinth.com/mod/minescript-hud-addon
- Owner
- maksymiblue12
- Published
- 2026-03-08
- Updated on Modrinth
- 2026-08-14
- Facts verified
- 2026-10-15