XML-Gumps
XML Gumps
Section titled “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.
Instructions
Section titled “Instructions”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.
Visual editor
Section titled “Visual editor”An in-game editor builds and edits these gumps without hand-writing XML:
- Open it with the
xmleditorcommand,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.
Example gump
Section titled “Example gump”<?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>Options
Section titled “Options”Root <gump> tag
Section titled “Root <gump> tag”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
Text options
Section titled “Text options”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}
Colorbox <colorbox> accepts the following
Section titled “Colorbox <colorbox> accepts the following”hue Hue for the color
alpha Transparency from 0-1 (0.5 is 50% transparency)
Image <image> accepts the following
Section titled “Image <image> accepts the following”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"/>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"/>Control tag <control>
Section titled “Control tag <control>”The control tag can be used with child tags, the child tag positions will be relative to the control’s position.
<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>Simple border <simple_border>
Section titled “Simple border <simple_border>”hue -> The color of the border
<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>Macro buttons <macro_button_color>
Section titled “Macro buttons <macro_button_color>”hue -> Normal button hue
hue_hover -> Hue when mouse over
alpha -> Opacity, 0-1
macro -> The name of the macro to run
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>Macro buttons <macro_button_graphic>
Section titled “Macro buttons <macro_button_graphic>”id && id_hover -> Graphic id numbers
hue && hue_hover
alpha Opacity, 0-1
macro The name of the macro to run
<macro_button_graphic y="30" macro="f12" hue="0" hue_hover="32" id="251" id_hover="252"/>HP Color bar <hp_bar_color>
Section titled “HP Color bar <hp_bar_color>”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" />HP Image bar <hp_bar_image>
Section titled “HP Image bar <hp_bar_image>”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" />