GET /events

Since 0.6

Request

Parameter	Shape	Meaning
`since`	integer	only events with `frame >= since`. Default 0.
`after_seq`	integer	only events with `seq > after_seq`. The precise polling cursor.
`filter`	string	match `type` or the custom/trigger event name. Comma-separated for alternatives: `filter=trigger,door-opened`.
`entity`	string	only events naming this entity id
`limit`	integer	at most this many, keeping the most recent

One frame-stamped thing that happened.

Field	Type	Present	Description
`seq`	`integer`	always	Monotonic per-process sequence number. Strictly increasing, no gaps.
`frame`	`integer`	always	The frame the event fired on.
`time`	`number`	always	Simulated seconds since the scene loaded.
`kind`	`EventKind`	always	What happened.

The payload of an EventRecord, tagged by type on the wire.

Value	Meaning
`collision`	Two colliders started or stopped touching. Mirrors `argus_host::GameEvent::Collision`.
`trigger`	A sensor volume was entered or left. Mirrors `argus_host::GameEvent::Trigger`.
`custom`	`ctx.events.emit(name, data)` from a behavior, or `ctx.events.emitTo(to, name, data)`.
`script_error`	A behavior threw, ran away or blew its per-tick budget and was disabled — or, with `disabled` false, keeps running: it threw a stale handle (`entity-despawned`) from a per-tick hook, or its `update` stayed over its wall-clock budget (phase `budget`) under the host's default `OverrunPolicy::Warn`.
`script_warning`	A behavior did something the engine let pass but its author almost certainly did not mean. The behavior keeps running; nothing is disabled.
`ui`	The game UI's stack, focus or an activation changed.
`log`	`ctx.log(...)` from a behavior.

curl "http://127.0.0.1:7700/events"

Start a server with argus run --serve; the port is --port (7700 by default). The request and response fields are in the query API guide.