Mod Configuration Menu (MCM)

Baldur's Gate 3 Mod Configuration Menu (MCM) provides an in-game menu through which mod users can configure mod settings and hotkeys.
It is a central location for mod configuration and can be accessed via the main and ESC menus, or pressing the Insert key (by default).

Are you a mod author? Check the documentation for integrating mods with the MCM; it's a simple process and there are a lot of author-facing features you definitely want to hear about!

• Easily configure mods: MCM provides a simple and intuitive way to change mods' settings. No need to manually edit JSON files - although still allowed, just like in the old days!
• Instant setting saving and loading: Unlike the traditional way of handling settings, MCM-integrated settings update in real-time as they are changed, without requiring save reloads or SE commands;
• Load order health checking: MCM also checks your load order for missing/outdated dependencies and mods with invalid UUIDs.
• Keybinding management: easily assign keyboard bindings directly from the MCM window, with built-in conflict handling.
• UI agnostic: MCM's core configuration code is designed to work independently of IMGUI. This means that even if IMGUI support were to be completely removed, MCM would still work. Users who can't see the current UI will still be able to use MCM's under-the-hood benefits to manage their settings, and also edit them through JSON files.
• Save-safe: MCM does not write anything to your save files - all modifications are done in-memory and then saved to JSON files. MCM can also be safely uninstalled without affecting your save files at any time, provided any mods that use it are disabled or uninstalled as well;
• Multiple profiles: MCM allows you to manage multiple configuration profiles, so you can have different settings for different playthroughs/characters;
• Reduced user error: MCM performs several settings validations, reducing the risk of user error when configuring mods, even if manually editing JSON files;
• Export and import settings: Mod settings are stored per-profile and per-mod JSON files under Script Extender\BG3MCM, making it easy to create backups and restore settings.
• Uncluttered UI: MCM consolidates all mod settings into one interface, reducing screen clutter.
• Robust: MCM has dozens of automated tests to ensure it works as expected, without halting;
• Localization support: MCM allows you to view settings in your preferred language, if translations are provided by mod authors/translators;
  

Installation is the same as any other pak mod and can be performed with new and existing saves:

• In Baldur's Gate 3 Mod Manager, (or use Vortex at your own discretion), install/enable the Script Extender (SE) by clicking on the 'Tools' tab at the top left of the program and selecting 'Download and Extract the Script Extender'. Alternatively, press CTRL+SHIFT+ALT+T while BG3MM's window is focused;
• Import this mod's .zip file into the Mod Manager, then drag the mod from the right panel of the Mod Manager to the left panel; make sure to drag it to the top of your load order, as it needs to be placed above any mods that rely on this framework;
• Save and export your load order. MCM will now automatically pick up and be available to any mods that may use it.
  

You should then see a button for MCM in the ESC menu in-game. It can also be opened with the INSERT key by default.
You may also update MCM at any point, unless stated otherwise. 

UI/IMGUI support in SE has been significantly improved since launch, but you may still face some issues that are beyond my control. If you don't see the MCM window, you can try these things:

• restart your game (don't alt-tab before reaching the main menu);
• disable overlays (Discord/AMD/NVIDIA/OBS/etc);
• toggle the rendering API to Vulkan/DX11.
• verify that the problem persists with no other DLL mods, such as WASD movement;
• delete the imgui.ini file at AppData\Local\Larian Studios\Baldur's Gate 3\imgui.ini
• if you disabled SE autoupdates or are using the Devel channel and having problems, please switch back.
  

Even if you have issues with IMGUI, MCM will continue working as a config/JSON manager in the background if its window does not appear.



MCM 1.30+ greatly improved multiplayer compatibility. If you still face problems, however, let the host manage settings.
Players joining a multiplayer session don't need to match the host's MCM settings unless stated by the respective mod author.

Please report issues using the Bugs
Suggestions are welcome in the Forum or Posts tab.

Files location
Individual user settings can be located in the BG3MCM\Profiles\\\ folder. If you're feeling adventurous, here's a spoiler with an example of the full file structure:

Similar to my experience with ISF, I'd like to thank the foundational work of Focusand Nels/Community Library team. While applied to a lesser extent in this context, their insights throughout ISF have made this endeavor a much less daunting task. I will be forever grateful for their open-source contributions to the Baldur's Gate 3 modding scene. Of course, none of this would be possible without the work put into Script Extender & LSLib by Norbyteand his responsiveness to feedback and troubleshooting. It was a pleasure working asynchronously with you, gentlemen 🎩👌.
Also, a shoutout to Fallen for alpha testing this mod, to Sketch for being in the IMGUI trenches with me, to Aahz for some help with sidebar design and implementation (also osirisofinternet) with detaching windows, state management involving client-side UI (adapting ReactiveX for SE, etc), and porting vanilla icons for usage inside IMGUI, to the F4MCM team for inspiration, to Marty Fispand Valeriede for the contributions on GitHub and to many many others in the modding community that shared support and/or donated!

Source Code
The source code is available on GitHub or by unpacking the .pak file. Endorse on Nexus and give it a star on GitHub if you liked it!