The Editor
Mod Merging
Reminder: Hover your mouse over almost any input, field, selectionbox or button in the Editor to receive tooltips and examples.
Table of contents
Mod Merging is the process of taking a Mod and transferring all it's content into another Mod. This way, you can combine the contents of two, or even more Mods into a single one. This has multiple use cases:
When Merging two Mods, it can happen that both Mods have contents with the exact same IDs. For example: Both have an item with the ID "myHat". This is not the end of the world. Below, you can see 2 Merging Examples, where you learn more.
In our example, we have two Mods. One Mod is the one we mainly work on, and the other one just contains one single Item, "Staff of Fire".
In the image to the left, we are looking at this one single Item, inside of its own tiny Mod.
Our goal: Merging this tiny Mod into our main Mod, so the main Mod has the Item.
We always start with the Mod that receives the new content.
Load it normally when you start up the Editor.
You don't need Mod Tracking selected.
Then, in the Editor menu we select 'Mod Merger'.
In the image to the left, you can see that we are editing a Mod called "MFM1_LV". This is our main mod. In the Mod Merger window we now select whatever we want to merge into it. In this case, our Mod with the "Staff of Fire"-item in it.
Press the Analyze-Button at the bottom of the window to continue.
Now, all contents of the second Mod have been copied into the one you have currently loaded. At this point, all you have to do is Saving your Mod, which will finalize all changes and copy the gfx- and sfx- files over to your loaded Mod.
If you exit the Editor without saving your Mod, everything will remain as before.
Now let's look at another example. This time, both Mods will now also contain an item with the exact same ID. In the image to the left, this item has the ID 'myHat'.
As before:
We always start with the Mod that receives the new content.
Load it normally when you start up the Editor.
You don't need Mod Tracking selected.
Then, in the Editor menu we select 'Mod Merger'.
Finally, we select the mod to merge in and start the Analysis by clicking on the button in the merger window.
Here we see, that there are various identical (and therefore conflicting) contents. The item itself, the name String and the item description String.
You can do two things now:
A) Inside of either Mod, simply change the ID of one of the items. This also takes care of the attached Strings. Then do the Merging Analysis again.
B) Accept the discrepancy and merge right away. This will cause the second Mod's item to overwrite the item of the currently loaded Mod.
Once Merging is complete, all you need to do is Saving your Mod, which will finalize all changes and copy the gfx- and sfx- files over to your loaded Mod.
If you are following the Guide, continue with Mods of Mods.