Mount & Blade II: Bannerlord

File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

About this mod

A fork of ModLib created by mipen that only focuses on providing a library for creating an unified Mod Option screen for mods.
Can display Settings created by ModLib.

Permissions and credits
  • Russian
  • Polish
  • Mandarin
  • Korean
  • Italian
  • French

AKA MBOptionScreen Standalone.

Sources available at GitHub!
Credits to Drogean for the MCM Logos!

MCM is a Mod Options screen library designed to let modders use its API for defining the options.
It can also display settings from other API's like ModLib, pre 1.3 and post 1.3, MBOv1/MCMv2/MCMv3, by using the compatibility layer modules.

MCM supports two setting types - Global and PerSave. Global are shared across characters and saves, PerSave are stored within the save file!

It provides 5 types of options:
* Bool
* Int Slider / Textbox
* Float Slider / Textbox
* Textbox
* Dropdown

The settings can be defined at compile time by using the Attribute API and at runtime by using the Fluent Builder.

See the Docs for more details!

MCMv4 introduced new dependencies - Harmony, ButterLib and UIExtenderEx, reducing its own code and removing a lot of unnecessary abstractions and workarounds..
Harmony is used to have a single 0Harmony.dll across the game
ButterLib is a general modding library that eases mod development
UIExtenderEx is a fork of UIExtender that does the same thing, but the inside implementation is different.

Documentation for v4 is available.

How do I install it?
  1. Find the Modules folder in your Bannerlord installation location. For Steam users, this is usually here: C:\Program Files (x86)\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules
  2. Download the latest version of this mod and drop the folder inside Modules from the archive into your game'sModules folder.
  3. Start the Mount & Blade II: Bannerlord launcher and select all Mod Configuration Menu mods to be loaded.

Your Modules folder structure should look something like this:

Your mod order in the launcher should look something like this:

Based on the Beta experience, users are expected to have two issues that can cause an CTD:

    * Blocked DLL's
    * Harmony installation issues.

Unblocking DLL's
You may need to right click on every Bannerlord.MBOptionScreen.*\bin\Win64_Shipping_Client\*.dll files, click Properties, and click Unblock if you extracted the zip file with Windows Explorer or other programs that try to secure extracted files.
Harmony installation issues:
Check Harmony's Troubleshooting for more info on how to fix it.
No other than MCM's settings visible
There were similar reports. Most likely some mod like DCC is loaded before MCM. Make sure that DCC or any other mod depending on MCM is loaded after MCM!


    * 4.1.0 Requires a clean install! Do not just replace the folder, delete the old Bannerlord.MBOptionScreen!
    * Make sure that `Mod Configuration Menu v4` loads BEFORE ModLib!