Reporting Bugs

OpenSim is alpha software, this means that there are frequent bugs in the codebase, and many features that still need implementing. You can help us find and fix these problems by reporting bugs to us, our bug tracker also accepts patches if you are able to fix the bug.

Steps for reporting a bug

1. Visit opensimulator.org/mantis and search to see if your bug already exists. If it does, please add a note with any technical assistance such as steps to reproduce, symptoms, etc.

• A good bug report has the following properties
  • Succinct and to the point, IE: "Duplicating a primitive while sitting on it, crashes the region.".
  • Contains as much debug information as possible, if OpenSim threw an error before crashing it, a copy of this error is helpful. If not, pasting the last 50 lines from your opensim.log when appropriate is also potentially helpful.
  • If you can reproduce the bug, steps to reproducing it is a must.
  • Please do not submit bugs such as "OpenSim eats a lot of CPU time" without including information about your setup, and anything you or we may have done to trigger this, unfortunately we are not psychic and cannot guess what may have happened.

1. Create an account on the opensim mantis website, and hit 'Report new issue'. Please note that some free email providers may take a while for the confirmation email to appear.

Submitting Patches

You can submit your patch as a unified diff (`diff -u`) as a .patch file on any issue on Mantis, if it is a new feature or bugfix, you should tag the issue with the words [patch] to let us know there's a patch waiting to be applied. If you are using TortoiseSVN on Windows, you can right-click in the opensim directory and select "Create patch" to create a unified diff.

If you patch is not applied within approximately a week, please let a developer know on the -dev mailing list, or IRC channel and we will take a look at it. Please note not every patch is accepted - sometimes a solution may not be appropriate (and could break other things).