Guides

Pick the result you want, then follow the path. You do not need to read the guides in filename order. The foundations build on one another; the project and creative guides tell you their prerequisites.

Make a first flight program

Read live telemetryRead coherent vessel state from /sim or HTTP.

Throttle and igniteSend a safe first control and verify its read-back.

Understand reference framesLearn the CCI and body axes used by flight controls.

Build the gatos-io helpersReuse the transport and frame helpers used by later programs.

Automate flight

Point at a parent bodyCompute and command a Body-to-CCI attitude quaternion.

Wait in simulation timePace control loops by snapshots, events, and UT instead of sleeps.

Coordinate commandsLand related controls on one game tick.

Run a timed sequenceAuthor launch cues and mission events on render, wall, or UT clocks.

Use RCSTranslate and rotate in the vessel body frame.

Build closed-loop guidanceCombine coherent reads, gating, pointing, and actuation.

Connect other software

Build an HTTP dashboardUse the host-side /v1 mirror.

Stream with MQTTSubscribe to paced telemetry and send commands.

Connect over serialUse the line-oriented command and telemetry bus.

Mount a host folderShare scripts and artifacts at /mnt/name.

Connect an AI agentUse the logical JSON MCP interface and its operating playbooks.

Direct, paint, and experiment

Direct a camera shotTake camera ownership, place it, aim it, and hand it back.

Build a soundboardUpload clips and control game audio channels.

Edit engine plumesLearn the scope and reset model shared by the live FX editors.

Open the debug sandboxTeleport, impulse, refill, and manipulate the game deliberately.

Weld vesselsCreate session-scoped rigid attachments between live vessels.

Float cabin objectsOpt in to gatOS-owned IVA cabin physics.

For complete programs rather than lessons, browse the example projects.