--- Common Checklist ---
Civ 5 has several things everyone needs to check for when using any mod.
Summary:
- Everything up to date.
- Update between games.
- Try the English version.
- Delete the cache folder.
- Delete the ModUserData folder.
- Delete old mod versions.
- Load games from the main menu, and do not regenerate maps.
- Replacing farms crashes the game.
- If problems occur, check further on the list.
Details:
- Ensure your mods and Civ are up to date. Attempting to load mods or saves on incompatible versions of Civ usually crashes the game.
If you're on a mac and a recent patch has not been released for macs, download an older version of the mod. All versions of each mod are available in the mod's listing on the Mod Browser (see Spoiler dropdown below). Many mods on the Mod Browser have not been updated by their creators in months, and won't work with the latest patches; the threads here at CivFanatics are generally the best indicators of recent activity.
- Update mods between finishing one game and starting the next. Changing mods mid-game usually works but sometimes can crash the game or cause other weird effects.
.
- Play mods on the English version of Civ if possible. Some mods are compatible with other language versions, but most mods are less compatible. This is unfortunate, but due to the reality most modders don't have translation teams like Firaxis or other major game developers.
.
- Delete the cache folder. It contains temporary data that can cause bizzare bugs after changing mods:
C:\<username>\Documents\My Games\Sid Meier's Civilization 5\cache
.
- Sometimes if you delete the ModUserData folder it can solve rarer problems.
C:\<username>\Documents\My Games\Sid Meier's Civilization 5\ModUserData
.
- Ensure you have only one version of the mod installed in the MODS folder.
.
- Exit to the main menu to load games. Loading a savefile from within an active game breaks all mods with lua code.
UPDATE: it appears the same problem happens if we regenerate the map.
.
.
.
.
If you encounter problems while playing a mod . . .
.
- Try the mod on average map settings: standard size, standard speed, Continents script, default advanced game options. Some mods are incompatible with some map scripts.
.
- Try the mod alone with other mods moved out out of the Mods folder:
C:\<username>\Documents\My Games\Sid Meier's Civilization 5\MODS
.
- Verify the game files are not corrupted. Firaxis posted instructions on how to do this: click here.
.
- Check the load order of the mods you are using. The mod installed first loads first. To change load order:
- Move all mods out of the /MODS folder.
- Move in the mod you wish to load first.
- Enable it ingame.
- Repeat #2-3 for each additional mod, one at a time.
.
- Check if your problem is listed under the "Vanilla Bugs" below.
.
- Contact the mod author about the problem you've encountered. Most mods have a thread or forum here on CivFanatics to leave feedback.
--- Vanilla Bugs/Problems ---
Civ 5 has several things to consider when loading/using mods, but the good news is most problems are easily avoided:
- Farms: If you build a farm atop a hidden resource like Horses, then later reveal the horses and attempt to build a pasture, the game crashes. This also happens if the AI does it.
Workaround: None known.
.
- Cache: Cache does not clear after changing mods (causes unpredictable issues from data collision).
Workaround: Manually delete the cache folder.
.
- Reloading: Loaded within an existing game breaks mods with lua code.
Workaround: Exit to the main menu before loading games.
.
- Combat: Quick combat and strategic view break mods which detect combat.
Workaround: Avoid quick combat, and use normal view for combat situations and between turns.
.
- Installation: Multiple versions of a mod in the Mods folder breaks the game, since it loads data from all installed mods, not just enabled ones.
Workaround: Only have one version of each mod installed.
.
- Updates: Changing mods or mod versions mid-game typically crashes when attempting to load the save (instead of providing an error message).
Workaround: Update mods between finishing one game and starting the next.
.
- Resources: Any mods that add or modify resources are incompatible with the Lakes, Great Plains, and Highlands map scripts, as well as any scenarios or custom maps with pre-set resource locations.
Workaround: You can avoid these scripts entirely, or use altered versions of them that have no incompatibilities.
.
- Multiplayer: Mods do not work in multiplayer.
Workaround: None.
.
- Conflicts: Two mods can be incompatible with each other without having any obvious error messages. If you try using multiple large mods and it doesn't immediately crash, that doesn't mean that the mods work together; you might not see unusual behavior until hundreds of turns into the game.
Workaround: When in doubt, ask in the mods' threads here at CivFanatics.