tirnanog-player/docs/controls.md

TirNanoG Player Controls

These are always the same, no matter the game.

Keyboard

1. Esc game menu or exit HUD windows
2. Tab inventory window (by pressing multiple times, it cycles through inventory tabs and inputs)
3. 1...9 quick access items on the belt
4. Ctrl default action (in menus, Enter)
5. arrows player movement
6. any key, start text chat (multiplayer only)
7. Super keep pressed for voice chat (multiplayer only)

Mouse and Touchscreens

Depends on where you click (or tap) on the screen.

1. game menu
2. inventory window (click or tap on the tabs to change them)
3. quick access items on the belt
4. default action
5. player movement

With mouse, you probably want to click on the center of the screen for movement and action. However with tapping it can be annoying that you can't see your character from your own hand, so the touchscreen controls can be found on the bottom left and right corners as well (on desktop the touch-screen controls can be enabled with the -t command line flag). Chat is accessible from the game menu.

Normally with touch-screen devices when text has to be entered, then the OS provided on-screen keyboard is shown. But you can turn that off and use the built-in on-screen keyboard (see below) instead with the -k command line flag.

Game Controller

1. Left shoulder game menu or exit HUD windows
2. Right shoulder inventory window (by pressing multiple times, it cycles through inventory tabs)
3. A, X, Y quick access items on the belt
4. B default action
5. Left joystick, Right joystick player movement (however they might control different HUD windows)
6. Start start text chat (multiplayer only)
7. Guide keep pressed for voice chat (multiplayer only)

If you want to reassign buttons, you can provide your gamecontrollerdb.txt in the configuration directory. You can also set the responsiveness of the joystick in the gptres field of the config.json file located in the same directory.

When a gamepad controller is detected and text has to be entered, then an on-screen keyboard automatically pops up, so that you can type with a controller too. This is a very limited and simple on-screen keyboard without BiDi input method, but supports numbers, the most common symbols and currency signs, all uppercase and lowercase Latin, Greek, Cyrillic, Hebrew, Hirakana, Katakana and Devanagari letters. It isn't perfect, isn't particularly comfortable to use, but at least more than nothing.