Skip to Content
GameGenTime travelFork from here

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

FieldMeaning
holdHow many ticks the change covers. The tutorial starts at 1: one tick changed. Raise it to override more ticks.
delayHow many ticks to wait before the change.
horizonHow 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

  • flap at frame F flaps on tick F+1, and does not flap for the rest of the hold.
  • wait does 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.

ButtonWhat it does
Open branch in ReviewOpens the child run with its own recording.
Open in Search treeShows 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

PathContents
Saved/Lou/runs/fork-<run>/The child runs of the forked run.
Saved/Lou/datasets/fork-<run>/branches.jsonlOne 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.

KeyAction
← →Move the note by one tick.
Shift ←, Shift →Move the note by six ticks.
EnterRun the fork.
EscClose the form.

Next steps

Last updated on