(go-to: "The Distant Future")
There are plenty of occasions where you may want to instantly advance to a new passage without the player's volition. (go-to:) provides access to this ability.
(go-to:) can accept any expression which evaluates to
a string. You can, for instance, go to a randomly selected passage by combining it with
(go-to: (either: "Win", "Lose", "Draw")).
(go-to:) can be combined with (link:) to accomplish the same thing as (link-goto:):
(link:"Enter the hole")[(go-to:"Falling")] However, you
can include other macros inside the hook to run before the (go-to:), such as (set:),
(put:) or (save-game:).
If it is performed, (go-to:) will “halt” the passage and prevent any macros and text after it from running. So, a passage that contains:
(set: $listen to "I love") (go-to: "Train") (set: $listen to it + " you")
will not cause
$listen to become
"I love you" when it runs.
Going to a passage using this macro will count as a new “turn” in the game's passage history, much as if a passage link was clicked. If you want to go back to the previous passage, forgetting the current turn, then you may use (undo:).