This short guide aims to explain how to add your own images to the game, to either replace or extend those included in the base game. For a more comprehensive modding guide, go to 'Modding Guide' by leto.

No additional tools are necessary, but having a good XML editor (such as Notepad++) makes it easier.

All 2D images that are referenced in the XML database files can be replaced.
These XMLs are located in \ExternalAssets\Database which sits in your game folder.

The game will only accept images in .jpg and .png format.

When entering the filename in the XML database, do NOT include the extension in the filename.

Make sure that each file has a unique name - it is NOT permitted to have files with the same name even if they have a different extension (i.e. myhero.jpg and myhero.png).

Images will have various dimensions - if the ones you add have a different size, they will be stretched to match the container they need to be displayed in inside the game.

Place the images you want to add inside \AppData\LocalLow\MuHa Games\MoM\Mods\YOUR_MOD_NAME\Images folder.

Skills images are located in DB_SKILL.xml
Enchantments are in DB_ENCHANTMENT.xml
Buildings are in DB_BUILDING.xml
Terrain resources are in DB_TERRAIN_RESOURCE.xml
Artefacts are in DB_ARTEFACT.xml

The artwork for their icons is a single square texture, recommended size is 256 x 256px.

For each of the above assets, you can change the icon by modifying the value in the Graphic entry, like in the examples below:



If you decide to expand the list of available buildings, they will appear on the production options in construction manager, but it is not possible to add new icons to the town map.

Resources have a field called OptionalModel3dName. If you do not plan to provide a custom 3d model for the resource, this field can be used to enter a name of 3d model that is delivered with the base game. If this entry does not exist, the game will be looking for a 3d model with the same name as found in the Graphic field.


Adding new 3d models is also possible - for more information, see the guide located in GAME_FOLDER\ExternalAssets\MoMAssetBundlesExporter\MasterofMagicAssetBundleExporter\

Spell images are referenced in DB_SPELL.xml

The icon artwork is a single square texture. It is used on the spell selection screen, spellbook, research, notifications, and during trade. Its recommended size is 256 x 256px.

Some spells also have another field called AdditionalGraphic - it is used for bigger images displayed when a global spell is being cast. These images have a recommended size of 1250 x 1500px.

For each of the above assets, you can change the value in the Graphic entry, like in the example below, to modify the icon:

Race entries are located in DB_RACE.xml
Units are in DB_SUBRACE.xml

Race icon is used on the race selection screen (small icons) and city manager screen.
Big portrait for the race representation is taken from a selected unit indicated in the RepresentativeUnit field (mind that this is a reference to the DB_UNIT database, not an image file!). To modify the small icon, change the value of the Graphic field:


Units need three images:
- small portrait icon - displayed in various grids. Recommended size is 256 x 256 px,
- full body icon - shown on the Unit Info screen and construction manager. Recommended size is
1024 x 1024 px,
- marker - shown on the unit's banner on the battlefield. Recommended size is 128 x 128 px with transparency.
The icon name goes into the Graphic field.

IMPORTANT:
Full body icon does not have its own field - instead, the game will look for the filename specified in the Graphic field with a '_FULL' suffix. So you will need to put in two images into the Images folder, i.e. NewUnit.png and NewUnit_FULL.png

If you do not plan to add a custom 3d model. the field OptionalModel3dName should be used to enter a name of 3d model that is delivered with the base game. If this entry does not exist, the game will be looking for a 3d model with the same name as found in the Graphic field.


Adding new 3d models is possible - details are described in the guide located in GAME_FOLDER\ExternalAssets\MoMAssetBundlesExporter\MasterofMagicAssetBundleExporter\

Wizard images are referenced in DB_WIZARD.xml

Artwork for wizards requires two images:
- small (Icon) - used for wizard portrait icons, diplomacy, wizard information screen and cutscenes (640 x 640px),
- big (Background) - used on the wizard selection and loading screens (14089 x 3456px, to handle 4k and ultra-wide resolutions).

Change the values in Graphic, Icon and Background entries to the desired ones, like in the example below:

Adventure images are taken from a different folder than the rest: \ExternalAssets\AdventureGraphics
There is no need to modify any databases - simply add your custom .jpg or .png image into that folder and they will be listed when you are selecting an image for your node in the Editor.
The recommended size of the artwork is 1250 x 1500 px.