Ludeon Forums

Ludeon Forums

  • November 15, 2019, 07:13:49 AM
  • Welcome, Guest
Please login or register.

Login with username, password and session length
Advanced search  

Author Topic: How to Report a Bug  (Read 23808 times)

enystrom8734

  • QA Specialist
  • Global Moderator
  • Colonist
  • ****
  • Posts: 261
  • I get paid to break things.
    • View Profile
How to Report a Bug
« on: November 04, 2013, 08:38:21 AM »

Look around to see if your bug has already been reported in this forum and on Mantis.

Do not post bugs from games with mods active. If you find a bug with a specific mod, inform the mod author.  If you aren't sure which mod caused it, post in Mod Bugs.

For the thread title, write a one-line summary of what happened with version in [brackets] at the start.
  • BAD: "Sieger AI bug". This is not a summary, it's a label.
  • GOOD: "[B19] Siegers eat each other after running out of food". Succinctly summarizes the issue.

When reporting a bug, please include:

  • What the circumstances were.

  • What happened.

  • What you expected to happen.

  • Steps we can follow to make the bug appear on our machine. This part is important! We need a set of steps which we can follow to get the same results you're seeing. Ideally you'll test these steps to make sure they work from scratch.

  • Savegame file
    It's very helpful to include a savegame, especially when you have trouble reproducing the bug.

    - Windows users can find their save files by clicking the 'open save games folder' button in the in-game Options menu.
    - Mac users don't have it quite so easy, and you will need to navigate to the save folder manually, which can be found here: /Users/your user name/Library/Application Support/RimWorld . Or you can search for .rws files. Although note that the Library folder could be hidden which might prevent you from both navigating to it and searching for .rws files. More information on where and how to find your save files on the Mac can be found in the following post/thread: https://ludeon.com/forums/index.php?topic=35625.msg367050#msg367050

    This forum has a 600kb limit for attachments, so the save file (which will have a .rws extension) will be too big to post as it is. But you might be able to attach it after zipping it with a utility such as WinRAR or 7zip. If it's still to big to attach then you can upload it to Google Drive / One Drive / Dropbox / Zippyshare (or other such cloud storage / file sharing service) and post the download link in your bug report.

  • Log File
    Posting a log file means uploading the log RimWorld generated. Here's where to find it:
    • Windows (Steam): C:\Program Files (x86)\Steam\steamapps\common\RimWorld\RimWorldWin_Data\output_log.txt
    • Windows (non-Steam) has TWO possible locations:
      • RimWorld####Win\RimWorld####Win_Data\output_log.txt
      • %userprofile%\AppData\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\output_log.txt
    • Mac (Steam): Users/<UserName>/Library/Logs/Unity/Player.log
    • Mac (non-Steam): /Users/[your user name]/Library/Logs/Unity/Player.log
    • Linux (Steam): /home/<UserName>/.config/unity3d/Ludeon Studios/RimWorld/Player.log
      Note: You must run RimWorld from the console or the log file will not be created.  If you don't run RimWorld from the console, you may find the log at /tmp/rimworld_log
    • Linux (non-Steam): /home/[your user name]/.config/unity3d/Ludeon Studios/RimWorld/Player.log

Thanks!
« Last Edit: September 17, 2018, 01:35:44 AM by Tynan »
Logged
E Nystrom - @enystrom8734