How to play

Your first login, the codes you must keep, the controls, chat and how to tell us when something breaks.

Open the game

Open the game in a recent browser (Chrome, Edge, Firefox or Safari, on a computer, phone or tablet). Nothing is installed: the first visit downloads about 5 MB before the login screen, and the rest of the world arrives while you play. Later visits start from the browser's cache.

A browser on a phone can add the game to the home screen (“Install” or “Add to Home Screen”); it then opens full screen.

Register with your invite code

  1. On the login screen choose New here? Create an account (or press F1).
  2. Pick a username (letters, digits, spaces and _, up to 12 characters) and a password (5 to 20 characters with a letter and a digit).
  3. Enter the invite code you were given. Registration is by invitation for now; one code makes one account.
  4. Confirm that you are 13 or older and accept the rules, then create the account.

Save the recovery codes

Right after you register, the game shows your recovery codes once. Save them now. Use Save as file or write them down and keep them somewhere safe.

They are the only way back into your account if you forget your password. Terr has no e-mail: nobody can send you a reset link, and the moderators cannot see or reset your password.

To use a code: on the login screen choose Forgot password? (or open the recovery page), enter your username, one unused code and a new password. Each code works once; when you are down to a few, make a new set in the game's account screen (see Account).

The queue screen

When many people log in at once, or the world is full, you see a queue card with your position and an estimated wait. Leave the page open: you keep your place and enter the world by yourself when it is your turn. Reloading puts you at the back.

If the world is restarting you see “Restarting” in the world list; the client reconnects on its own when it is back, usually within a minute.

Moving and doing things

Phones and tablets

Chat and reporting a player

Settings and performance

Open Settings (T, or the gear on the login screen). Under Graphics, the Quality preset Auto picks Low, Medium or High for your device while the world loads; choose one by hand if the game feels slow or your phone gets warm. The Performance tab shows the frame rate, the preset in use and why, and has Detect again. General holds the sound, the text size and the chat channels.

Shift+F3 shows the statistics overlay: the frame rate and draw counts, and a net line with the move echo (how long the server takes to answer a step), the data in and out and the number of reconnects. The problem sheet asks for it.

All the keys

Generated from the game's own key map, so this list matches the game.

Panels

ActionKeysWhereNote
InventoryIPlaying
EquipmentEPlaying
SkillsKPlaying
Quest journalQPlaying
FriendsPPlaying
SpellbookMPlaying
PrayersOPlaying
Combat optionsCPlaying
EmotesNPlaying
MusicUPlaying
SettingsTPlaying
ClanLPlaying
World mapWPlaying
Log outno keyPlayingno key on purpose: the Log out tab (Tab to it, Enter)
AchievementsJPlaying
Settings (F2)F2Playingwhile action-bar slot 2 is empty
Render statisticsShift+F3 or F3PlayingF3 alone while action-bar slot 3 is empty
Action bar slotsF1-F12PlayingF1-F12 use the item bound to that slot
Keys and help? or HPlayingEsc with nothing open opens it too

Camera

ActionKeysWhereNote
Turn the camera leftLeft or APlaying
Turn the camera rightRight or DPlaying
Tilt the camera upUp or RPlaying
Tilt the camera downDown or FPlaying
Zoom in=Playingor the mouse wheel; pinch
Zoom out-Playingor the mouse wheel; pinch
Orbit with the mousemouse or touchPlayingmiddle-button drag; two-finger twist

World

ActionKeysWhereNote
Walk to a spotmouse or touchPlayingclick or tap the ground, the minimap or the map's Walk here; from the keyboard: pick a target, G, Walk here
Act on a person or thingmouse or touchPlayingright-click or long press for its menu; from the keyboard: the target keys below
Next target nearby.Playingpeople and things within 10 tiles, nearest first
Previous target,Playing
Options for the targetGPlayingthe right-click menu, keyboard-navigable
Run / walkShiftPlayingtap Shift alone (Shift with another key does not toggle)
Next songPageDownPlaying
Previous songPageUpPlaying
Cancel / close / helpEscPlayingcloses the dialogue, cancels Use or a spell, hides the sidebar; with nothing open: Help (never quits)

Chat

ActionKeysWhereNote
ChatEnter or KpEnterPlaying
Chat command/Playing
SendEnterTyping in chat
Earlier linesUp or DownTyping in chat
Complete a nameTabTyping in chat
Stop typingEscTyping in chat

Dialogue

ActionKeysWhereNote
Choose option 1-91-9, 0Dialogue1-9, 0 for the tenth
Next optionDownDialogue
Previous optionUpDialogue
Choose / continueEnter or SpaceDialogue
Close dialogueEscDialogue

Windows

ActionKeysWhereNote
Use a slot or buttonTab or EnterWindowsTab moves between them, Enter or Space uses one, Shift+Enter the other action
A slot's menuShift+F10Windows
Close the windowEscWindowsbank, shop, trade, menus, the quantity prompt
Skip the sceneEscCutscene

World map

ActionKeysWhereNote
Move the mapLeft or RightWorld mapthe arrow keys; drag
Zoom the map= or -World mapPageUp / PageDown: floor
Back to youHomeWorld mapEsc closes the map

Login

ActionKeysWhereNote
Log inEnterLogin screenTab: next box
Log in / create an accountF1Login screen

Worlds

ActionKeysWhereNote
Pick a worldUp or DownWorld listEnter plays
BackEscWorld list

Creator

ActionKeysWhereNote
Change the lookUp or LeftCharacter creatorarrows pick and change a field, Enter enters the world

Connection

ActionKeysWhereNote
ReconnectEnterConnection lost
Back to the login screenEscConnection lost

Help

ActionKeysWhereNote
Close helpEsc or HHelp
Next help pageRight or LeftHelp

The native Linux client

The browser is the main way to play. On Linux there is also a native client (Ubuntu 22.04 or newer, Debian 12, Fedora 36 or newer; 64-bit, glibc 2.35 or newer, OpenGL 3.3). Get it from the download page, then:

sha256sum -c terr-VERSION-linux-x86_64.tar.xz.sha256
tar xf terr-VERSION-linux-x86_64.tar.xz
cd terr-VERSION-linux-x86_64
./terr.sh

It needs a few system libraries; ./terr.sh checks them and tells you what to install. On Debian or Ubuntu that is:

sudo apt install libsdl2-2.0-0 libsdl2-mixer-2.0-0 libenet7 libopengl0 libegl1

The package is unsigned: check the SHA-256 first. Its log files are in ~/.local/state/terr/ (the newest ten are kept; nothing is uploaded), the settings in ~/.config/terr/. The native client talks UDP to the game; if it cannot connect from your network, the browser version still works.

Something went wrong

Please fill in the problem sheet: it lists what helps us find the cause (the time, your device, the overlay numbers). The most useful reports are crashes or a black screen, a load that stops (with the % shown), disconnects (with the time), items or coins lost (exact amounts) and characters jumping around.