Mount & Blade II: Bannerlord
Help us shape the future of the Vortex mod manager by taking our survey

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
  • 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, by using the compatibility layer modules.

MCM supports two setting types - Global and PerCharacter. Global are shared across characters and saves, PerCharacter are shared across saves with the same character!

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 Wiki for more details!

I was not able to prepare a fully tested release for e1.5.0, the developers did a very fast switch to the new version.
In the last months we prepared three new modules - Harmony, ButterLib and UIExtender.
MCMv4 is using all of them, thus reducing its own code and removing a lot of unnecessary abstractions and workarounds.

MCM was in the last steps of finalizing v4, it's API is still not final. Modders are encouraged to wait and use the v3 API for now!

As the title says, MCMv4 is still in beta.

Documentation and info about migrating to v4 will be added after the Beta release is confirmed to be stable.

Notable changes:
* MCM now requires 3 dependencies - Harmony, ButterLib and UIExtender.
* Introduction of v4 API (WIP)
* MBO compatibility layer is removed
* MCMv3 compatibility layer is added

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 3 folders inside Modules from the archive into your game's Modules
  3.  folder.
  4. 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:

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!

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.

* 3.1.0 Requires a clean install! Do not just replace the folder, delete the old Bannerlord.MBOptionScreen!
* Make sure that `MCMv3 ModLib v1/v13 Integration` loads BEFORE ModLib!
* 3.1.0 splits MCM into three Modules:
   * 'Mod Configuration Menu v3' - the main Module, will show settings that use MCMv3 and beyond.
   * 'MCMv3 MBO/MCMv2 Integration' - ensures that mods like DCC that use MBOv1 and mods that use MBO/MCMv2 are displayed.
   * 'MCMv3 ModLib v1/v13 Integration' - ensures that old/new ModLib are working together and display's its settings.
*  'MCMv3 ModLib v1/v13 Integration' replaces the original ModLib to ensure both old and new ModLib work. You can disable this module to use the original ModLib!
Don't forget to enable all 3 modules!