whatisgithub

What is time-travel-foundry?

mattpritchard4/time-travel-foundry — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

A Foundry VTT module that lets the Game Master rewind an active combat encounter to an earlier checkpoint.

Mindmap

mindmap
  root((Foundry Time Travel))
    What it does
      Rewind combat
      Save checkpoints
      GM timeline panel
    Tech stack
      TypeScript
      Foundry VTT
    Use cases
      Redo bad fights
      Review checkpoints
      Restore state
    Scope
      GM only
      Combat only
      v13 plus

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Rewind a combat encounter that went badly and replay it differently.

USE CASE 2

Review a timeline of recorded checkpoints during a fight.

USE CASE 3

Restore token positions, stats, and effects to an earlier point in combat.

USE CASE 4

Give the GM a safety net for undoing mistakes mid-battle.

What is it built with?

TypeScriptFoundry VTT

How does it compare?

mattpritchard4/time-travel-foundry0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Foundry VTT version 13 or newer.

The README does not state a license.

So what is it?

Foundry Time Travel is a module for Foundry VTT, a popular virtual tabletop application used to run roleplaying games online. The module gives the Game Master (GM), the person running the game, a way to rewind an active combat encounter to an earlier saved checkpoint. If a battle goes badly, or the GM wants to replay a moment differently, they can step back in time to a recorded state and continue play from there. While combat is running, the module continuously captures checkpoints. Each checkpoint tracks a range of encounter data: turn changes, token movement on the map, which characters are participating in the fight, updates to character stats, item changes, active effects, and chat messages tied to the combatants. The GM can open a timeline panel to inspect all recorded checkpoints, choose one to review, and restore it to resume play from that point. The module is designed for Foundry VTT version 13 and newer. The scope in this first release is intentionally narrow: it covers only GM-facing controls, only active combat encounters, and only core Foundry document types. It does not promise perfect rollback in all situations, macro side effects may not be reversible, other installed modules may change state outside what is tracked, and world state outside the active combat encounter is out of scope. Custom game system support is planned for a later release. Installation uses a manifest URL pasted into Foundry's built-in module installer. The codebase is TypeScript, and the test suite enforces 100% code coverage.

Copy-paste prompts

Prompt 1
Explain what data each combat checkpoint captures in this module.
Prompt 2
Help me install this module using its manifest URL in Foundry.
Prompt 3
Walk me through what is out of scope for this module's rollback feature.
Prompt 4
Show me how the timeline panel lets the GM pick a checkpoint to restore.

Frequently asked questions

What is time-travel-foundry?

A Foundry VTT module that lets the Game Master rewind an active combat encounter to an earlier checkpoint.

What language is time-travel-foundry written in?

Mainly TypeScript. The stack also includes TypeScript, Foundry VTT.

What license does time-travel-foundry use?

The README does not state a license.

How hard is time-travel-foundry to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is time-travel-foundry for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.