████████╗██╗  ██╗███████╗ ██████╗ ████████╗ ██████╗ ██╗    ██╗███╗   ██╗
╚══██╔══╝██║  ██║██╔════╝██╔═══██╗╚══██╔══╝██╔═══██╗██║    ██║████╗  ██║
   ██║   ███████║█████╗  ██║   ██║   ██║   ██║   ██║██║ █╗ ██║██╔██╗ ██║
   ██║   ██╔══██║██╔══╝  ██║   ██║   ██║   ██║   ██║██║███╗██║██║╚██╗██║
   ██║   ██║  ██║███████╗╚██████╔╝   ██║   ╚██████╔╝╚███╔███╔╝██║ ╚████║
   ╚═╝   ╚═╝  ╚═╝╚══════╝ ╚═════╝    ╚═╝    ╚═════╝  ╚══╝╚══╝ ╚═╝  ╚═══╝
   A game by Lobby

Hello there! It's an honor to see that you're playing our game TheoTown. :)


## Troubles running the game?

If the game does not start, please try installing Java manually: https://www.java.com/download/
After installation you may need to restart your PC.

If you still receive error messages, make sure your graphics drivers are up to date.

For Intel GPUs it may help to use a specific Java version:
https://forum.theotown.com/viewtopic.php?t=11148

If the game does still not launch, you may try using an alternative graphics backend.
To enable it, open the game's properties in Steam and add the following start parameter:
:-angle
(Literally, the parameter starts with a colon.)


### High DPI displays (Windows only)

If the interface appears too small on high DPI displays, you can enable Windows DPI compatibility
mode for TheoTown.exe. For that, right click TheoTown.exe
-> Properties
-> Compatibility
-> High DPI settings
-> Enable "Override high DPI scaling behavior"
-> Select "System"
(The exact wording may vary depending on your Windows version and language.)


### Out of memory errors

If you encounter memory errors or cannot generate the largest region sizes, you may try allowing
Java to use more RAM.

Add the following launch argument in the Steam launch settings:
 -Xmx1024m
 This allows the game to use up to 1 GB of RAM.


## Game files access

Your game data is stored here: C:\Users\YOUR_USERNAME\TheoTown

Maps and plugins are compatible with the Android and iOS versions of the game.


## Links & Contact

Forum:           https://forum.theotown.com
Changelog:       https://theo.town/changes
Bug Reporting:   https://forum.theotown.com/bug-reporting
Plugin creation: https://forum.theotown.com/viewtopic.php?f=41&t=2965
Facebook:        https://www.facebook.com/theotowngame/
Instagram:       https://www.instagram.com/theotowngame/
Bluesky:         https://bsky.app/profile/theotown.bsky.social

You can also contact us directly at: info@theotown.com


## Hotkeys

ESC           Game menu
M             Minimap
* / =         Zoom in
-             Zoom out
WASD / Arrows Scroll camera
Q             Rotate left
E             Rotate right
12345         Speed control
6             City information
7             Rating
8             Rank
9             Date
0             Budget
COMMA         Ranks
PERIOD        Alerts
APOSTROPHE    Demand
DEL           Delete selector
TAB           Next toolbar tool
SHIFT + TAB   Previous toolbar tool
BACKSPACE     Previous toolbar category
SPACE         Pause / Show tool info
ENTER         Use selected tool
PAGE_UP       Increase level / size
PAGE_DOWN     Decrease level / size
B             Build menu
R             Roads
T             Terrain
Y             Energy
U             Water
I             Education
O             Parks
P             Police
F             Fire department
G             Road decoration
H             Health
J             Sports
K             Management
L             Awards
Z             Zones
X             Disasters
C             Recent
V             Hills
N             Trees
