Notifications
Notification preferences
notifications_off

No unread notifications right now

You're up to date
View All

You're up to date

File information

Last updated

Original upload

Created by

Volitio

Uploaded by

Volitio

Virus scan

Safe to use

Tags for this mod

Current section

About this mod

Provides an in-game graphical interface, accessible via main and ESC menus, that allows players to intuitively manage mod settings and custom mod widgets.

Requirements
Permissions and credits
Translations
  • Ukrainian
  • Turkish
  • Spanish
  • Russian
  • Mandarin
  • Korean
  • Japanese
  • Italian
  • German
  • French
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 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 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;
  • Dependency checking: MCM also checks your mods for missing or outdated dependencies.
  • 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. MCM will now automatically pick up and be available to any mods that may 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.

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.

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

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 🇧🇷.

Consider politely asking authors of mods that use the Script Extender to integrate with 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 it is recommended to 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 (initially) month-long 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 and porting vanilla icons for usage inside IMGUI, to the F4MCM team for inspiration, to MattifusP for the contributions on GitHub 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
Fix Stragglers - automatically boosts/teleports companions who get stuck or fall behind
Configurable Party Limit - allows decreasing/increasing the party size with MCM
Reduce NPC Banter Repetitiveness - adds delays before NPC banter repeats
Auto Send Read Books To Camp - automatically sends read books to camp chest
Auto Use Soap - automatically uses soap after combat/entering camp
Preemptively Label Containers - automatically tags nearby containers with 'Empty' or their item count
Smart Autosaving - creates conditional autosaves at set intervals
Short Rest Cooldown - enforces configurable cooldown after using short rest
Auto Send Food To Camp - sends food to camp chest automatically
Auto Lockpicking - initiates 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

 

 
  翻译：