Skip to content

Checkpoints and Versions

The editor keeps earlier states of a Project in two ways.

WhatWhat it isWho makes it
CheckpointThe Project as it was before a RunThe editor, before every Run
VersionThe Project as it was at a moment a Member gave a nameYou, with Name this version or Name…

A Checkpoint is made before every Run, every few minutes while Members change things, and when the Project stops. It holds the scenes, prefabs, scripts, and assets, and the Gamedoc. A published game is built from the last one: see Working together.

Name the Project as it is now at a moment worth marking: before a large change, or when something works.

  1. Click Name this version, under the text field of the Agent panel.
  2. Type a name and press Enter. Escape leaves without naming.

The Agent panel shows “Named this version”, with the name and who named it.

The History tab, beside the Agent panel, lists the Project’s Checkpoints, the latest first. Runs, Versions, and restores are rows. The automatic saves between them are folded into one row, “N automatic saves”, which opens when you click it.

  • Show automatic saves lists every save.
  • Named only lists only the rows with a name.
  • “You are here” marks the Project as it is.

Click a row to open it. It says what the row is, who made it and when, and If you restore it: each file that would change, grouped as Scenes, Scripts, Assets, Gamedoc, and Other, and whether it would be removed, added, or changed.

  1. Open the row and click Restore this….
  2. The dialog says who else is here, and whether the Agent is working: a restore asked during a Run is done when the Run ends.
  3. Optionally, give a name to what you leave, to find it again.
  4. Click Restore for everyone.

A restore is everyone’s: the Project has one folder. Every open page shows a line under the toolbar, such as “Ana restored “Before the boss”. What was there is kept as “Boss attempt”.”, with two buttons:

  • Show opens what was left in the History tab.
  • Take me back restores what was left, for everyone.

Open pages forget their undo history when a restore ends, because undoing would put old work back. Nothing is lost: what you left stays in the History tab, where the tree draws it as a line of its own that ends in a Tip.

Open any row and click Name… to give it a name. A name that is taken gets “-2” (or “-3”, and so on), and the first keeps its place.

When you ask the Agent, it can list the history, say what a restore would change, name a row, and restore one. It restores only when asked, and says how to get back. Its next Run is told what a restore took back. A Run that begins anew remembers none of it.

Your own agent, connected to the editor over MCP, has the same tools.

Checkpoints and Versions are commits in the Project’s own git repository, so they are there when the Project has been stopped and started again.