☰
Navigation:
Language:

Uploading/Updating a Mod

Preparing Your Module For Publishing

You need to Publish your module via the modding toolkit in order to allow/enable other players to use your module. You can deploy it for the end user, dedicated servers or other modders, all of which is explained below.

Exporting the Module via the Modding Tools

In the Publishing pop-up window, the following options are available:

Do not forget to select your module in the “Module” dropdown list. Otherwise, you will most likely publish the Native module by accident which will take a significant amount of time.

If you, as a modder, are going to test your module after uploading to the Steam Workshop, please temporarily move your Module folder under “Steam\steamapps\common\Mount & Blade II Bannerlord\Modules” to somewhere else. If you don’t move it temporarily, then the game will try to fetch the module from Bannerlord/Modules instead of workshop/content/261550.

Creating a new Steam Workshop Item

Preparing the WorkshopCreate.xml

Download this file and place it anywhere you want. You can also create one with the following code:

<Tasks>
    <CreateItem/>
    <UpdateItem>
        <ModuleFolder Value="C:\Program Files (x86)\Steam\steamapps\common\Mount &amp; Blade II Bannerlord\Modules\YourModuleName"/>
        <!-- A direct path of your module -->
        <ItemDescription Value="A Bannerlord Mod"/>
        <!-- A description that will be displayed on Steam Workshop, can be edited via the Steam UI -->
        <Tags> 
            <!-- You can use the following tags: -->
            <!-- Type: Graphical Enhancement, Map Pack, Partial Conversion, Sound, Total Conversion, Troops, UI, Utility, Weapons and Armour -->
            <!-- Setting: Native, Antiquity, Dark Ages, Medieval, Musket Era, Modern, Sci-Fi, Fantasy, Oriental, Apocalypse, Other -->
            <!-- Game Mode: Singleplayer, Multiplayer -->
            <!-- Compatible Version: e1.9.0, v1.0.0,... The currently available versions can be found at the Steam Workshop "Browse by Tag" section -->
            <Tag Value="Partial Conversion" />
            <Tag Value="Dark Ages" />
            <Tag Value="Singleplayer" />
            <Tag Value="Multiplayer" />
            <Tag Value="e1.9.0" />
        </Tags>
        <Image Value="C:\Program Files (x86)\Steam\steamapps\common\Mount &amp; Blade II Bannerlord\Modules\YourModuleName\Image.png"/>
        <!-- Determines the featured image displayed on Steam Workshop, a direct path to it must be inserted here (the image should be smaller than 1 MB) -->
        <Visibility Value="Public"/>
        <!-- Determines visibility on Steam Workshop. Can be: Public, FriendsOnly, Private -->
    </UpdateItem>
</Tasks>

Steam Cloud must be enabled for the game in order to successfully upload your mod. You can verify that by right-clicking on Mount & Blade II: Bannerlord within your Steam Library, going to Properties and then General. Or by enabling Steam Cloud for all games via the Steam client Settings window, via the Cloud tab.

You may run into an error during the publishing process. An endless print of the following line: Status: k_EItemUpdateStatusInvalid 0/0 - If that occurs your upload may have completed successfully and you’re free to close the console. If the upload failed, try again.

The size of your uploaded module displayed on the Steam Workshop may differ from the actual size of the module. This is normal.

Publishing the module

Updating a Steam Workshop Item

Preparing the WorkshopUpdate.xml

Download this file and place it anywhere you want. You can also create one with the following code:

<Tasks>
    <GetItem>
        <ItemId Value="YourWorkshopItemIdHere"/>
        <!-- Can be found in the URL of your workshop item -->
    </GetItem>
    <UpdateItem>
        <ModuleFolder Value="C:\Mount &amp; Blade II Bannerlord\Modules\MyMod"/>
        <!-- A direct path of your module -->   
        <ChangeNotes Value="New cool features" />
        <!-- Insert patch notes -->
        <Tags> 
            <!-- You can use the following tags: -->
            <!-- Type: Graphical Enhancement, Map Pack, Partial Conversion, Sound, Total Conversion, Troops, UI, Utility, Weapons and Armour -->
            <!-- Setting: Native, Antiquity, Dark Ages, Medieval, Musket Era, Modern, Sci-Fi, Fantasy, Oriental, Apocalypse, Other -->
            <!-- Game Mode: Singleplayer, Multiplayer -->
            <!-- Compatible Version: e1.9.0, v1.0.0,... The currently available versions can be found at the Steam Workshop "Browse by Tag" section -->
            <Tag Value="Partial Conversion" />
            <Tag Value="Dark Ages" />
            <Tag Value="Singleplayer" />
            <Tag Value="Multiplayer" />
            <Tag Value="e1.9.0" />
        </Tags>
    </UpdateItem>
</Tasks>

Publishing the update