Skip to content

Latest commit

 

History

History
67 lines (57 loc) · 2.5 KB

troubleshooting.md

File metadata and controls

67 lines (57 loc) · 2.5 KB

Tips for finding out and reporting bugs or crashes.

Introduction

This page describes how to properly report bugs etc. as well as self help tips.

Where to report problems

What we will ask from you

So how about saving your time as well as ours and providing the answers before we get a chance to ask them? You might also find the cause by yourself.

  • Do you have an integrated Intel graphics card (e.g. a non-gaming laptop)?
    • There is your cause for the crash - Stunt Rally needs a decent GPU, nothing we can do
      apart from recommending you to upgrade your hardware (or visiting a friend with better hardware, or borrowing it ;)
  • What operating system are you using?
  • What version of Stunt Rally?
  • From where did you install SR?
    • If you are not using the latest release version of SR, we'll probably ask you to upgrade and test that.
    • If you aren't using our binaries, we will probably recommend trying them (unless you are already building from sources).
  • When did the crash or bug occur?
    • Did you get any graphics?
    • Did you get to the menu?
    • After loading a track?
    • What triggered it?
    • Does it repeat?
  • Please post ogre.log file (or ogre_ed.log for editor)
    • Their location is given on the Paths page. Also in Game, bottom of Help tab.
    • Use attachments if on forum
  • Please follow up
    • Fixing bugs might take days or longer
      We are not always able to reproduce the problem (e.g. due to missing hardware).
      If we can't replicate it, we rely on your testing and confirmation of fixes.

Debugging yourself

If you wish to be extra helpful (and are on Linux), you can provide a stack trace of the crash.

  1. Install gdb, the GNU Debugger
  2. Install stuntrally-dbg or similar, i.e. Stunt Rally with debugging symbols. You can also compile the game yourself with the debugging info.
  3. Run SR through the debugger:
    • $ gdb stuntrally
    • (you are taken to gdb prompt)
    • run
    • (wait for the crash)
    • bt (stands for backtrace)
    • Copy-paste the resulting trace to use as with the log files