Modscraper Modscraper Minecraft
Minescript HUD Addon logo

Minescript HUD Addon

Mod

This mod adds the ability to draw custom HUD elements in Minescript.

Type

Mod

Modrinth Downloads

858

Modrinth ID

dhLcoQk3

Last Updated

May 28, 2026

Description

Minescript HUD Addon

This mod adds the ability to draw custom HUD elements in Minescript.

Documentation can be found in the wiki.

Status

If you have any suggestions, or found any bugs, please fill out this google form.

Features

  • Draw text on the HUD
  • Draw rectangles and gradient rectangles
  • Render items
  • Render textures
  • Render custom shapes
  • Animate all element properties
  • Control display duration and render layers

Installation

  1. Install Minescript.
  2. Place this addon in your mods folder.
  3. Launch the game.

Example

from hud_renderer import * add_text("Hello World",x=10,y=10,color=argb(255,255,255,255),shadow=True,display_duration=5)

Animations

All HUD elements can be animated using animation functions.

from hud_renderer import * def move(text:TextObject): text.x+=1 _id=add_text("I can MOVE!",x=10,y=10,color=Colors.WHITE,shadow=True,display_duration=5) animate_text(_id,move)

Layer System

Elements are rendered in layers. Elements with higher layer values render above elements with lower layers.

API Overview

A more detailed API can be found on the wiki.

Text

  • add_text(...)
  • add_text_with_background(...)
  • add_advanced_text(...)
  • add_advanced_text_with_background(...)
  • animate_text(...)
  • animate_text_with_background(...)

Rectangles

  • add_rectangle(...)
  • add_rectangle_from_corners(...)
  • add_gradient_rectangle(...)
  • add_stroked_rectangle(...)
  • animate_rectangle(...)

Items

  • add_item(...)
  • add_advanced_item(...)
  • animate_item(...)

Textures

Note: Custom textures must be added by a resource pack in the assets/minescripthud/textures/gui/sprites/ folder.

  • add_texture(...)
  • add_advanced_texture(...)
  • animate_texture(...)

Shapes

  • add_shape(...)
  • add_advanced_shape(...)
  • animate_shape(...)
  • add_line(...)
  • add_multiline(...)
  • add_triangle(...)
  • add_quad(...)
  • add_circle(...)
  • add_ellipse(...)

Utility functions

  • argb(...)
  • argb_to_int(...)
  • remove_element(...)
  • clear()
  • suppress_done_message()

Compatibility

Mod Loaders

Fabric

Game Versions

1.21.6 1.21.7 1.21.8 1.21.10 1.21.11 26.1 26.1.2

Screenshots

Similar Mods

External Resources