Mod not working? Mods still have their effects after you disable them?

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

ActiveMods

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.

[=FF= KoalaBear]

The first option helped restore a bunch of mods that I had installed including the One Million Colors mod sliders. Thank you!

[STEVEO46]

Thanks, hope this helps my crash problem with Jedi revised (fingers crossed!)

[SpyroThyKing]

So my problem is when i verify my game, it "installs" a bunch of old mods. so I should have 453 mods(according to my subscribed items), but I have 600+

[Starcruiser]

@Hornet - If you're using the Steam version (likely since Steam forum) verify your game cache integrity and it should reset everything, but still keep your subscribed mods intact. If that doesn't work you might need to delete the game's documents folder (after backing up the folder!). It will automatically recreate everything it needs, and you can put the save files back in place once it does.

[Napoleon Wilson]

The mods I use just crash my game. Can't figure out why.

[Hornet]

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]

@dean66683 : You can download mods on Nexus.
If a friend have Xcom2 on steam, you can manually copy his steam files mods.

[dean66683]

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]

thank you!!

[Cannon011]

don't seem to have an "XComEngine.ini" I have XcomEngine. Didn't see anything with ModClassOverrides.