Craft

Versions and the trash

Craft keeps history at three levels: each file, each file type and the whole world. Deleted files, folders and types go to the trash first.

File versions

Every save of a file is a new version, whoever made it: you in the editor, Orbit, a CLI push or, in a game, the GM. You find them in the file's Version History, at the top right of the editor.

  • Each version shows when it was saved (or the name you gave it) and who saved it. The one in use is marked current.
  • To get one back, open its Version History, open the version's menu and pick Restore this version (or click the version to preview it, then Restore).
  • Restoring makes that version current again. The newer versions stay in the history, so you can go forward again.
  • Restoring one file changes nothing else: files that link to it, or that it links to, stay as they are.

Named versions

You can name a version ("Before the rewrite") from its menu in the version history. A named version is never thinned away, however old it gets. Name the version before a big change you might want to undo.

How long versions are kept

Older history thins out over time, so recent work keeps every save and old work keeps one version per day or week:

Age of a version Files keep File types keep
Newer than 48 hours every version every version
48 hours to 7 days the newest of each hour every version
7 days to 90 days the newest of each day the newest of each day
Older than 90 days the newest of each week the newest of each week

A file always keeps its current version, its first version and every version you named. A file type always keeps its current and first versions and its newest 5, however old.

File type versions

Every change to a file type saves a version of the whole type: its name, schema, layout, creation flow and settings together.

  • Restoring a type's version brings all of those back at once. There is no restoring just its layout or schema.
  • It changes no file. Files keep the fields they had, so a field the old schema doesn't know stays in the files until you remove it.
  • The current version can't be deleted. Older entries can be.

To restore a type, open the type's Version History tab and restore the version you want.

Versions in a game

A game's files are its own copies, so the GM's changes during play are versions of the game's files, never the world's. When messages are deleted from a point in the story, the GM's file changes from those turns are undone with them: files it made go to the trash, and files it changed go back to the version before. A file changed again since (by a later turn that was kept, or by hand) is left as it is.

World versions

A world version is a snapshot of the whole world: every file, folder and type, and the world's settings. Games start from one, and publishing shares one. Restoring a world version replaces the whole working world, so anything not saved in a version is lost. See releases.

The trash

Deleting a file, folder or file type moves it to the trash. A folder takes everything in it along.

  • The trash lists each item, where it was and when it was deleted.
  • Delete forever, and emptying the trash, can't be undone.
  • Craft never empties the trash on a timer. Files in it don't count toward the world's file limit.

To get something back, open Trash at the bottom of the workspace's left rail and click Restore (select several to restore them together), or ask Orbit to restore it. It comes back where it was.