◁ Back to Home

Modding

There are multiple ways to mod this map file:

• Adding extra *.stormmod mods
• Edit the XML files
• Edit the Galaxy Script files
• Edit the Asset files

---

Adding extra *.stormmod mods

If you would like to include a *.stormmod file into this map, you can copy the file into HEROES_OF_THE_STORM/mods/yourmod.stormmod:

Heroes of the Storm
├── HeroesData
├── mods
│   └── yourmod.stormmod   <-- Here
├── Support
├── Support64
├── Versions
├── .build.info
└── .Heroes of the Storm.exe

Then, in Includes.xml, add an entry:

<Path value="Mods/yourmod.StormMod" />

Afterwards, reload the Try Mode map (completely exit and re-enter the map), you should see your map loaded, provided the stormmod file is valid.

You can also obtain a list of official Heroes of the Storm stormmod files from my *.s2ma hosting repo: https://github.com/jamiephan/HeroesOfTheStorm_S2MA/tree/main/mods (Files where extracted directly from the game files)

Examples:

Using the AzmoDUNK Mutator Mod:

Using the In Game Hero Selection Mod:

---

Edit the XML files

Editor Setup

This section of setting up the editor is optional, but its highly recommended

It is recommended using Visual Studio Code with the extension XML installed.

This extension also allows to load a .xsd file for auto completion.

In a regular XML file:

<?xml version="1.0" encoding="UTF-8"?>
<Catalog>
    <!-- Your stuff -->
</Catalog>

Modify the <Catalog> to include the XSD (XML Schema Definition) file :

<?xml version="1.0" encoding="UTF-8"?>
<Catalog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/jamiephan/HeroesOfTheStorm_Gamedata/master/xsd/latest.xsd">
    <!-- Your stuff -->
</Catalog>

Note: This will not affect how the game read the xml file nor it will change any outputs

This enables you to auto complete the XML tags and attributes:

Note the .xsd file loaded is from the repo jamiephan/HeroesOfTheStorm_Gamedata, which host all the game data and generate a XSD file automatically

Modifying the XML files

Generally, You can override the XMLs that the game has. The game will use your own version instead. However, you must follow the XML level structure similar to the game has. For example, to make Maiev's Fan of Knives (Q) to have no cooldown and do insane damage, your XML should look something like this:

<?xml version="1.0" encoding="us-ascii"?>
<Catalog>
    <CAbilEffectTarget id="MaievFanOfKnives">
        <Cost>
            <Cooldown TimeUse="0" />
        </Cost>
    </CAbilEffectTarget>
    <CEffectDamage id="MaievFanOfKnivesDamage" parent="StormSpell">
        <Amount value="9999" />
    </CEffectDamage>
</Catalog>

Now save this XML into a file, e.g MaievQModify.xml and place it in the (10)trymemode.stormmap/base.stormdata directory. Afterwards, update the GameData.xml file:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Includes>
  <Catalog path="Mods/GameData/HeroesMod/AbilityMimic.xml"/>
  <Catalog path="Mods/GameData/HeroesMod/BehaviorMimic.xml"/>
  <Catalog path="Mods/GameData/HeroesMod/IconGlowing.xml"/>
  <Catalog path="Mods/GameData/HeroesMod/ModelMimic.xml"/>
  <Catalog path="Mods/GameData/HeroesMod/PermaArmor.xml"/>
  <Catalog path="Mods/GameData/HeroesMod/TestHero.xml"/>
  <Catalog path="Mods/GameData/SystemMod/TestSystem.xml"/>
  <Catalog path="MaievQModify.xml"/> <!-- Add This line here-->
</Includes>

Note that the path is relative to base.stormdata. Therefore if you place it in (10)trymemode.stormmap/base.stormdata/MaievMod/QModify.xml, the path will be MaievMod/QModify.xml.

If you would like to automate this process, I recommend to use the Build XML tool

Note: If you wish to use the tool npm run build:xml to build the XML files, All XML modifications must be inside the Mods/GameData folder (./(10)trymemode.stormmap/base.stormdata/Mods/GameData). Any subdirectories or file name (provided its ending with .xml) are not limited.

Now restart the try mode, by either exit and reenter, or using the restartgame command, you should see Maive's Q Damage is skyrocketed with no cooldown:

---

Edit the Galaxy Script files

Modifications of Galaxy files in (./(10)trymemode.stormmap/base.stormdata/Modules/), same as where the custom command library located at.

I have also published the Modules_Editor.SC2Mod in (10)trymemode.stormmap/base.stormdata/Modules/ that you can open it in SC2 Editor, However due to some issues between SC2 Editor and Heroes (some functions and variables does not exist is both sides or even have incompatible function signature)

