Modding Bannerlord with Vortex
Mount & Blade II: Bannerlord
Mount & Blade II: Bannerlord is an action role-playing video game developed by TaleWorlds Entertainment.
This guide is designed to help you set up Vortex to install and manage mods for Mount & Blade II: Bannerlord. Please note that Vortex support for Bannerlord is actively being worked on and may soon include new features.
Getting Set Up
To begin, open up Vortex and navigate to the games section. In the search bar at the top, type in "Bannerlord" and click the "Manage" button on the game tile.
A dialogue will appear asking you to confirm the download of the game extension for Bannerlord. Click "Download" in the bottom right to proceed.
Once the extension is installed (which should only take a few seconds) click "Restart now" in the notification that will appear in the top right corner.
Go back to the Games tab (click "Games" in the side menu) and search for Bannerlord again. This time, the button on the game tile should read "Activate". Click it and Vortex will be ready and set up to manage mods for Bannerlord.
In the Nexus Mods Bannerlord section, navigate to a mod you would like to download (Example: Bannerlord Tweaks). In the top right, you will see a button that reads "Download: Vortex". Click it and confirm to open the link with Vortex if your browser asks you for confirmation.
Once the mod is downloaded via Vortex (which for this example should only take a few seconds), click "Install" in the notification in the top right.
After the mod is installed, you can enable the mod for example by clicking the "Enable" button in the next notification that is raised by Vortex, again in the top right corner.
Tip: You can skip this step and simply auto-enable mods you have just installed by changing your Vortex settings. In the side menu, go to "Settings" and on the rider "Interface" toggle the option that says "Enable Mods when installed (in current profile)". This will make it so mods are immediately enabled as soon as they are installed.
And that's it! The mod is now ready to be used ingame.
For Vortex 1.2.0 and above: Lastly, make sure to use the play button in the top left to run Bannerlord in Single Player mode. This will skip the game's launcher and ensure that the load order you set in Vortex is loaded.
Managing your Bannerlord Load Order
|This content applies to Vortex 1.2.4 and above.|
As of Vortex version 1.2.4, you can manage your Bannerlord load order directly in Vortex via the "Load Order" tab.
- Using Auto Sort is strongly recommended, as this will sort your mods according to dependencies.
- The game must be run via the Play button in the top left corner to ensure the load order shown in Vortex is applied.
- If a mod you installed is not in this list, it means that the mod doesn't come with a SubModule.xml. Not every mod has or needs one.
Mods/Modules with missing Dependencies
If a mod in your load order cannot find a mod it depends on, Vortex will disable it and mark the mod with an X. On hover, the missing mod dependency will be displayed.
Note: This is because Vortex will parse the SubModule.xml files for the mods in your load order and sort them according to the entries under "<DependedModules>"
This tells us that we need to install and enable "BannerLib". Otherwise "Custom Campaign Options" won't load.
Once we have installed and enabled "BannerLib", all dependencies are fulfilled and we can enable "Custom Campaign Options":
Auto Sorting Logic
To ensure that the load order created by Vortex is functional and stable, Vortex will parse the SubModule.xml files of the mods you have installed and sort them according to dependencies.
For example: if Mod B declares under <DependedModules> in its SubModule.xml that it requires Mod A (the entry would read <DependedModule Id="ModA"/> or similar) then Auto Sort will ensure Mod B loads after Mod A (and therefore create an order where Mod B is sorted below Mod A).
While the sorting algorithm is more sophisticated, it can be described with a few rules:
- Every mod is going to be sorted after the official module named "Native". "Native" is locked in position 1 and cannot be moved.
- Mods are sorted by dependencies. A mod dependent mod will be sorted after its required mod.
- Other than that, mods will be sorted in alphabetical order based on the Module ID defined in the SubModule.xml file.