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

279

Modrinth ID

dhLcoQk3

Last Updated

Apr 12, 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

Fixed error where hud_renderer.py doesn't load

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 draw_text 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 draw_text 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

Screenshots

Similar Mods

External Resources