IMPORTANT: For the following instructions, DO NOT do it to LibModuleLoader.galaxy and Module Loader in SC2Editor or the whole modding will fail.

Modifying Current Library Files:

1. Change The Viewing mode to Triggers, or Pressing F6:

2. Change Whatever you like in here, with some exceptions, see below:

3. Please see the save and modify section below:

Adding New Galaxy Library:

Adding a New lib is also pretty simple:

1. Adding a new Lib by right click on empty space:

2. However, I do suggest you change the library ID to a 4 character ID:

3. Change whatever you like on the first box and uncheck the "Auto Load":

4. To Save, do the thing similar to above with Export and stuff but not replacing the file when saving. (Also place the new file on the same directory if possible)

5. Modify the LibModuleLoader.galaxy file with a text editor (NOT the SC2 Editor):

6. Append the new File without the .galaxy extension. For instance, if your file name is LibNice.galaxy, append the lane: include "Modules/LibNice

7. Now we need to find the Lib init function by opening up the script file (Ctrl F11 or Data->View Script):

8. Find the section // Library Initialization (usually at bottom) and copy this section (generally is libXXXXX_InitLib() depends on the name you changed above):

9. Copy the code (function name) into the LibModuleLoader.galaxy in this section:

10. Remove the space and add a semicolon at the end (*important) and save the file:

Dealing with Heroes of the Storm Specific Functions:

Since Heroes is a modified SC2 Engine, it also have some functions that cannot be found on SC2 Editor such as SetTalentEnabled() which is a function to enable or disable a talent (Note: Don't be confused with SetTalentsEnabled() in SC2 Editor.)

Note: As well as some Functions from SC2 Editor is absent in Heroes, such as UnitItem, this will cause error in Heroes that the game cannot be loaded even though it is valid in SC2 editor.

To add the Heroes Specific script:

1. Create a new Action:

2. Select Custom Script:

3. Type in the Heroes Code you want, Please also do check the parameter type and adding a semi-colon at the end (Note: It can also include the variables from Sc2Editor, such as lv_* for local variable and gv_* for global variable):

4. Add //_heroes_replace// before the custom script:

Note that If you attempt to save the SC2Mod file (the one you currently opening in SC2Editor, not the galaxy file), it most likely complain and won't let you save:

Saving and Modifying for Heroes compatibility

Using the patch:library tool (Recommended)

1. When Save, Use the Export Functionality by going view script or Ctrl + F11:

2. Click On File -> Export

3. Select the corresponding galaxy file to replace and save (Note: Please do make sure you replace the correct file, as it will not able to launch the game if so.):

4. Please see tools.md for more details.

Manually modifying for heroes compatibility

This sections demonstrates how to remove the //_heroes_replace_// in SC2 Editor when exporting, allows for custom heroes functionalities.

1. When Save, Use the Export Functionality by going view script or Ctrl + F11:

2. After see this screen, Do a Find -> Replace or Ctrl + H:

3. Type in //_heroes_replace_// for text and empty text box for Replace With and spam the Replace Button (Not Replace All) until it can no longer replace anymore:

4. Close the Replace Dialog and export the file:

5. Select the corresponding galaxy file to replace and save (Note: Please do make sure you replace the correct file, as it will not able to launch the game if so.):

Error and Debugging:

If you encounter stuff like this, mostly likely you have error on your galaxy files:

Currently it is unable to call the Heroes' specific debug menu like in SC2, the best way to debug is mostly likely just to print out messages (Text Message).

---

Edit the Asset files

Generally, you can replace any in game assets with your own. The game will priorities loading your own asset over the internal ones, provided they are have the same name. For instance, the Raynor-with-a-bunny-ear loading screen in this map, the file is under (10)trymemode.stormmap/base.stormassets/Assets/Textures/storm_ui_loading_startup.dds, which is to replace the default in-game file: heroes.stormmod/base.stormassets/Assets/Textures/storm_ui_loading_startup.dds. Note that the path in base.stormassets must be the same.

You can use this to also replace assets such as but not limited to: *.dds (texture), *.m3 (models) and *.ogg (sound/music files).

Editing Asset Files (.dds)

If you loaded this map, you will noticed the loading screen have changed to our boy jimmy:

I recommend using a plugin NVIDIA Texture Tools for Adobe PhotoShop to do edit the .dds files with Photoshop.

Note: When saving, remember to choose No MIP maps inside the MIP Map Generation section. (Took me a long time to figure it out why the texture is not loading.....)