SValue Loaders

From Heroes of Hammerwatch wiki
Revision as of 16:56, 3 October 2018 by Miss (talk | contribs)
Jump to: navigation, search

SValue loaders are script functions that deserialize sval files at the gamemode initialization step. (After the constructor but before Start()).

They are defined in sval files like this:

<loader>SomeFunction</loader>
<dict>
  <string name="example">example</string>
</dict>

And loaded by scripts like this:

void SomeFunction(SValue@ sval)
{
  string example = GetParamString(UnitPtr(), sval, "example");
  print("SomeFunction example: \"" + example + "\"");
}

You can also specify an order attribute to specify the order in which they are loaded. This is required for sets for example, as they depend on items to exist.

Only one loader tag may exist per file.

Built-in loaders

The following loaders are built-in to Heroes of Hammerwatch:

  • AddItemFile Used for loading item definitions.
  • AddSetFile Used for loading item set definitions.
  • AddDrinkFile Used for loading tavern drink definitions.
  • Materials::LoadDyes Used for loading player dye definitions.
  • Titles::LoadTitles Used for loading class title definitions.
  • Upgrades::LoadShop Used for loading upgrade shop definitions.