Sorry for the inconvenience caused by these Bugs. I’m new to Lua coding and trying to learn it. You are always welcome to report Bugs you have found. However, I need logging files to solve your problems. Also, please be patient. I’m not a professional Modder and always get too busy to log in the forum.

-How to report bugs?

(1) Enable logging:
Open config.ini with Notepad under ....\Documents\My Games\Sid Meier's Civilization 5:
Search for "EnableTuner = 0" and change it to "EnableTuner = 1"
Search for "LoggingEnabled = 0" and change it to " LoggingEnabled = 1"
Open config.ini with Notepad under ....\Documents\My Games\Sid Meier's Civilization 5:
Search for “ValidateGameDatabase = 0” and change it to “ValidateGameDatabase = 1”
You must start a new game to make these logging files work, run the game until your problem shows up. Then close the game and do the next.

(2) Upload Lua.log, Database.log, Gamecore.log, CustomMods.log, xml.log and xml-perf.log in your bug report:
Those files are under
...\Documents\My Games\Sid Meier's Civilization 5\Logs\

(3) Also upload the saved game in your bug report:
Saved games are under : ...\Documents\My Games\Sid Meier's Civilization 5\ModdedSaves\single\

----------------------------------------------------------------------------------------------------------------------------

-Known Bugs & Solutions:

(1) Important: 12 kb corrupted saved file & CTD when loading game:
In rare cases, the saved file may be corrupted (the size is 12 kb) due to unclear reason. It may have something to do with the conflict between the old database and the new one. This also happens in other large MODs. Once the saved file is corrupted, it will cause CTD when loading and cannot be repaired.
Solution:
It is predictable. Save the game every time when you start a new game and check the saved file size in ...\Documents\My Games\Sid Meier's Civilization 5\ModdedSaves\single (if it is corrupted, you always won’t feel any “lagging” after clicking the “save game” as normal saves). If it is 12 kb, you must return to the main menu, and load the mods again to start a new game. Its saved file will be fine in your new game.
You should empty all Civ5 cache files under My Games\Sid Meier's Civilization 5\cache\and all mod data files under Sid Meier's Civilization 5\ModUserData\ if you upgrade this mod to a newer version or change some settings in the .xml files inside this mod.
Save often, especially when playing large map with many AIs and start the game with IGE.
If the saved file is still corrupted, you may try to delete all contents in Super Power Balance (v 4)\XML\ NewCivilopediaTexts.xml and it should work. (It is weird; I don’t know why it has anything to do with the civilopedia texts)
Some reports indicate that play the game with DirectX 9.0 may solve the corrupted saved data problem.
If you suffer from repeated crash in the same turn and you think it has something to do with this MOD or DLL - Various Mod Components, please provide me with enough details, especially with logging files other than “it crashes” so I can work on it.

(2) CTD when playing unit animation:
It has been confirmed that such unit animation may cause CTD. Since I’m not able to modify the animation of these units’ animation, I can’t fix them for now. However they are not unavoidable. It won’t happen again when you reload your saved data.
When many airships and helicopters flying through water tiles, the game may crash. (That may be the reason why vanilla Civ5 requires helicopters to embark when entering water tiles)
When the rocket artillery (Katyusha) attacks a large group of enemy units, the game may crash.
Solution:
Turn off the “unit combat animation” and “unit moving animation” will 100% solve this problem. You may use the mod “Quick Turns” by gunstarpl to make it smoother.

(3)CTD at certain AI turns:
The stability of this mod should have been greatly improved after almost one year of codes fixing.
If you are so unlucky to encounter CTD at certain AI turns and won’t able to continue. Please report the Bug with your logging files. No one can solve the problem if you only tell “it crashes”.
If you really want to continue to play this saved game, you may try to use the IGE to delete all units of this crashing AI. If it works please let me know what this AI is doing when CTD happens.

(4) Tech-Tree messed up (scrollbar disappears)
Any mods with any changes in technology tree may cause the problem.
Solution:
Make sure there is no conflict with mods.
Make sure you have the correct game version (1.0.3.276 or 1.0.3.279).
You may try to disable Gods and Kings DLC if still not working.

(5) “Error loading font xml” or missing textures or units models
Make sure you have the correct game version (1.0.3.276 or 1.0.3.279) and all required DLCs installed.

(6) No strategic resource (eg. Horses and Coal) on Earth Map or some very old maps in vanilla Civ5.
Old format of maps are NOT supported in this mod due to the change in the resource distribution method.
Solution: Please do not use Earth Map in civ5 to play this mod. You can use other community-created Earth Maps such as Yet (not) Another Earth Maps Pack by Gedemon.

(7) Damage “Overflow”:
If you order an extremely strong unit to attack an extremely weak unit (eg: a GDR with many promotions attacks a catapult in the marsh), it may cause a data “overflow” and can only inflict 1 damage to the attacked unit.
Solution: It is not so easy to happen. If it happens, use ranged unit to attack.

(8) Research overflow, Culture overflow, or Trade Route distance overflow…
Solution: These are old bugs already fixed.
Please upgrade your mod to 5.0 and completely remove the old ones.
Please upgrade your DLL - Various Mod Components by whoward69 to the latest versions.

(9) Units destroyed by special attacking effects (AoE, collateral damage, charge damage) won’t offer you additional gold or culture if you have certain policy or trait. Fixing it is difficult and doesn’t pay. What’s more it may break the balance. So I don’t think it should be fixed.

(10) Since the paperwork is so huge, there may be some wrong description, grammar mistakes or leftovers in Civilopedia texts. Please point it out if you find them.


4,FAQs:

These “bugs” are not real bugs, they are settings! Please check the Civilopedia before playing this mod!

These settings are done with thought of balancing and stability. If you don’t like them, you could edit the .xml files inside this mod to change them.

(1) You CANNOT capture enemy’s workers or settlers. (May cause CTD when capturing stacked workers and this behavior is very uncivilized, so I forbid this setting)

(2) AI won’t build these world wonders, because they are useless to them: Machu Picchu, The Forbidden City, Big Ben, The Empire State Building and Khalīfa tower.

(3)You will get your allied City State self-produced strategic resource once you have researched the certain Technologies even they don’t have those resources on their land: 4 Horses, 4 Iron, 4 Coal, 4 Oil and 4 Aluminum. Don’t get confused.

(4)All your units won’t heal outside friendly territory unless earned some special promotions or there are units with “medic” promotion nearby.

(5)You cannot build a certain unit once reaching its limit. For example, you can only have up to 50 jet fighters. All unit class has a limit to stop AIs from building too many units of same type which cause lagging and instability in late-game.

(6)All air-superiority fighters can NOT attack land or naval units. They can only engage in air combat. The “air attack” order is only showing their intercepting range. If you want to attack land or naval units, build attack aircrafts.

(7)Only the fort and the citadel on coastal tiles can allow naval units to move in. Once they are inside the fort and the citadel They can attack but their defense is 0 and will be immediately destroyed if an enemy land unit moves in.

(8)Your cities will have negative gold income if you build too many buildings with extra cost according to the population in the city. Upgraded specialists in your cities also cost gold.

(9)The City Hall building won’t appear and corruption won’t happen right after your city is built. They will appear in the next turn. As a result, you must build anti-corruption builds after the City Hall building appears or they won’t work.

(10)You can only build military units in cities with military-production buildings. For example, tanks must be built in the city with an arsenal.