Resource Bar Renderers (resource_bar_render_data_type)

The renderer field of a resource bar picks a draw mode, and the type goes inside renderer. Bars are written in the inline bars of a resource.

This family is registered by the mod; a data pack picks one, it cannot add a new one. The default footprint is 71x8; only a renderer that overrides the size differs.

mxt:boss_bar

An Origins-style bar with an icon: background, fill and a column of 8x8 icons are cut out of one sprite sheet, and the icon shares the row index with the bar.

Field	Type	Default	Description
sprite_location	SpriteIcon, textures only	mxt:textures/gui/resource_bar.png	Sprite sheet
bar_index	Integer, 0..24	0	Which bar of the sheet to use
icon_index	Integer, 0..24	bar_index	Which icon of the sheet to use
inverted	Boolean	false	Reverses the fill direction

{"type": "mxt:boss_bar", "bar_index": 1}

mxt:textured_bar

Draws a background and a fill, each at the width and height the bar declares.

Field	Type	Default	Description
background_sprite	SpriteIcon	required	Background
fill_sprite	SpriteIcon	required	Fill
width	Integer, 1..1024	required	Width
height	Integer, 1..1024	required	Height
fill_color	RGB color	#FFFFFF	Fill tint
show_value	Boolean	false	Whether the current value is drawn on the bar

{
  "type": "mxt:textured_bar",
  "background_sprite": {"texture": "example:textures/gui/qi_bar.png"},
  "fill_sprite": {"texture": "example:textures/gui/qi_bar_fill.png"},
  "width": 71,
  "height": 8,
  "fill_color": "#66CCFF"
}

mxt:segmented_bar

Discrete segments, 8 pixels each.

Field	Type	Default	Description
segments	Integer, 1..256	required	Number of segments
gap	Integer, 0..32	1	Gap between segments
full_color	RGB color	#FFFFFF	Color of a filled segment
empty_color	RGB color	#555555	Color of an empty segment

{"type": "mxt:segmented_bar", "segments": 10, "gap": 2, "full_color": "#66CCFF"}

mxt:radial_bar

A ring.

Field	Type	Default	Description
radius	Integer, 1..512	required	Radius
thickness	Integer, 1..128	required	Thickness of the ring
start_angle	Double	0	Start angle in degrees
end_angle	Double	360	End angle in degrees
fill_color	RGB color	#FFFFFF	Fill tint

{"type": "mxt:radial_bar", "radius": 16, "thickness": 3, "fill_color": "#66CCFF"}

mxt:text_only

Draws text and no bar.

Field	Type	Default	Description
format	String	%current%	Text format
color	RGB color	#FFFFFF	Text color
show_maximum	Boolean	false	Whether the maximum is appended when the format has no %maximum%

{"type": "mxt:text_only", "format": "%current% / %maximum%", "color": "#66CCFF"}

%current% and %maximum% in the format are replaced with the current value and the maximum; show_maximum appends the maximum only when the format itself has no %maximum%.

mxt:missing

Placeholder render data with no visual output.

Field	Type	Default	Description
—	—	—	No fields.

{"type": "mxt:missing"}

---

A segmented bar is segments * 8 + (segments - 1) * gap pixels wide, and a radial bar occupies radius * 2 + thickness pixels in both directions. mxt:boss_bar, mxt:text_only and mxt:missing use the default 71x8, mxt:textured_bar uses the width and height it declares. Colors are written as #RRGGBB (an integer or an [r,g,b] float array is accepted too) and are always treated as opaque. Drawing happens on the client, and only values synchronized from the server are shown.

sprite_location of mxt:boss_bar and both artwork fields of mxt:textured_bar take a SpriteIcon, not a bare Identifier. A bare string keeps the field's original meaning: sprite_location is a texture path, while background_sprite / fill_sprite are GUI atlas sprites. The object form names either a GUI atlas sprite with {"sprite": ...} or one texture with {"texture": ...}.

region cuts one piece out of a texture and its fields are u / v / texture_width / texture_height (the origin defaults to 0,0 and the whole image to 256x256); width / height give the target size it is drawn at, must be written as a pair, and when omitted the bar's own width and height are used.

Three load-time constraints: mxt:boss_bar cuts background, fill and icon cells out of its sheet, so sprite_location accepts textures only; a sprite cannot declare a region; and exactly one of sprite and texture must be written in an object — both or neither is an error, and so is writing only one of width / height.

Size belongs to the background side only: background_sprite and the sheet texture of mxt:boss_bar may carry width / height, while a size written on fill_sprite has no effect — the fill is cut by the bar's own progress, a fixed size means nothing there, those two keys take no part in drawing, and only the background's size is drawn.

A SpriteIcon is not the same value as the icon reference used by ability.icon / resource.icon: an icon reference is one 16x16 texture or one item drawn in a single cell, it has no region / width / height and does not accept {"sprite": ...}; conversely a SpriteIcon cannot be written as an item either.