Build vision-aware controller scripts with confidence.

What an Atlas script does

An Atlas script connects video analysis and controller input to small, explicit output changes. Video work belongs in on_frame. Controller reads and output changes belong in on_input. Atlas preserves normal controller passthrough unless your script overrides a value. A script can also capture network packets and inspect, edit, or drop them in network events.

Your first complete script

This example records whether a color detector found a marker during the latest video frame, then mirrors that state to an output button when controller input arrives.

color markerColor = vision.color([0, 90, 80], [15, 255, 255]);
bool markerVisible = false;

event on_frame() {
    markerVisible = markerColor.target != null;
}

event on_input() {
    if (markerVisible) {
        output.set_button("cross", true);
    }
}

event on_stop() {
    ui.clear();
}

Execution model

1. Load: Atlas parses, validates, compiles, and initializes global declarations.
2. Start: on_start runs once.
3. Connect: on_connect runs once immediately after on_start for the active controller family; it is not redispatched when the family changes.
4. Process: on_frame receives video work and on_input receives controller work. After network.capture(filter) starts capture, on_network_recv and on_network_send receive each matching packet.
5. Stop: on_stop runs before Atlas clears controller output, feedback, and overlays and ends network capture. Global values remain allocated until the script is reloaded.

Where to go next

Core rules worth remembering

• Use var for general numeric values; removed spellings such as int, float, and double are rejected.
• Use qualified control-name constants such as ps5.cross, or pass a quoted name such as "cross". Use controller.ps5 only as a controller-family value.
• Controller APIs belong in on_input. Video and overlay APIs belong in on_frame.
• Typed struct parameters are deep-copied by default. A StructName &value parameter shares member and nested-array mutations, but assigning a new struct only rebinds the callee's local parameter; see Functions and references.
• A reference alias such as var ref = &values[0]; writes through to its original variable, field, or array element.
• packet belongs directly in on_network_recv or on_network_send. Network capture is optional and needs WinDivert, which you install yourself, and administrator approval once per Run; see Network events.
• Use on_stop for overlay and non-controller cleanup. Release controller output or feedback during on_input; Atlas performs a final controller clear after on_stop.