395 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.
< >
Hornet Sep 17 @ 4:49am 
what to do when you cant find mod override at all and no traces of mods at all but game still says it exists
Albertine_Crowley Jul 9 @ 10:54pm 
@dean66683 : You can download mods on Nexus.
If a friend have Xcom2 on steam, you can manually copy his steam files mods.
dean66683 Jul 8 @ 2:48pm 
I am trying to add one of your mods to my xcom2 game. However i dont have the code to registor it on steam, so mod's don't download to the game. Can i download yours and other mods manually?
PlasmaDrone May 15 @ 7:45pm 
thank you!!
huntclan Mar 20 @ 1:29am 
don't seem to have an "XComEngine.ini" I have XcomEngine. Didn't see anything with ModClassOverrides.
Gas Mask Mar 13 @ 3:30am 
dude thanks this fixed my game
Grimjaw Jan 26 @ 3:18am 
So im getting a problem with New promotion screen by default by robojumper, i've been using this mod quite happily till now, all of a sudden when i hit promote the UI no longer shows up and i just see the soldier standing there in the background with no UI to select abilities. Have tried clearing config files and verifying files. Have asked several times on the mod authors page but get no response, from what i can tell there are no conflicts. Any ideas that could help me?
MinneIceCube Jan 20 @ 9:32am 
@Javaris Jamar Javarison-Lamar, Try going into your documents folder, not the game files under Steam's installation. I made the same mistake.
Javaris Jamar Javarison-Lamar Nov 28, 2019 @ 11:56pm 
hey when going into config i can't find the XComEngine.ini that you mentioned.
 Bayonetta  Aug 19, 2019 @ 6:23am 
+ i can see Gotcha Again ingame mod options*