home
Baldur's Gate 3
Terms of Service | Privacy Policy
Copyright © 2024 Robin Scott. All rights reserved.
0 of 0

File information

Last updated

Original upload

Created by

Volitio

Uploaded by

Volitio

Virus scan

Safe to use

Tags for this mod

Tag this mod
Current section

About this mod

Provides an in-game graphical interface that allows players to intuitively manage mod settings and custom mod widgets.

Requirements
Permissions and credits
Translations
  • Turkish
  • Spanish
  • Korean
  • Italian
Changelogs
Donations
Baldur's Gate 3 Mod Configuration Menu (MCM) provides an in-game menu through which mod users can configure mod settings.
It is a central location for mod configuration and can be accessed via the ESC menu 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 features you definitely want to hear about!

Features
  • Configuration made easy: 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 mods update settings in real-time as they are changed, without requiring save reloads or SE commands;
  • 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
Installation is essentially 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. The MCM will now automatically pick up and be available to any mods that use it.

You will see a button for MCM in the ESC menu in-game. It can also be opened with the INSERT key by default.

Note that this UI support in SE has been improved but is still in development, so you might 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);
  • switch to Vulkan.

I have updated most of my mods to be integrated with MCM:
As a demonstration, their MCM settings will also be localized in PT-BR 🇧🇷.
There are also some other authors using MCM; consider politely asking authors of mods that use SE to use MCM!

Here's MCM (older 1.0 version) in action with Fararagi's Configurable Movement Speed (pretend you can read the menu in this heavily-compressed GIF):


Reports & requests
It works in multiplayer, but changes from other players currently won't be reflected in the UI apart from setting resets. Decide on one player to do all the changes, preferably the host.
Please report any other issues using the Bugs tab.
Suggestions are welcome in the Forum or Posts tab.

Files location
Individual user settings can be located in the BG3MCM\Profiles\<PROFILE_NAME>\<MOD_NAME>\ folder. If you're feeling adventurous, here's a spoiler with an example of the full file structure:
Spoiler:  
Show
You can find the root folder on Windows by pressing WIN+R and entering:
explorer %LocalAppData%\Larian Studios\Baldur's Gate 3\Script Extender\BG3MCM
BG3MCM/
│mcm_params.json (Stores profile data, needed to be able to load profiles)
│mod_configuration_menu_config.json (Manages a few MCM settings before MCM can load its own settings)
└───Profiles
├───Default
│├───AutoSendFoodToCamp
││ settings.json (Stores current values for mod Auto Send Food To Camp)
│├───PreemptivelyLabelContainers
││ settings.json
│└───WaypointInsideEmeraldGrove
│ settings.json
├───Profile 1
│├───AutoSendFoodToCamp
││ settings.json
│└───WaypointInsideEmeraldGrove
│ settings.json

Special thanks
Similar to my experience with ISF, I'd like to thank the foundational work of Focus and Nells/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 Norbyte and 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 Skiz for being in the IMGUI trenches with me, to Aahz for some help with the dreaded state management involving client-side UI, to the F4MCM team for inspiration, and to many others in the modding community that shared support!

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!

My mods
Waypoint Inside Emerald Grove - adds an actual waypoint inside Emerald Grove
Auto Send Read Books To Camp - send read books to camp chest automatically
Auto Use Soap - automatically use soap after combat/entering camp
Send Wares To Trader - automatically send all party members' wares to a character that initiates a trade
Preemptively Label Containers - automatically tag nearby containers with 'Empty' or their item count
Smart Autosaving - create conditional autosaves at set intervals
Auto Send Food To Camp - send food to camp chest automatically
Auto Lockpicking - initiate lockpicking automatically

Tools/Resources
Mod Uninstaller - allows uninstalling mods that add items/statuses
Mod Configuration Menu - offers a graphical interface for easy management of mod settings
AV Item Shipment Framework - allows authors to easily send items to player/camp chests
Volition Cabinet - library mod for my other mods