05 Flows and stages

How a macro is put together

Three things, one inside the next. Start from the one you already know.

  1. A flow is a chain of steps

    The rail you built in Your first macro: wait, press, wait, press. It runs on its own, and when it reaches the end it starts again from the top — unless the macro runs Once, in which case reaching the end is the macro stopping.

  2. A stage is flows running at the same time

    Add a second flow beside the first and both run at once, each on its own chain. Every macro has at least one stage; your first one had one stage with one flow in it.

  3. A macro is stages in order

    A stage runs until its exit condition passes, then the next one starts. One stage is enough for most macros. More are for a macro that changes what it is doing — one rotation with the bow, another with the sword, and back.

Four frames of the editor: the flow's lane spotlit, then the flow tabs, then the stage band, then the run-mode button in the header
Where each one lives. The lane is a flow; the tabs above it are the stage's flows; the band at the top is the macro's stages; the square button in the header is the run mode, which decides which of the three the editor shows. A Stages macro with one flow has no tabs — + Parallel flow sits in the lane's header instead.

How a macro runs

Every macro has a run mode: Once, Loop, Parallel flows or Stages. A new macro asks for it before anything else, and the square button left of the trigger shows it and changes it. The mode decides what a flow does when it reaches its last step, and how much of the macro the editor shows.

Once

One flow, run to the end once; then the macro stops. Pressing the trigger runs it again from the top. There is no exit condition to set — reaching the end is the stop — and a Stop macro step ends it earlier. A recording turned into a new macro on the Tracker page is Once.

YOU PRESS IT SENDS wait for E E E Press 1 1 1 wait for E E E Press 2 2 2 MACRO STOPS

Loop

One flow that goes back to its first step each time it reaches the last, until you press the trigger again. Your first macro is a Loop.

YOU PRESS IT SENDS wait for E E E Press 1 1 1 wait for E E E Press 2 2 2

The exit condition sits in the editor's header. Left empty, the loop runs until you stop it; set — a time, an object appearing — and the macro stops the moment it passes.

Parallel flows

One stage of several flows, all running at once, each on its own chain and each starting over on its own. You do not need a loop to “do two things at once”: one flow shoots, another watches a bar, a third types a command every minute. + Parallel flow adds one, and the flow tabs above the lane switch between them.

FLOW · Shoot wait 1 s Press 1 both lanes are live at once — neither one waits for the other FLOW · Two skills on cooldown Press Q cooldown 4 s Press E cooldown 4 s

A wait in one flow does not hold the others, and each repeats on its own schedule. The flow tabs say how many are live. As in Loop, the exit condition is in the header.

Stages

Most macros need more than one mode. One rotation while the bow is out, another once you switch to the sword. That is what stages are for: each one holds its own flows — one or several, running in parallel — and each one carries the condition that moves on and the stage it moves on to. The flows of a stage keep starting over until it hands on.

STAGE 01 Ranged Press 1 wait 1.2 s Press Q cooldown Press E two flows, both looping EXIT CONDITION Sword appears STAGE 02 Melee Press 2 Press 3 a different set of keys Bow appears

The stage band across the top holds the chain, even with one stage, and + Add stage at its end appends one. Click a stage to edit its flows, double-click it for its name and exit condition, drag it to reorder, and the + between two stages inserts one there.

Leaving a stage

When a stage's exit condition passes, its flows stop and the next stage's start. The condition is picked from the same signals a wait uses — Timing, Object on screen, Color in area, Key pressed, Sound heard — plus one of its own, Stage done: a flow of this stage has finished, the number of times you set. It comes first in the list, and a stage with one flow has it picked already. Leave the row empty and the stage is the end of the line — the macro stays there until you stop it.

A flow can also leave from inside. A Next stage step does what the exit condition would, the moment the flow reaches it, and Stop macro ends the run — both on the Break, reset, stop page.

The stage band: Ranged, exiting when the sword appears, then Melee, exiting when the sword is gone, + Add stage, and a return arc back to Ranged
The stage band. The chip on a stage is its exit condition — here, whether the sword shows as equipped; the arrow is where it goes next. The box at the end is what runs after the selected stage: Melee goes back to Ranged, so the macro swaps rotations with the weapon for as long as it runs.

The box after the last stage says what happens then: Exit the macro, or Go to a stage — which is how a macro cycles, ranged → melee → ranged, for as long as it runs.

Changing the mode

The square button left of the trigger reopens the choice; 1–4 pick a card from the keyboard. Moving to a simpler mode keeps the selected stage, and for Once and Loop the selected flow. If that would delete anything, the app names each stage and flow it would delete and asks first. The new mode is saved with the next Save, like any other edit. A macro made before run modes existed, or imported without one, opens as Stages.

Watching a run

On the macro list, the row's ⋯ menu → Statistics lays the last run over the macro's own rail: how many times each stage was entered and for how long, where every flow is right now, and for each step how often it ran, how it ended and how long it took. The amber frame is the step in flight; click any step for its own panel. Pause holds the figures still while you read them. The run is kept in memory, so it lasts until the app is restarted.

The statistics page: the stage band and flow tabs with their counts, the rail with a count and an average on every step and an amber Now frame around the one running, and a panel of that step's recent runs
The last run, live. The stage band and the flow tabs carry their counts, the rail carries each step's, and the panel on the right belongs to whichever step is picked — here a timing step, with its last four runs.