Fork from here
Fork from here answers “what if I had flapped here?” You pick a tick, choose the other input, and GameGen replays the run from tick 0 with that one change. The result is a new run, called a branch, that you can open, compare and fork again.
Before you start
- Open a run in Review and step to the tick you want. See Review and step.
- Build the project. A fork needs a built project, Node, Bun or Deno, and an engine.
Fork a run
Go to the tick
Step with [ and ] to the frame where you want a different input.
Open the form
Choose Fork from here, or press Shift X.
Choose the input
The form offers the input that was not recorded at that tick: flap or wait.
Set the span
| Field | Meaning |
|---|---|
| hold | How many ticks the change covers. The tutorial starts at 1: one tick changed. Raise it to override more ticks. |
| delay | How many ticks to wait before the change. |
| horizon | How many ticks the branch may run after the hold. There are 60 ticks in a second. |
Run
Choose Run, or press Enter. The button reads Forking… while the replay runs.
A fork takes about as long as starting an editor without a window: around a quarter of a minute on an idle machine, and minutes while another Unreal build or editor is busy.
What the inputs mean
flapat frame F flaps on tick F+1, and does not flap for the rest of the hold.waitdoes not flap for the whole hold.- Before and after that span, the run’s own recorded inputs play on. No model plays this game.
- The branch ends at GameOver, or when the horizon runs out.
Read the result
When the fork ends, the form says how it ended, for example “the bird died; the branch ran 61 ticks”. The strip under the viewer keeps one row for each fork made from that frame.
| Button | What it does |
|---|---|
| Open branch in Review | Opens the child run with its own recording. |
| Open in Search tree | Shows all the forks of the run as a tree, with their scores. |
In the runs list, a child run reads “fork at”, the frame, and the action.
Where branches are saved
| Path | Contents |
|---|---|
Saved/Lou/runs/fork-<run>/ | The child runs of the forked run. |
Saved/Lou/datasets/fork-<run>/branches.jsonl | One row for each fork made in the Lou view. |
A fork never overwrites a run.
Adjust the fork with the keyboard
While the form is open, the strip under the viewer shows the change as a note.
| Key | Action |
|---|---|
| ← → | Move the note by one tick. |
| Shift ←, Shift → | Move the note by six ticks. |
| Enter | Run the fork. |
| Esc | Close the form. |