Understanding Attributes

Attributes are used to modify the behavior, appearance, and functionality of markers, trails, and categories.

Exclusive Attributes

Be mindful that there are some attributes exclusively supported by Blish HUD.

Blish HUD exclusive attributes will be silently ignored in TacO. That means that any behaviors or other effects they would normally provide in Blish HUD will not occur at all in TacO. Packs using Blish HUD exclusive attributes will still otherwise run in TacO without issue.

Need help or feedback?

If you need assistance or would like to provide suggestions for future attributes in Blish HUD, join our Discord channel!

Applies ToAttributeSummary
TrailsIsWallWhen enabled, a trail will be rendered on its edge like a boundary.
Markers, TrailsFestivalHides the marker or trail if one of the specified festivals is not active.
Markers, TrailsMountHides the marker if the player is not currently riding one of the specified mounts.
Markers, TrailsProfessionHides the marker or trail if the player is not currently one of the specified professions.
Markers, TrailsRaceHides the marker or trail if the player is not currently one of the specified races.
Markers, TrailsSpecializationHides the marker or trail if the player is not currently one of the specified specializations.
Markers, TrailsMapTypeHides the marker or trail if the current map is not one of the specified map types.
Markers, TrailsCullAllows you to make markers or trails hidden depending on which direction they are looked at.
Markers, TrailsCanFadeAllows a marker or trail to ignore fade features such as those which hide trails around the player or between the user and their camera.
MarkersInvertBehaviorIf enabled, the behavior attribute's effect is inverted.
MarkersRotateAllows you to statically rotate a marker instead of it automatically facing the player.
MarkersBounceAllows a marker to "bounce" when triggered.
MarkersCopyAllows you to set a value to the users clipboard.
MarkersShow / HideAllows showing or hiding a specified category when triggered.
MarkersToggleToggles a category on or off when triggered. Similar in behavior to the Show & Hide attributes.
Markers, CategoriesTipAllows you to display a tooltip on markers on the minimap or categories in the category dropdown.
CategoriesDefaultToggleIndicates if the category should be enabled by default.

Attribute Prefixes

Blish HUD supports prefixed attributes. This is to say that any attribute prefixed by bh- will be stripped of its prefix and used as a normal attribute. This allows you to create markers, trails, and categories that differ in functionality depending on if the pack is loaded by Blish HUD or TacO. This works because TacO will ignore these attributes entirely as they don't match any of its supported attributes.

Example:

<MarkerCategory name="overlay" displayname="You're using TacO!" bh-displayname="You're using Blish HUD!" />
caution

When using prefixed attributes, ensure they are specified after the attribute you wish you override. Anything that inherits attributes can still override a prefixed attribute if it itself defines its own overriding attribute, prefixed or not.

Attribute Values

As the marker pack format is XML based, there are limitations to what characters can be used as an attribute value. The table below indicates the values that must be escaped in order to be considered proper XML. Both Blish HUD and TacO have forgiving XML parsers which will do their best to interpret the value, but not all libraries or overlays are capable of this. For the best result, you the table below when using any of the specified characters.

CharacterEscaped Value
<&lt;
>&gt;
&&amp;
'&apos;
"&quot;
New Line&#xA;