309 ratings
Mod not working? Mods still have their effects after you disable them?
By -bg-
Basic troubleshooting guide for mod problems.
Troubleshooting mods
Whenever you have some mods not working or fail to disable properly, here are 3 steps that you should do first before bugging others, since the game does not properly disable mods when you disable them, this can cause a lot of conflicts when you swap mods out leading to strange behaviours or even crashes.

1. Clean up your override configurations

Go to your Documents\My Games\XCOM 2\XComGame\Config\XComEngine.ini and look for every lines that starts with "ModClassOverrides=", and remove all of them, these lines are added by mods that requires overriding other base game classes, but the game never removes them once you disable the mods, this can easily cause disabled mods to still affect your gameplay.

Note that ever since Alien Hunters patch, you only need to do this step once after the patch, as the modoverride lines no longer gets written to the file permenantly, but the lines added before the patch does not get cleaned up automatically.

2. Still not working? Verify Game Cache

Before verifying game cache, just to be safe, you might also want to clear out Documents\My Games\XCOM 2\XComGame\Config\ , as the problems mentioned above, the game might fail to clear out edits made by other mods, deleting them will cause the game to generate a new set of config, beware this will clear all your user data such as settings and custom INI tweaks (but not saves), so make a backup before doing this.
To verify game cache, go to steam library, right click your game, select properties, then select the local files tab and click verify game cache.

3. Most mods should work now, but if some of them are still not working, verify if they are not in conflict with each other.

go back to Documents\My Games\XCOM 2\XComGame\Config\XComEngine.ini from step 1 after you run the game once with just the mods you want to be enabled, then look for the "ModClassOverrides=" lines again, make sure no 2 lines have the same "BaseGameClass=" properties, if there are, you just enabled 2 conflicting mod, repeat step 1 and disable the conflicting mod (you can see which mod add those lines by going to <steam library folder>/workshop/content/268500/<mod ID>/Config/XComEngine.ini

If the mods are still not working after the above 3 steps, contact the mod author and state your issue clearly. Happy modding!
Mods not activating/deactivating properly in WOTC
Since war of the chosen, there have been reports of mods that are activated not working or mods that are disabled still persisting in game. This is due to the ModOptions config not getting read/write properly. This can be fixed by deleting all lines that starts with
in these 2 files:
<documents>/My Games/XCOM2 War of the Chosen/XComGame/Config/XComModOptions.ini <steam library folder>/steamapps/common/XCOM 2/XCom2-WarOfTheChosen/XComGame/Config/DefaultModOptions.ini

You may need to re-enable your mods after doing this step.
< >
initium Apr 7 @ 7:38pm 
I've just run through these instructions. Went to both the ModOptions.ini files listed above and found I had 7758 ActiveMods. Wooo! I've only recently re-validated my game and have 176 mods which are not all active.
How does that happen?
Also even though I uninstalled, validated the game and then reinstalled mods in the order I wished for them to run, the game still seems to load as it likes. So Community Highlander is the 69th mod to load rather than the 1st I wanted it to be.
I'm switching over to the alternative mod launcher in the hope this is sorted.

Website link [github.com]
-bg-  [author] Mar 13 @ 3:58pm 
that error do not cause crashes
Rumpdebump Mar 12 @ 9:21pm 
The big issue im having with my mods is that I read the crash logs stating that Log: LoadAnIniFile was unable to find FilenameToLoad: C:\Program Files (x86)\Steam\steamapps\common\XCOM 2\XCom2-WarOfTheChosen\Binaries\Win64\..\..\XComGame\Config\DefaultrobojumperSquadSelect_NullConfig.ini
This happens with each of my mods before it causes a crash report. Ive done every process on here, ive unsubbed and resubbed, but just to no avail. Can anyone help me out here?
moixcom Mar 8 @ 6:41pm 
i had some mods not working after the legacy pack purchased and yeah, i accessed those two files listed above, open them and deleted all contents then saved the file. load xcom2, hit refresh, and then select all mods. play new game. at this point, it's like still vanilla, with no mods. even the MCM is not present. quit game. reset computer. load xcom2 again, then refresh, select all mods, and viola. all mods you subscribed working well.. time to start a new game, COMMANDER.
Kaotic_Slaughter Feb 26 @ 2:05pm 
This was a great help! For me the defaultmodoptions.ini had a ton of old mods and kept being appended to my XComModoptions.ini in the documents folder, causing all kinds of crashes. After clearing out both of these files as described and then re-selecting the mods i now want to use, everything works fine!
Railfan Feb 15 @ 12:28pm 
Hi. I have tried the steps mentioned, and this doesn't work for me sadly.
Freddy Ilak Dion Plays Dec 18, 2018 @ 1:33pm 
...Okay, nevermind apparently, for some reason them od actually IS working now.
Freddy Ilak Dion Plays Dec 18, 2018 @ 9:19am 
I would if XCOM 2 would let me launch the game with it. As it stands it won't whenever I try to launch the game with any mods that show as "incompatible." Even though this is a mod I have not even used before and so far haven't been able to. I don't even have any mods that would be incompatible with the one I'm trying to use just, it shows as it not working for WotC and that's it. It won't let me play the game, as long as it's like that.
-bg-  [author] Dec 18, 2018 @ 6:05am 
Ignore the incompatible message, not all mods are incompatible and Firaxis did not add a flag to tell it your mod is compatible with both versions
Freddy Ilak Dion Plays Dec 17, 2018 @ 11:42pm 
How do you get a specific mod to actually work for WotC? Trying to use a colours mod but the game keeps showing it as incompatible. (But apparently it is.) Is there a specific thing I should look for or something?