Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/BunnyNabbit/voxel-telephone/llms.txt

Use this file to discover all available pages before exploring further.

Every action you take while building is stored as an entry in a running log. The VCR system lets you navigate that log — stepping backward to undo changes or forward to redo them — without permanently altering your build until you decide to commit. Think of it like rewinding and fast-forwarding a cassette tape of everything you have built.
The VCR system stores commands as a log of operations, not as snapshots of the full block map. Each “action” in the log corresponds to one building command you executed.

​
VCR workflow

1

Enter VCR mode with /vcr

Type /vcr to enter VCR mode. The server reports how many actions are recorded in the current session and shows the VCR help text. The level reloads to reflect the current action count.
/vcr
While VCR mode is active, a blinking indicator appears on your HUD and normal block editing is suspended.
2

Step backward with /rewind

Rewind one or more actions to move to an earlier state.
/rewind [n]
/undo [n]
Aliases: /rw, /undoIf n is omitted, exactly one action is rewound. The server confirms the current action position after each rewind. The level reloads to show you the build as it was at that point in history.
/rewind 3
Moves back 3 actions.
3

Step forward with /fastforward

Fast-forward one or more actions to move to a later state, up to the most recent action.
/fastforward [n]
/ff [n]
/redo [n]
Aliases: /ff, /redoIf n is omitted, exactly one action is restored. The server shows your current position and the total number of available actions.
/ff 3
Moves forward 3 actions.
4

Commit the current state or exit safely

Once you have found the state you want to keep, commit it or exit without saving.To keep the current state:
/commit
This saves the state currently shown in the VCR preview as the new head of your build history, exits VCR mode, and allows editing to resume. Any actions that were rewound past are permanently discarded — they cannot be restored after committing.To exit without changing anything:
/abort
This restores the level to exactly the state it was in before you typed /vcr and exits VCR mode. Nothing is committed and nothing is lost.

​
Command reference

​
/vcr

Enters VCR mode and displays the total action count for the current level. 
/vcr
You cannot enter VCR mode while it is already active or while the level is still loading.

​
/rewind

/rewind [n]
ParameterDefaultDescription
n1Number of actions to step backward.

​
/fastforward

/fastforward [n]
ParameterDefaultDescription
n1Number of actions to step forward.
Fast-forwarding past the most recent recorded action is not possible — the counter stops at the maximum.

​
/commit

/commit
Sets the current VCR position as the permanent new state of the level. Exits VCR mode and re-enables building. Only usable while VCR mode is active.
After you commit, any actions that were rewound past are gone. There is no way to recover them. If you are unsure, use /abort to exit safely first.

​
/abort (in VCR mode)

/abort
Exits VCR mode and restores the level to the state it was in the moment you typed /vcr. No commit takes place. Use this to safely inspect history without keeping any changes.

​
The VHS save format

Voxel Telephone saves build history in a format internally called VHS. Rather than storing full block-map snapshots, it records the sequence of commands executed, along with keyframes that cache intermediate states. When a level is restored — for example when you /rewind — the engine replays commands from the nearest keyframe forward to reach the requested position. This design keeps save files compact even for long build sessions.

Build docs developers (and LLMs) love

Get started for freeTalk to us