Skip to content

Reporting Bugs and Crashes

billw2012 edited this page Oct 7, 2019 · 2 revisions

Where to report bugs and crashes:

Preferably as a post in the pinned bug reporting topics in the Bugs and Crashes sub-forum.

Alternatively a separate post in that forum if a lot of detail is required.

There is also the #crashes and #bugs channels in the discord server.

Things that will help us diagnose a bug or crash:

  1. A clear description of what you were doing when the bug or crash occurred.
  2. A save file in which the bug or crash can be reproduced. If it happens on an action then the save file should be at a point where we can perform that action and (hopefully) reproduce it. If it happens during the AI turn then the save should be at a point where we can press "end-turn" and reproduce it. If it isn't reliably reproducible then a description of how often we might expect the bug or crash to occur, and under what circumstances. Save files are probably located in your Documents\My Games\beyond the sword\Saves directory.
  3. A crash dump - these are generated when the game crashes to desktop, and are useful to give some information about what caused a crash. Crash dumps are located the same directory as the Civ4BeyondSword.exe, and are named something like MiniDump-v40-dev-20190822-220915.dmp. You can sort them by Date modified to get the newest crash dump(s).
  4. Your UserSettings directory - these are the mod settings files (as set through BUG), and can be useful to help us recreate the exact same conditions as caused your crash. These are found in the Mods\Caveman2Cosmos directory you installed the Mod to.
  5. Python logs - these are useful when diagnosing Python bugs, or crashes that originate or include Python calls. They are named PythonDbg.log and PythonErr.log and are found in your Documents\My Games\beyond the sword\Logs directory.
  6. Screen shots - if the bug manifests visually then these can be useful. On Windows 10 you can press Windows Key + Shift + S to open the clipping UI. It will put the result directly into your clipboard so you can paste it into either discord or a forum post.