Skip to content

Parsing GameStrings

koliva8245 edited this page Jun 12, 2026 · 3 revisions

General Tips

  • All newlines are represented as <n/>
  • Tags are never nested
    • A nested tag, for example, is <c val="FFFFFF"><c val="AAAAAA"></c></c>
  • Error tags ##ERROR## only appear in RawText
    • The error tag indicates that the value immediately preceding it was not parsed correctly
    • For example <c val=\"#TooltipNumbers\">0##ERROR##</c>
  • <sp/> tags represent a single space character
  • Unicode characters may appear, usually in locales other than enUS
    • A common one is \u00A0 which is the Non-Breaking Space (NBSP) character

Style and Constant Tags

Style tags are <s> and constants tags are <c>. Constants only contain a val attribute, while styles also contain text-related attributes.

The val attribute's value is either a color hex value or a named variable.

Image Tags

Image tags use the format <img path="" ... /> and are self-closing. The path attribute value determines the image icon to use.

Here is a list of current path values and their icons:

Path value Icon
@UI/StormTalentInTextQuestIcon storm_ui_ingame_talentpanel_upgrade_quest_icon.dds
@UI/StormTalentInTextArmorIcon storm_ui_ingame_status_resistshieldc3.dds

There are also height and width attributes that determine the size of the icon.

Language Tags

Language tags are <lang>. These appear in the match awards' gamestrings.

Examples:

For enUS locale. Depending on the gender of the hero, use either "Immortal Slayer" or "Immortal Slayer".

<lang rule=\"gender\" word=\"%gender%\">Immortal Slayer,Immortal Slayer</lang>

For frFR locale. Depending on the gender of the hero, use either "Geôlier" or 'Geôlière".

<lang rule=\"gender\" word=\"~HeroName~\">Geôlier,Geôlière</lang>

For deDE locale. Depending on the plurality of ~TooltipSecondaryAmount~ use either "Tod" or "Tode"

<lang rule=\"plural\" val=\"~TooltipSecondaryAmount~\">Tod,Tode</lang>

Clone this wiki locally