Troubleshooting

Errors in the Game

A program as big and complex as Eressea inevitably contains errors. The design team strives to find and correct these errors as quickly as possible, but bugs will still appear.

If you can't live with that, you shouldn't play Eressea!

It is not possible to rerun a turn for an individual player. It's either all the players or none of them. Because of this, reruns are rarely ever done, and only if the bug affects a large number of players and is deemed threatening to their existence.

It is also not always possible to compensate for or replace losses caused by errors, especially if people or objects such as ships or buildings are lost.

Even then, it's still a decision that is made by the game masters alone, and is not guaranteed. Minor mistakes often affect many factions, so that on the whole it balances itself out.

Every player is asked to make errors they encounter known to the game masters, also and especially if they profit from them. The best way to do this is to file bug report on Mantis.

Bug Report

Eressea is not without errors, but there are not many. If you think that you have found an error, please proceed as follows:

1. Double-check that the error is really in the program. Sometimes you just overlooked some detail.
2. Read the E-Announce mailing list, the existing bug reports on Mantis, or the #general channel on Discord: sometimes somebody else already found and reported the same error, so your report would not be helpful.
3. Try to remember how the error happened. Collect all the necessary information. File a new bug report on Mantis. It should contain:
   1. your faction number
   2. numbers of the affected units, ships, or other objects
   3. messages from the report relevant to the event
   4. names and ids of regions where the error happened
   5. relevant parts of the current or earlier reports
   6. relevant parts of your orders
   7. the server version that caused the error
   8. a description that contains all information to understand and reproduce the error; including
   9. the initial situation
   10. what you expected to happen
   11. what actually happened
   12. Please do not attach your whole report, if not requested! Bug reports are generally public information.
   13. If you must submit your report or information that you do not want your fellow players to know, add a note to your existing report and mark it as "private".

Please don't be impatient if you do not get an answer right away. If you need help right away, ask on Discord.

Bug fixes are generally not included into the running server right away if they are not serious. Instead, the new code is tested first and then rolled out quarterly after an announcement. This ensures the stability of future turns. So if a bug is marked as "resolved" this does not automatically imply that it won't happen again the next turn.