diff --git a/docs/agents/running.md b/docs/agents/running.md index a927be69..09d61fd9 100644 --- a/docs/agents/running.md +++ b/docs/agents/running.md @@ -27,8 +27,10 @@ results without flooding its context. Setting names and file formats live in [se - `--seconds` is game time since the world loaded (the log line `frame step: world clock starts` marks the start), at any frame rate. Measure and script by game time; a frame count at another fps is another scene. -- `--script` replays input ([controls.md](../controls.md), "Scripted input"). A new script starts with the presses of - `tools/input/load_save.txt`, which load the first save from the title. `TOTK_INPUT_RECORD` turns a person's play into +- `--script` replays input ([controls.md](../controls.md), "Scripted input"). A new script starts with every line of + `tools/input/load_save.txt`, which loads the first save from the title: A every 2.5 s until the load ends, because a + slow boot eats presses and a run left on a title dialog shows nothing. Its timed line stops those presses when the + world clock starts; a script without a timed line would carry them into the world. `TOTK_INPUT_RECORD` turns a person's play into a script; ask the user to record the repro rather than guessing the button sequence. - `--shot` saves the last frame and builds pipelines synchronously: use it for pictures, never for timing. - `--quiet` waits until no other `totk.exe` or `ninja.exe` runs. Every timing you report comes from a `--quiet` run. diff --git a/tools/input/load_save.txt b/tools/input/load_save.txt index d8e532ad..01020177 100644 --- a/tools/input/load_save.txt +++ b/tools/input/load_save.txt @@ -1,5 +1,28 @@ -# Title screen to gameplay (first save slot). +# Title screen to gameplay (first save slot). A slow boot eats presses (a menu that is not up yet drops them), so A +# goes on every 2.5 s of game time from 5 s to 60 s until the save loads. The timed line at the end makes this a +# script with timed lines: its untimed presses stop when the world clock starts (runtime/input.c script_mixed), so +# none reaches the world. A script built on this one copies every line, the timed one too. 300 A 4 -520 A 4 -700 A 4 +450 A 4 +600 A 4 +750 A 4 900 A 4 +1050 A 4 +1200 A 4 +1350 A 4 +1500 A 4 +1650 A 4 +1800 A 4 +1950 A 4 +2100 A 4 +2250 A 4 +2400 A 4 +2550 A 4 +2700 A 4 +2850 A 4 +3000 A 4 +3150 A 4 +3300 A 4 +3450 A 4 +3600 A 4 +@1 RSTICK 0 0 1