Glossary

Agent

A local automated client authenticated as source AGENT. It takes state in over the WebSocket and pushes plans out over HTTP.

Server state

The current state the server sent you. Remembered terrain, planned routes, predictions, and UI animation all belong to your client, and any of them can be out of date.

Champion Beacon

The one indestructible global objective. Its coordinate is public at all times, and a carrier you can see grants shield-cap and Worker-harvest bonuses.

Command gate

The server boundary that accepts correctly received plans, and only during the window that is currently OPEN.

Complete plan

The full action map one source wants for one Tick. A later POST replaces an earlier plan from that source rather than patching it.

Controlled

controlled: true marks an object as belonging to whoever is receiving the state. controlled: false marks a currently visible enemy.

Core

Your base: resource store, shielded primary life object, Unit producer, and — very slowly — a mobile entity.

Dynamic validation

The checks that only global resolution can make, such as occupancy, resources, target position, and line of fire. Failures come back in the next state.

Exploration memory

What your client remembers from older states. The terrain part stays correct; anything you remember about entities may be stale.

Manual

The web player's source slot. Per object, an explicit Manual action beats the Agent action, and leaving an object out falls back to the Agent.

Occupying entity

A Core or Unit, taking one of a cell's two capacity slots. The Beacon and terrain take none.

Plan receipt

The HTTP 202 metadata plus the WebSocket received message that follow the server storing a source plan.

Resolution event

An action result carried inside the next state.events, rather than sent as its own realtime message.

Static validation

The checks that happen before global resolution: JSON shape, ownership of the acting Units, action fields, required fields, and the current Tick gate.

Supercover line

An integer grid line that includes every cell it touches, which is what stops diagonal corner gaps from opening up in obstacle vision blocking.

Tick

One logical decision-and-resolution cycle. It advances only after an atomic world commit, and it never races to catch up after downtime.

Terrain batch

A single OBSTACLE or RESOURCE object, with no UUID, holding a sorted positions array of every currently visible cell of that kind.

World snapshot

The immutable input one phase of deterministic resolution works from. Combat uses a single shared snapshot, which is what makes all legal attacks simultaneous.