[BTS] Logfix Utility DLL 2016-10-05

1. First, verify that you do not have SimCutie's version of CIV4ColorVals.xml installed in your CustomAssets folder (it should be under .../XML/Interface/ if you have it.) If you do have this file, remove it from your CustomAssets because that's the file that has caused all this trouble and if it is still present, the save won't be fixed.
2. Backup your current <BTS Folder>/Assets/CvGameCoreDLL.dll to someplace safe.
3. Install (i.e. copy) the included CvGameCoreDLL.dll to your BTS Assets folder.
4. Launch BTS and load your problem savegame. Do NOT try and look at the log yet.
5. Hit the tilde key ("~") to enter the Python Console. You should see a small grey window appear over the interface which contains the following text (or something quite similar):
   
   
   
   
   
   And underneath that should be a green ">>" prompt. If you have the window but see no text and only have a ">" prompt, then you are in the "regular" console instead of the Python console; close the window using the same key and try it again because you need the Python console for this to work. On some keyboards, you must hold Shift in order to type the "~".
6. Enter the following command into the Python Console and hit enter:
   
   Code:

   CyGame().fixLog()

7. If all goes well, you should see a green event message saying how many log and replay messages were repaired. If you get an error message, make sure you typed the command exactly and that all the previous steps were followed.
   
   
8. Now you can close the console by again using the "~" key. You should now be able to view the in-game log and replay without crashing. Save the game and you're done. You can now continue playing from this save and the crash problem will be gone. You can repeat this process for any other problem saves you have as well.
9. After you quit the game, remember to restore your original DLL. While the included DLL will function the same as the official 3.17 DLL, it can cause a problem when trying to play "Locked Modified Assets" saves later such as those from the HoF mod or CFC GoTM. If you later need to fix another save, just switch back to the included DLL to do the fix and then restore the original afterwards.

The Source folder contains those files changed from Official 3.17 needed to compile this DLL. Two new functions were added, CvGame::fixLog() and CvPlayer::fixMessages() and the former was exposed to Python. This fixLog() function iterates over all replay messages making sure they have valid colors and changing any which are invalid to "COLOR_WHITE". It then calls fixMessages() for all the players in the game (except barbarians) which does the same thing for each player's message log entries. When done, it outputs an interface message to the screen which will persist in the active player's log for at least 10 turns. (Might be much longer; I don't know.)