Skip to content

XML-Gumps

We’ve added the ability for you to create your own custom gumps via XML
ℹ️ v3.15.0 and up required.

This feature will expand over time, it is not finished.

Your xml files will go under /TazUO/Data/XmlGumps/ and must be named ----.xml

For auto opening specific gumps, ctrl + click them in the Xml Gump Menu that will appear in your top menu bar when you have gump files in the above directory.

An in-game editor builds and edits these gumps without hand-writing XML:

  • Open it with the xmleditor command, Top bar -> More -> Tools -> XML Gump Editor, or the Xml Gumps menu -> XML Gump Editor.
  • New / Open / Save / Save As work on files in Data/XmlGumps/; Export / Import copy the XML to/from the clipboard.
  • The Elements list shows every element in the gump. Add a new element from the palette, Copy (duplicate), Delete, or move it up/down.
  • A live XML Gump Preview window shows the result as you edit. Drag elements on the canvas to position them, or use the arrow keys to nudge the selection.
  • The property panel edits the selected element’s attributes, with dedicated hue and graphic pickers.
  • The help button on the editor lists every text-replacement tag (see Text options).
  • Edits stay in memory until Save. Starting a new gump, opening another file, or importing from the clipboard asks before discarding unsaved changes; closing the editor discards anything not saved.

Files saved by the editor are ordinary .xml gumps and load exactly like hand-written ones.

image

<?xml version="1.0"?>
<gump x="100" y="100">
<colorbox hue="1" width="400" height="200" alpha="0.65"/>
<colorbox hue="32" width="400" height="20" alpha="0.65"/>
<text x="15" y="2" hue="0">XML Gump</text>
<text x="15" y="22" hue="32">With some more text for an example</text>
<text x="15" y="35" hue="35" updates="true">{charname} has /c[green]{hp}/cd hits!</text>
<image id="9819" hue="0" x="20" y="120"/>
<image_progress_bar background_image="40" foreground_image="41" value="{hp}" max_value="{maxhp}" x="15" y="57" updates="true"/>
<color_progress_bar background_hue="32" foreground_hue="60" width="100" height="20" value="{hp}" max_value="{maxhp}" x="15" y="77" updates="true"/>
</gump>

x y
locked true/false if the gump can be moved/closed. (There will be no way to close it if this is true other than logging out)
saveposition true/false if the x/y should be updated when you move the gump in game automatically

All elements accept the following attributes

Section titled “All elements accept the following attributes”

ℹ️ Text element is the only exception here, it does not have all of these applied
x Left position
y Top position
width Width of the element
height Height of the element
acceptmouseinput true/false (false will act like mouse pass through to whatever is behind it)
canmove true/false (If false, dragging on this element will not move the gump as a whole)

Text <text> tag accepts the following attributes

Section titled “Text <text> tag accepts the following attributes”

x Left position
y Top position
width Width of the element
size Font size
font Name of the font(Must be installed in your fonts folder of TazUO)
hue Hue for the font
updates true/false weather or not this needs to be updated, only use this when necessary to keep resource usage down.
align left/center/right

The following can be used inside your text, for example: Hits {hp}/{maxhp}
{charname}
{hp} {maxhp}
{mana} {maxmana}
{stam} {maxstam}
{weight} {maxweight}
{str} {dex} {int}
{damagemin} {damagemax}
{hci} {di} {ssi} {defchance} {defchancemax}
{sdi} {fc} {fcr} {lmc} {lrc}
{phyres} {phyresmax} {fireres} {fireresmax}
{coldres} {coldresmax} {poisonres} {poisonresmax}
{energyres} {energyresmax}
{maxstats} {luck} {gold}
{pets} {petsmax}

hue Hue for the color
alpha Transparency from 0-1 (0.5 is 50% transparency)

id The graphic id, you can get this from UOFiddler or similar programs
hue The hue for the image(0 is original hue)
rect To only use a rectangle area of a graphic rect="x;y;width;height"
For example:

<image id="40251" hue="0" x="70" y="120" rect="0;0;25;25"/>
<image id="9819" hue="0" x="20" y="120"/>

Image progress bars <image_progress_bar> accepts the following

Section titled “Image progress bars <image_progress_bar> accepts the following”

image_background The background image of the progress bar
image_foreground The foreground image of the progress bar
background_hue
foreground_hue
value The current value of the progress bar, can use any of the Text Options or a plain number
max_value The max value of the progress bar, can use any of the Text Options or a plain number
updates true/false If you want the progress bar to update if you expect the value to change
direction up/right the direction the bar should progress in
An example:

<image_progress_bar background_image="40" foreground_image="41" value="{hp}" max_value="{maxhp}" x="15" y="57" updates="true"/>

Animation

Color progress bars <color_progress_bar> accepts the following

Section titled “Color progress bars <color_progress_bar> accepts the following”

background_hue
foreground_hue
value The current value of the progress bar, can use any of the Text Options or a plain number
max_value The max value of the progress bar, can use any of the Text Options or a plain number
updates true/false If you want the progress bar to update if you expect the value to change
direction up/right the direction the bar should progress in
An example:

<color_progress_bar background_hue="32" foreground_hue="60" width="100" height="20" value="{hp}" max_value="{maxhp}" x="15" y="77" updates="true"/>

image

The control tag can be used with child tags, the child tag positions will be relative to the control’s position.
image

<control x="300" y="50">
<colorbox hue="99" width="10" height="10" alpha="0.65"/>
<text y="11" hue="981" width="100">This is an example of items positioning being relative to the control it is inside of</text>
</control>

hue -> The color of the border
image

<control x="300" y="50">
<simple_border x="-1" y="-1" width="100" height="150" hue="981"/>
<colorbox hue="99" width="10" height="10" alpha="0.65"/>
<text y="11" hue="981" width="100">This is an example of items positioning being relative to the control it is inside of</text>
</control>

hue -> Normal button hue
hue_hover -> Hue when mouse over
alpha -> Opacity, 0-1
macro -> The name of the macro to run
Animation
An example to run a macro named f12:

<control x="200" y="50">
<macro_button_color macro="f12" width="100" height="20" hue="60" hue_hover="32"/>
<text hue="60">Macro button</text>
</control>

id && id_hover -> Graphic id numbers
hue && hue_hover
alpha Opacity, 0-1
macro The name of the macro to run
Animation

<macro_button_graphic y="30" macro="f12" hue="0" hue_hover="32" id="251" id_hover="252"/>

hue_normal hue_background hue_poisoned hue_paralyzed
direction Up or Right(Weather the bar moves to the right or up based on hp percentage)
When the player is paralyzed, the bar uses hue_paralyzed (default 49) instead of hue_poisoned; paralysis takes precedence when both apply.

<hp_bar_color width="20" height="500" hue_normal="60" hue_poisoned="1" hue_background="700" direction="up" />

hue_normal hue_background hue_poisoned hue_paralyzed
direction Up or Right(Weather the bar moves to the right or up based on hp percentage)
image_background image_foreground image_foreground_poisoned image_foreground_paralyzed
When the player is paralyzed, the bar uses hue_paralyzed and (if given) image_foreground_paralyzed; the default hue is 49, and an unset paralyzed graphic falls back to the normal foreground graphic. Paralysis takes precedence over poison.

<hp_bar_image x="100" width="20" height="500" hue_normal="60" hue_poisoned="1" hue_background="700" direction="up" image_background="31" image_foreground="31" />