Skip to content

History and Restore

Every campaign, map and character keeps its history: each change you make is recorded — what changed, who changed it, when — and any earlier state can be brought back. Nothing is ever lost by restoring: the state you were in stays in the history too.

Where to find it

The History button is the same icon everywhere — a circling arrow (its tooltip says History: see and restore previous states):

  • A character — in the sheet header, left of Share, on the character's page; on the sheet in /play, old and new, at the top of the panel, or under its … when the panel is too narrow; and in Mini-Me's … menu.
  • A campaign — on the campaign's Edit page, the History button left of Done; and in the Edit Campaign sidebar in /play, upper right beside Share.
  • A map — in the map palette, right of Undo and Redo.
  • A token — at the top of the Impersonated Token panel, in Mini-Me's … menu, and in the token's settings drawer. A token linked to a character opens the character's history. Any other token has no history of its own: moving, renaming or deleting it is a change to its map, so these open the map's history.

What you see

The list is newest first. Each line is one change: what it was in a few words ("2 tokens moved", "name, 1 drawing added"), who made it, and when.

  • current marks the state the entity is in now.
  • A purple timeline badge means the change is not on the main timeline (see Timelines).
  • Older changes at the bottom loads more.

Anyone who can read the entity can read its history. Blame shows usernames, never emails.

Seeing what changed

Click a change to see the difference between it and the current state. Click a second one to compare the two. The differences are grouped the way the entity is — a character's by its sheet sections, a map's by layers, tokens, drawings and so on — and each is shown as before and after, with the unchanged parts folded into a count. A token that only moved is shown as a move, not as two numbers.

Who changed this?

On a character sheet, hover a section's title (or long-press it on a phone) to see who last changed that section, when, and what the change was. In a token's settings drawer, every field's label answers the same question.

Restoring

With one change selected, Restore this version puts the entity back to that state. You need Edit on the entity to restore it. The confirm shows exactly what the restore will change before you agree.

A restore is recorded as a change of its own, by you, so it can itself be undone — and it starts a new timeline (below), so the states after the one you restored to are still there.

The map's Undo and Redo

⌘Z / Ctrl+Z on a map is a restore of its previous change, and Redo of the next. They survive a reload, they work for every kind of map edit, and they are the same for everyone looking at the map. As in git, once you make a new edit after undoing, there is nothing left to redo — the undone state is still in the history, and you can select it and restore it there.

What a restore includes — and what it does not

A restore covers the entity and everything it contains:

  • A map: its own properties (name, grid, texture), its layers, its tokens' positions, sizes and other token properties, drawings, walls, fog and objects.
  • A character: the whole sheet, its equipment, its relationships and who has access to it.
  • A campaign: its settings, its members and their roles, and all its reference data — conditions, actions, bars, roll tables and the rest.

It does not cover linked entities. The map/token example: a map contains tokens, and a token may be linked to a character. Restoring the map puts the token back where it was — its position, its size, its name — but does not touch the character behind it: not its Strength, its conditions, or its current hit points. (An unlinked token carries those on itself, so for it they are restored with the map.)

Cascade — restoring linked entities too

When you restore, the confirm lists any linked entities that have also changed since that time — for a map, the characters its tokens are linked to; for a campaign, its maps and characters — each with a summary of what going back would change and a checkbox. They are unchecked by default. Tick one to restore it too, to the state it was in at that moment; each one is restored exactly as if you had restored it on its own, and each is a change in its own history. You need Edit on each one you tick.

Timelines

Restoring does not delete the history that came after the restored state. Instead the entity moves onto a new timeline, starting from the state you restored; the old timeline keeps everything that was on it. A change that is not on the main timeline wears its timeline's name as a badge, and the switcher above the list shows every timeline with where it ends, lets you look at one at a time, and lets an editor rename one ("Before the fight"). There is no merging: a timeline is a place you restored to, not a branch to reconcile.

Named versions of a character

A character's panel has a Versions section at the top. Tag this version gives the current state a name — "Level 5", "Before the fight" — so you can find it later; click a name to select its change, and Restore puts the character back to it. The × removes the name only; the history stays.

Deleted things

Deleting a campaign, map or character is itself a change in its history, so the deleted-items page shows who deleted each one and opens its history; Restore there brings it back, recorded as a change too. Deleted things are kept for 30 days.