Replays

Replays are a new feature in version 1.09. Until 1.09 is released, the feature won't work for you.

A replay is a full game recording of an entire game, from the moment it began (or you joined). Replay recording must be started BEFORE you join a game, and are automatically saved if you stop or end the level.

Replays weigh in at various sizes but can be several megabytes for a full 16 player game, so use the feature with care.

Recording new replays

Before joining a game, type "RECORD" in the console (press the TILDE button ~ to get to the console). A name for the recording will be automatically generated. The replay will automatically record everything that happens after the next map change or game join, but nothing until then. You can also alter yur config file (hostoptions.txt in your hyperbol data folder) to turn on a feature that automatically records everything.

Stopping recording

Type "stop" in the console, or end a level, or quit from the server. The recording will be saved in the background. Note that quitting via ALT-F4 or typing 'QUIT' in console will not save your replay (it will be lost). Wait for the popup box that indicates save progress to finish before quitting. When a recording stops, the console will note the name of the new recording.

Playing back a saved recording

Type "play <recording name>" in the console. For example: PLAY REC001

You don't need to supply an extension, only the file name.

The recording UI will appear during records

From left to right, the buttons you see are:

• Rewind to start
• Rewind a few seconds
• Pause / Play toggle
• Slow motion toggle
• Fast Forward toggle
• Remember the current position in file
• Go back to the remembered position

During playback you can use the camera bookmarks buttons (ctrl+F1, ctrl+f2, ctrl+F3 and f1, f2, f3) as well as shift F1, F2, F3 etc, to make cinematic shots.

The time indicated after the navigation buttons is the current frame (100 frames a second) out of the total number of frames in the recording, followed by the percentage of the same, followed by the time in minutes and seconds. If you have bookmarked a particular frame, it will appear above the recall button.

Recording files

Each time you make a recording, it is automatically saved into folder called "recordings", inside your hyperbol data folder. This is usualy wherever you installed steam, in a subfolder called steamapps/common/tshb/data/recordings. You can freely trade these recording files with other players. If they put the recording into their folder, they'll be able to play it and see what happened.

What is recorded

Everything except voice and text chat, currently, with plans to support more

Version change warning

Recordings are probably not going to be compatible across version change.