201 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!
< >
fatbear Sep 12 @ 10:39pm 
For me this great info didnt help because I just reinstalled the game. But still, it doesnt work with mods, only if I disable them.

But at least I made it work! Just unsubscribed from all mods, run the game, then subscribed again. (I also turned off cloud so it wont copy back all saves, just in case.)

Now I dont know, can I turn cloud back on? It wont donwload all the saves again?
gravage Sep 6 @ 6:41am 
Thank you for this guide; I haven't needed it yet but it's nice to know it's here.
Dr Nilsson Sep 2 @ 1:03pm 
Thank you so much! This guide helped me a lot. :D
Stormwing Jul 31 @ 2:45am 
I assume this is the same for the smaller mod-packs for example the long war toolbox
-bg-  [author] Jul 31 @ 2:21am 
Stormwing Jul 31 @ 1:28am 
does the long war work with existing campaigns?
-bg-  [author] Jul 27 @ 9:54am 
if you don't have that line you can safely skip that step
pppatrik3 Jul 27 @ 2:27am 
why can i find the "ModClassOverrides=" line? i don't have that lane
-bg-  [author] Jul 14 @ 11:14am 
what menu
John McCreedy Jul 14 @ 4:02am 
I have done all of that and the menu still won't show.