Games controls
From Zacess Games v1.1.0. Edit this page on GitHub
Every key, command, flag, variable and setting in Zacess Games on one page. Key names follow Ctrl+C style. Letters work in upper and lower case alike unless a row says otherwise: in the three typing games every key types exactly what it shows, so there a and A are different characters. The rules of each game are in How to play.
Commands
| Command | Does |
|---|---|
zacess-games |
The menu of all fourteen games |
zacess-games <game> |
One game by name, such as zacess-games trace or zacess-games through-ball. A short start is enough, such as zacess-games stack |
zacess-games list |
Every game and its best score, as plain text |
zacess-games sounds |
Plays every effect with its name and meaning, then eight seconds of each game's music and six of its background sound |
zacess-games sounds <game> |
Plays eight seconds of one game's music and six of its background sound |
zacess-games snap [game] |
Writes SVG stills of one game or all of them into the current folder |
zacess-games snap [game] --frames <n> |
Plays each game's recording from scripts/recordings.txt and writes n frames of it as JSON, the format Zacess Scenes uses for its showcase frames |
zacess-games --help |
Every option |
zacess-games --version |
The version |
Keys every game shares
Most games read keys only. Termle types letters. Heatsink, Touch Typing and Learn to Code type every character, the space included, so a few shared keys move there.
| Key | Most games | Termle | Heatsink, Touch Typing and Learn to Code |
|---|---|---|---|
Space |
Pause and carry on | Pause and carry on | Types a space |
? |
How to play page | How to play page | Types ? |
F1 |
How to play page | How to play page | How to play page |
↑ ↓ |
Scroll the How to play page while it is open | The same | The same |
+ or = |
Effects volume up by 10 | The same | While paused only |
- or _ |
Effects volume down by 10 | The same | While paused only |
] |
Music volume up by 10 | The same | While paused only |
[ |
Music volume down by 10 | The same | While paused only |
} |
Background sound up by 10, turning it on | The same | While paused only |
{ |
Background sound down by 10, off at 0 | The same | While paused only |
0 |
Mute everything; again to bring it back | The same | While paused only |
Esc |
Back to the menu | Back to the menu | Pause, with the sound keys |
Q |
Back to the menu | Types Q |
Back to the menu while paused |
Ctrl+C |
Leave at once | Leave at once | Leave at once |
Enter |
Play again after a game ends | The same | The same |
While paused, any key that is not a sound key carries on. The right end of the status bar always shows the effects and music levels, such as FX 35% · Music 20% or FX muted · Music off. While the background sound is on it shows that level too, such as FX 35% · Music 20% · Background 25%. Every change is also written above the key lines as it happens.
The menu
| Key | Does |
|---|---|
↑ ↓ or K J |
Choose a game |
← → or H L |
Move between the two columns |
Enter |
Play the chosen game |
1 to 9 |
Play one of the first nine games at once |
? or F1 |
The chosen game's How to play page |
+ - [ ] 0 |
The sound, as in every game |
Q or Esc |
Leave |
Each game
| Game | Keys |
|---|---|
| Stackline | ← → (or H L) move. ↑ (or K or X) turns. ↓ (or J) moves one row down. Enter drops. Tab moves the piece to the other well |
| Merge Gates | Arrows (or H J K L) move the cursor. W A S D push the tile up, left, down or right. Enter grabs; then an arrow pushes |
| Termle | Letters type. Backspace deletes. Enter guesses. Tab reveals a letter for one try |
| Signal | ↑ or 1 plays the high lane. → or 2 the middle lane. ↓ or 3 the low lane |
| Trace | Arrows (or H J K L) lay wire. Tab or Enter moves the pen to the next lit point. U or Backspace undoes. R restarts |
| Drift | Arrows (or H J K L) steer. Enter ends the journey |
| Rooms | Arrows (or H J K L) walk. D drops a part |
| Relay | Arrows (or H J K L) move. W or Enter waits a move (so does the full stop). U or Backspace undoes. R restarts |
| Through Ball | Arrows (or H J K L) run with the ball. Tab picks a teammate. Enter passes. 1 2 3 shoot at the top, middle or low row |
| Slipstream | ← → (or H L) change lane. ↑ (or K) goes faster and ↓ (or J) slower |
| Array Guard | ← → (or H L or A D) move. ↑ or F or Enter fires |
| Heatsink | Every character types; letters match in either case. Backspace takes back a letter. Tab switches calm mode. Enter ends a calm round |
| Touch Typing | Every character types exactly. Backspace takes back a key. ← → choose an unlocked lesson. Enter moves on when a lesson is done. F2 switches the keyboard layout |
| Learn to Code | Every character types into the marked blank at the cursor ▏. ← → move the cursor, Home and End jump to the ends of the blank, Backspace deletes before the cursor and Delete after it. Tab or ↓ goes to the next blank and ↑ the one before. Enter checks, then moves on. PgUp and PgDn go to the previous level and the next level reached. F2 shows a hint. F3 shows the answer after three tries. F4 chooses a language. In the track list → opens the level list, where Enter opens any level reached and ← goes back |
Flags
| Flag | Does |
|---|---|
--theme <name> |
A Zacess theme by id, short name or full name, such as deep-dark |
--reduced-motion |
Slower falling, scrolling and rhythm, shorter pauses for clears |
--no-sound |
Start with effects and music muted |
--volume <0 to 100> |
The effects volume to start with |
--no-music |
Start with the music off |
--music-volume <0 to 100> |
The music volume to start with |
--background |
Start with the background sound on |
--no-background |
Start with the background sound off, whatever was remembered |
--background-volume <0 to 100> |
The background sound's volume to start with, 15 unless set |
--seed <number> |
A fixed seed, for the same game twice |
--colour <truecolour or 256> |
How colours reach the terminal |
--basic |
Plain characters for fonts without geometric shapes |
--layout <uk-mac or uk-pc or us> |
The keyboard layout Touch Typing teaches on, for this run |
--headless <game> --keys <keys> --size <W>x<H> |
Plays keys without a terminal and prints the screen as text. Keys are words split by commas: up, down, left, right, home, end, pgup, pgdn, enter, tab, space, bs, del, esc, f1, ctrlc, any single character and wait:<seconds> after a key |
snap --theme all --out <dir> |
Stills for every theme into a folder |
snap --frames <n> --fps <1 to 30> |
Frames of a recording at that rate, 10 a second unless set |
snap <game> --frames <n> --keys <keys> |
Frames of one game playing those keys instead of its recording |
snap --frames <n> --script <file> |
Frames from another recording script, in the format of scripts/recordings.txt |
Environment variables
| Variable | Does |
|---|---|
ZACESS_THEME |
The theme, under --theme and over the theme state file |
ZACESS_REDUCED_MOTION=1 |
Reduced motion, as the flag |
ZACESS_SOUND=0 |
Start muted, as --no-sound |
ZACESS_VOLUME |
The effects volume, 0 to 100 |
ZACESS_MUSIC_VOLUME |
The music volume, 0 to 100 |
ZACESS_AMBIENT=1 |
Start with the background sound on, as --background. Zacess Scenes reads the same variable |
ZACESS_KEYBOARD |
The keyboard layout: uk-mac, uk-pc or us |
ZACESS_GAMES_STATE |
Another folder for the records and settings |
ZACESS_GAMES_NO_USER_LEVELS=1 |
Ignore level files in ~/.config/zacess/games |
The system's reduced motion setting (Reduce Motion on macOS, animations off in GNOME or in Windows) turns reduced motion on as well.
Window sizes
Every game and the menu lay themselves out for the window they are in, chosen again on every resize without losing the game:
| Size | Layout |
|---|---|
| Below 60 by 20 | A centred message giving the size needed and the size now |
| From 60 by 20 (a quarter tmux window) | Compact: one status line, one key line, side panels left out where they would not fit (their facts move to the status line) and smaller boards |
| From 100 by 30 | Standard: a status bar, two key lines, the full side panels and pixel boards that grow to fill the room beside them |
| From 160 by 45 | Large: pixel boards drawn larger still with finer shapes, Merge Gates drawn at twice the size, a larger Touch Typing keyboard of taller keycaps with a progress panel and wider text in the typing and coding games |
Keyboard layouts
Touch Typing draws the keyboard and teaches the fingers for one of three layouts:
| Layout | Where | Differences |
|---|---|---|
uk-mac |
Apple British on a Mac | @ is Shift+2 and " is Shift+'. £ is Shift+3 and # is Option+3. § and ± sit left of 1; the backtick and ~ sit left of Z |
uk-pc |
UK keyboards on Windows and Linux | " is Shift+2 and @ is Shift+'. £ is Shift+3. # and ~ sit left of Enter; the backslash and the pipe sit left of Z; the backtick and ¬ sit left of 1 |
us |
US ANSI keyboards | @ is Shift+2, # is Shift+3 and " is Shift+' |
The layout comes from the --layout flag, then ZACESS_KEYBOARD, then the one chosen last time with F2, then the system: on macOS the current input source (com.apple.keylayout.British gives uk-mac), on Windows the first layout in HKCU\Keyboard Layout\Preload (00000809 gives uk-pc) and on Linux XKB_DEFAULT_LAYOUT, localectl status or setxkbmap -query (gb gives uk-pc). When none of these answers, it is uk-mac on a Mac and uk-pc elsewhere, never US. The lesson screen names the layout in use.
The theme
The games are drawn in a Zacess theme picked in this order: --theme, then ZACESS_THEME, then the theme state file $XDG_STATE_HOME/zacess/theme or ~/.local/state/zacess/theme, then Zacess Deep Contrast Dark. The state file is the one Zacess Scenes reads, so any tool that writes it switches the games and the scenes together. The ten themes are Light, Dark, Yellow on Black, Cream, High Contrast Dark, High Contrast Light, Deep Contrast Dark, Deep Contrast Light, Warm Dark and Warm Light, each with a short name such as hc-light or warm-dark. It holds a theme id such as deep-contrast-dark. It can instead hold auto followed by a dark and a light id, to follow the system's dark mode. On Windows the file is under the user folder, %USERPROFILE%\.local\state\zacess\theme.
Settings and records
The effects, music and background sound levels and whether each is on are remembered between runs. So are the best scores, the Termle streak, the Touch Typing lessons unlocked and keyboard layout and the Learn to Code progress for each language. They live in ~/.local/state/zacess-games/scores.txt ($XDG_STATE_HOME/zacess-games when that is set and %LOCALAPPDATA%\zacess-games on Windows), one key value pair a line. Every key is listed in the scores file. A flag or variable wins over a remembered setting for that run.
Sound and music files are made once and kept in ~/Library/Caches/zacess-games on macOS, ~/.cache/zacess-games on Linux and %LOCALAPPDATA%\zacess-games on Windows. They are safe to delete; they are made again when needed.
Level files
Trace, Relay and Learn to Code read their levels from Lua files. Extra files go in ~/.config/zacess/games/trace, ~/.config/zacess/games/relay or ~/.config/zacess/games/learn-to-code (%APPDATA%\zacess\games on Windows) and play after the built-in ones. The format is described at the top of each built-in file in levels/.