Troubleshooting and Reporting Script Extender's implementation of IMGUI, the UI library used by MCM, has been improved, but is still in development. Therefore, some issues beyond my control may arise when using MCM with certain setups. Mods that depend on MCM should still work regardless of whether MCM shows up or not. Script Extender v18 likely improved compatibility with older GPUs.
If you're having trouble with MCM not appearing, please follow these steps to narrow down the issue:
Disable overlays (Nvidia/AMD/Discord/Rivatuner, etc; Steam might be fine).
Don't alt-tab before reaching the main menu.
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
Note that MCM only officially supports the latest BG3 version and the Release versions of SE. If you disabled SE autoupdates or are using the Devel channel and having problems, please switch back.
Reporting issues:
Provide SE console logs - it is almost impossible to debug problems without them. Ctrl + F12 should open the console.
Provide your system specs (GPU model, CPU model, OS).
Describe behavior under DirectX 11 and Vulkan. Please test both if possible.
Known SE issues:
Cursor lingering despite gamepad UI; Steam Input (game or desktop layouts) might have something to do with this, if you're willing to investigate.
UI not showing up: Don't alt-tab before reaching the main menu. Switch the rendering API: test both Vulkan and DirectX 11. You can switch it through Larian's launcher. Script Extender v19+ likely improved this.
Problems when using languages with large character sets, such as Chinese: UI elements may not display correctly or at higher resolutions. Consider switching to a language with a smaller character set, such as English.
If you enjoy MCM, consider politely asking other mod authors that use Script Extender to add integration! Tips and endorsements are also appreciated, thanks!
This is MCM's biggest update so far, with a lot of very important new features and fixes. I hope you enjoy it. As always, let me know if you face any problems. I've poured several hundred hours into developing MCM, and with my recent layoff, every bit of support helps keep this going. If you've enjoyed using MCM or my other mods, please consider donating or supporting me on Patreon; your support can make a huge difference! A heartfelt thank you to everyone who donated following my GPU failure 💜!
I tried using separators for the first time recently and realized that I couldn't have them nested in their own folder inside of the Mods folder without it causing my "load order to reset externally." As for ImpUI_P8_Fork, I'm also using it and had no issue.
Is anyone else having an issue where you have the latest Script Extender via BG3MM but MCM is still saying you only have v23 and not v24? Not sure what is going on, whether it's an issue on my end, or another issue entirely.
hello it's my first time playing bg3 and modding this game specifically (I have modded cp77 and stardew valley in great amount) but I've tried a lot of troubleshooting and cannot manage to figure out why your mod configuration menu button won't show up in the main menu or when playing and I really hope I won't have the same treatment as baszermaszer <.<
Spoiler:
Show
ok so I downloaded your mod, a skip intro mod and a text font replacer mod and read their installation instructions the skip intro can simply be dropped in the bg3\data folder and it shows up fine on bg3mm and it works fine The text font replacer says it's an override and doesn't need to be in the load list but it's still not showing up step 1. the mod configuration menu says to press ctrl + shift+alt+t and get script extender (you can see on bottom left that it worked)
However the MCM button is not showing up at all
step 2 says to import the mod zip file into the bg3mm from the right panel then to the left panel then put it on the top, so like #0
step 3 says to save and export the load order, which I did by pressing the button in #3 and 4 on the picture below
pressing esc or insert also does nothing oh yeah the brown color and that icon shows this message:
so I think I'm ok but I wish I could permanently dismiss it
I could provide a log but I doubt it has anything that helps at my current level. I left the game back to main menu back to the game and got this****************************************************************************** * * * BG3 Script Extender Debug Console * * * ******************************************************************************
BG3Ext v25 built on Jul 2 2025 17:05:13 ecl::ScriptExtender::OnGameStateChanged(): Unloading session esv::ScriptExtender::OnGameStateChanged(): Unloading session CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions Initializing client with target context Game LUA VM reset Registered custom server network protocol Appending extender signature to ClientConnect Sending ExtenderHello to client Got extender support notification from host (version 1) Got extender support notification from user 65536 (version 1) esv::ScriptExtender::OnGameStateChanged(): Unloading session ecl::ScriptExtender::OnGameStateChanged(): Unloading session ecl::ScriptExtender::OnClientGameStateChanged(): Loading game session Initializing client with target context Game LUA VM reset esv::ScriptExtender::OnGameStateChanged(): Loaded module Initializing server with target context Game CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions LUA VM reset Not syncing adapters - DB not available esv::ScriptExtender::OnGameStateChanged(): Loading game session ScriptExtender::OnAfterOsirisLoad: 151418 nodes ExtensionStateServer::StoryLoaded() CustomFunctionInjector mapping phase: 1303 -> 1303 functions
I download all file manually and keep the mods file inside their folders like so
it's easier to enable and delete files that way
Looking at your troubleshooting section
I have no overlay
I did not alt-tab until the main menu showed up
other mods are not working
I have no imgui.ini in the app data bg3 folder
I tried the dx11 and vulkan way but no changes
update:
Spoiler:
Show
ok the mod loaded fine now. I still don't understand how to fix this message that says it is "inactive". I placed the mod on top, had to close bg3mm and other stuff I don't understand to have it work at last. in-game mod manager says I only have the text font mod.
bg3mm shows I should have more mods
I'm sorry how????
I'm too tired to deal with this
I hope you can understand what the issue is and could share how to fix this issue
If you're installing mods manually, install them through BG3MM instead. Also, the in-game mod manager is badly designed, avoid it as much as possible. You can seek help with your load order in Larian's Discord server. Something could be resetting your load order. This is not related to MCM, sorry.
I don't have the computer at the moment but I can say I always download them through bg3mm. I only used in game nod manager to check mods are properly installed.
I'll try asking in the larian discord later but I doubt they'll help with the bg3mm though
Question, where do I manually install this mod? I prefer not using mod organizers and just putting them into the game folder directly. Is there a way I can do that with this mod or do I 100% need to mod manager?
You can install this manually, I just wouldn't be able to tell you how. Installing BG3 mods manually is very cumbersome and not worth it, really. You can't just drop them in a mod folder.
extract the .pak in the BG3/mods location found in appdata/local/LarianStudios/Baldur's Gate 3/Mods this will be in /users on windows, or in /compdata in the steam folder on linux. That being said if your on windows or a more common linux distro with documentation to get BG3MM working you really should use it. It's going to make everything about installing mods and managing them easier.
Out of over 200 mods I finally found the conflict.
Books Notes Zero Weight
not an issue with MCM. just putting this here in case it helps other people. last updated 2023 so just remove it and use a mod to increase carry weight instead.
Hey Volitio! Can't live without your mod, hands down amazing! But I have an issue. Not sure if its related to your mod, but I thought it best to bring it to your attention.
Using BG3MM 1.0.12.9 MCM pak top of load order (before other SE mods) - check 'No press any key' not installed - check Latest version SEv24 installed - check
Deleted modsettings file (virgin file), saved, re-exported load order via BG3MM Launched game.
On the BG3 game home screen under 'mod manager' the following txt is displayed
"MCM is 'inactive' in your load order, make sure you saved and exported your load order, Issues may stem from using the in-game mod manager or mods with invalid UUIDs. Use BG3MM 1.0.12.8+ (which im using!) This message won't appear is MCM is active"
When I go into the 'in-game' mod manager to see whether MCM is present, MCM is indeed not even there TOO activate? Extremely odd I leave the game and go back to BG3MM only to find that my load order has moved right! I re-install the load order once more, export and re-launch only to get the same issue
MCM is once again not present in the in-game mod manager and no mods are installed, plus I get the same message shown above on the BG3 home screen...
UPDATE: Mod manager says that my load order was reset 'externally?' Also, when I search for your mod under the in-game mod manager search tool I dont see it? is that intentional?
UUID issue? BG3 in-game manager not seeing your mod for some reason?
my modsettings list definately sees it as present after export?
Some invalid mod in your load order is causing the load order to reset. Could just be the IGMM too, I don't know. MCM won't appear in the IGMM because it is an override, and it is not available on mod.io.
Hi Volito, Wow! You got back to me! Thank you. Has to be another mod, although im not sure which. I havent changed anything over the past month or so other than upgrade BG3MM to 1.0.12.9. Been on SE v.24 for a while now just like everyone else. I'll strip things back a bit and see what happens! Thanks again for the advice, keep up the amazing work my mate (from down here in sunny Aus)
UPDATE! Found it, I mistakenly installed a UT version of a mod I have instead of the correct one, feel like an idiot! Thanks for pointing me in the right direction though, thats the fun of modding I guess!
Hi, I'm having a problem and I wanted to know if anyone else has had it or knows how to solve it. When I open the MCM window and try to configure a mod, when I click on something, it goes back to the beginning of the screen. (Example: I'm going to try to configure Expansion: I scroll down to change the options at the bottom, when I click on an option, MCM goes up as if I were using the mouse scroll to go up the page) Does anyone know how to solve this? Because I can't configure anything that requires me to go down the page.
I managed to fix it, apparently there was a problem with the mods loading order, I changed them and now everything is normal, anyway thanks for answering me.
Possible fix for load order being reset, if it's not being done by a bad mod:
1. Make a txt file called steam_appid.txt in the bin folder. type 1086940 into it. You can fin bin folder here: C:\Program Files(x86)\Steam\steamapps\common\Baldurs Gate 3\bin
2. Making sure the ModCrashSanityCheck folder is always deleted before starting the game. You can find your ModCrashSanityCheck folder here: %LocalAppData%\Larian Studios\Baldur's Gate 3\ModCrashSanityCheck
Step 2 can be skipped if the folder does not exist.
1321 comments
Script Extender's implementation of IMGUI, the UI library used by MCM, has been improved, but is still in development. Therefore, some issues beyond my control may arise when using MCM with certain setups. Mods that depend on MCM should still work regardless of whether MCM shows up or not. Script Extender v18 likely improved compatibility with older GPUs.
If you're having trouble with MCM not appearing, please follow these steps to narrow down the issue:
Reporting issues:
Known SE issues:
If you enjoy MCM, consider politely asking other mod authors that use Script Extender to add integration!
Tips and endorsements are also appreciated, thanks!
This is MCM's biggest update so far, with a lot of very important new features and fixes. I hope you enjoy it. As always, let me know if you face any problems.
I've poured several hundred hours into developing MCM, and with my recent layoff, every bit of support helps keep this going. If you've enjoyed using MCM or my other mods, please consider donating or supporting me on Patreon; your support can make a huge difference!
A heartfelt thank you to everyone who donated following my GPU failure 💜!
Turned out to be caused by ImpUI_P8_Fork.
Also, I like to use dummy separators in BG3MM, but those are also causing MCM to report being inactive.
Would love to know why these conflicts occur, if anyone knows.
Thanks. Everything works now.
Some game just do not like reading multiple folders deep.
<.<
ok so I downloaded your mod, a skip intro mod and a text font replacer mod and read their installation instructions the skip intro can simply be dropped in the bg3\data folder and it shows up fine on bg3mm and it works fine
The text font replacer says it's an override and doesn't need to be in the load list but it's still not showing up
step 1. the mod configuration menu says to press ctrl + shift+alt+t and get script extender (you can see on bottom left that it worked)
However the MCM button is not showing up at all
step 2 says to import the mod zip file into the bg3mm from the right panel then to the left panel then put it on the top, so like #0
step 3 says to save and export the load order, which I did by pressing the button in #3 and 4 on the picture below
pressing esc or insert also does nothing
oh yeah the brown color and that icon shows this message:
so I think I'm ok but I wish I could permanently dismiss it
I could provide a log but I doubt it has anything that helps at my current level. I left the game back to main menu back to the game and got this
******************************************************************************
* *
* BG3 Script Extender Debug Console *
* *
******************************************************************************
BG3Ext v25 built on Jul 2 2025 17:05:13
ecl::ScriptExtender::OnGameStateChanged(): Unloading session
esv::ScriptExtender::OnGameStateChanged(): Unloading session
CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions
CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions
Initializing client with target context Game
LUA VM reset
Registered custom server network protocol
Appending extender signature to ClientConnect
Sending ExtenderHello to client
Got extender support notification from host (version 1)
Got extender support notification from user 65536 (version 1)
esv::ScriptExtender::OnGameStateChanged(): Unloading session
ecl::ScriptExtender::OnGameStateChanged(): Unloading session
ecl::ScriptExtender::OnClientGameStateChanged(): Loading game session
Initializing client with target context Game
LUA VM reset
esv::ScriptExtender::OnGameStateChanged(): Loaded module
Initializing server with target context Game
CustomFunctionManager::ClearDynamicEntries(): Clearing dynamic functions
LUA VM reset
Not syncing adapters - DB not available
esv::ScriptExtender::OnGameStateChanged(): Loading game session
ScriptExtender::OnAfterOsirisLoad: 151418 nodes
ExtensionStateServer::StoryLoaded()
CustomFunctionInjector mapping phase: 1303 -> 1303 functions
I download all file manually and keep the mods file inside their folders like so
Looking at your troubleshooting section
update:
ok the mod loaded fine now. I still don't understand how to fix this message that says it is "inactive". I placed the mod on top, had to close bg3mm and other stuff I don't understand to have it work at last. in-game mod manager says I only have the text font mod.
bg3mm shows I should have more mods
I'm sorry how????
I hope you can understand what the issue is and could share how to fix this issue
You can seek help with your load order in Larian's Discord server. Something could be resetting your load order. This is not related to MCM, sorry.
I don't have the computer at the moment but I can say I always download them through bg3mm. I only used in game nod manager to check mods are properly installed.
I'll try asking in the larian discord later but I doubt they'll help with the bg3mm though
this will be in /users on windows, or in /compdata in the steam folder on linux.
That being said if your on windows or a more common linux distro with documentation to get BG3MM working you really should use it. It's going to make everything about installing mods and managing them easier.
Books Notes Zero Weight
not an issue with MCM. just putting this here in case it helps other people. last updated 2023 so just remove it and use a mod to increase carry weight instead.
Can't live without your mod, hands down amazing! But I have an issue. Not sure if its related to your mod, but I thought it best to bring it to your attention.
Using BG3MM 1.0.12.9
MCM pak top of load order (before other SE mods) - check
'No press any key' not installed - check
Latest version SEv24 installed - check
Deleted modsettings file (virgin file), saved, re-exported load order via BG3MM
Launched game.
On the BG3 game home screen under 'mod manager' the following txt is displayed
"MCM is 'inactive' in your load order, make sure you saved and exported your load order, Issues may stem from using the in-game mod manager or mods with invalid UUIDs. Use BG3MM 1.0.12.8+ (which im using!) This message won't appear is MCM is active"
When I go into the 'in-game' mod manager to see whether MCM is present, MCM is indeed not even there TOO activate? Extremely odd
I leave the game and go back to BG3MM only to find that my load order has moved right! I re-install the load order once more, export and re-launch only to get the same issue
MCM is once again not present in the in-game mod manager and no mods are installed, plus I get the same message shown above on the BG3 home screen...
UPDATE: Mod manager says that my load order was reset 'externally?'
Also, when I search for your mod under the in-game mod manager search tool I dont see it? is that intentional?
UUID issue? BG3 in-game manager not seeing your mod for some reason?
my modsettings list definately sees it as present after export?
<?xml version="1.0" encoding="UTF-8"?>
<save>
<version major="4" minor="8" revision="0" build="100" />
<region id="ModuleSettings">
<node id="root">
<children>
<node id="Mods">
<children>
<node id="ModuleShortDesc">
<attribute id="Folder" type="LSString" value="GustavX" />
<attribute id="MD5" type="LSString" value="34a0c6d5bef9658123228d6a19a5cc00" />
<attribute id="Name" type="LSString" value="GustavX" />
<attribute id="PublishHandle" type="uint64" value="0" />
<attribute id="UUID" type="guid" value="cb555efe-2d9e-131f-8195-a89329d218ea" />
<attribute id="Version64" type="int64" value="145241302737902957" />
</node>
<node id="ModuleShortDesc">
<attribute id="Folder" type="LSString" value="BG3MCM" />
<attribute id="MD5" type="LSString" value="" />
<attribute id="Name" type="LSString" value="Mod Configuration Menu" />
<attribute id="PublishHandle" type="uint64" value="0" />
<attribute id="UUID" type="guid" value="755a8a72-407f-4f0d-9a33-274ac0f0b53d" />
<attribute id="Version64" type="int64" value="40673134134689792" />
</node>
Didnt include the rest...
Any ideas? can you help?
MCM won't appear in the IGMM because it is an override, and it is not available on mod.io.
UPDATE!
Found it, I mistakenly installed a UT version of a mod I have instead of the correct one, feel like an idiot! Thanks for pointing me in the right direction though, thats the fun of modding I guess!
Patch 8 -> v23
Patch 8 + Hotfix 1 -> v24
You need to update the game.
(Example: I'm going to try to configure Expansion: I scroll down to change the options at the bottom, when I click on an option, MCM goes up as if I were using the mouse scroll to go up the page)
Does anyone know how to solve this? Because I can't configure anything that requires me to go down the page.
1. Make a txt file called steam_appid.txt in the bin folder. type 1086940 into it. You can fin bin folder here:
C:\Program Files(x86)\Steam\steamapps\common\Baldurs Gate 3\bin
2. Making sure the ModCrashSanityCheck folder is always deleted before starting the game. You can find your ModCrashSanityCheck folder here:
%LocalAppData%\Larian Studios\Baldur's Gate 3\ModCrashSanityCheck
Step 2 can be skipped if the folder does not exist.
Credit for the fix goes to LaughingLeader