Architecture & Design¶
The complete design set for Lattice — vision, system architecture, the netcode low-level design, the control-plane services, engine integration, the implementation roadmap, and the two hosting guides. These are the authoritative design documents; the rest of this site (API reference, control-plane reference, getting-started) is grounded in them.
Reading order¶
flowchart LR
D0["00 Overview & Vision"] --> D1["01 High-Level Design"] --> D2["02 Netcode LLD"]
D1 --> D3["03 Auth Service"]
D1 --> D4["04 Social Library"]
D2 --> D5["05 Engine Integration"]
D5 --> D7["07 Custom Module Guide"]
D7 --> D9["09 WASM Managed Hosting"]
D1 --> D6["06 Implementation Roadmap"]
| Doc | What it covers |
|---|---|
| 00 — Overview & Vision | Vision, goals/non-goals, the three locked decisions, system context, glossary, competitive comparison. |
| 01 — High-Level Design | End-to-end architecture: data plane vs control plane, topologies, session lifecycle, component responsibilities. |
| 02 — Netcode Low-Level Design | Transport, reliability channels, serialization/quantization/delta, replication, prediction/rollback, interest management, lag compensation, anti-cheat (§18). |
| 03 — Authentication Service | lattice-auth: identity, Ed25519 token issuance, session tokens. |
| 04 — Social Library | lattice-social: friends/presence/parties/invites over WSS, the social graph, presence model. |
| 05 — Engine Integration | The C ABI boundary and how Unity / Unreal / Godot / web wrap it idiomatically. |
| 06 — Implementation Roadmap | Phased delivery plan, milestones, dependencies, risk register. |
| 07 — Custom Module Guide | Build + link the shared game-sim module (Linux + Windows/MinGW); tied to the real reference build. |
| 08 — Server/Client API (legacy) | The original per-function reference. Superseded by the API Reference, which covers the current ABI including the newer anti-cheat / jobs / fetch / store / events calls. |
| 09 — WASM Managed Hosting | Running untrusted modules safely in a WASM sandbox; the write-once / dual-target model. |
Where the rendered API lives
Doc 08 is preserved here for provenance, but the complete, current API surface — including the anti-cheat, async-jobs, web-fetch, embedded-store, and custom-events ABI added since 08 — is in the API Reference section.