Bug Reporting Guidelines

Most issues can be resolved directly on Discord or here in the forum with the help of our helpers. Please only use formal bug reports in cases where an issue cannot be resolved there. This helps us focus on issues that affect the game as a whole.

This page explains when a bug report via email is appropriate and how to submit one properly.
Please do NOT send a bug report if:
  • the issue is caused by a plugin
  • the issue cannot be reproduced
  • the issue has already been explained or resolved by helpers
  • the issue is a feature request or suggestion
In these cases, a bug report will not help and may not be processed.
When is a bug report appropriate?

A bug report via email is appropriate if:
  • the issue is reproducible
  • the issue affects core gameplay or multiple users
  • helpers were unable to resolve the issue
If you are unsure, please ask a helper first.
Show
How to send a proper bug report

Please send an email to:

bug@theotown.com

Include the following information in the email body:
  • Game version: (You will find it at the bottom of the game menu; it looks like 1.12.48)
  • Platform: (Android / iOS / PC)
  • Plugins installed: (yes/no)
  • Steps to reproduce:
  • Expected behavior:
  • Actual behavior:
  • Log files: (if available, the log.txt, out.txt and crash.txt files found in the game folder; see our FAQ on where the game stores files and how to access them)
  • Screenshots: (if it makes sense for the given issue)
Bug reports missing this information may not be processed.

Please keep the report factual and concise.
Important notes
  • You will usually not receive a personal reply.
  • Submitting a bug report does not guarantee that the issue will be fixed.
  • If a fix is made, it will be mentioned in the changelog.
Thank you for helping to improve TheoTown.