# greytide-inc/ss13.live architecture

> Architecture diagram of the GitHub repository greytide-inc/ss13.live, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/greytide-inc/ss13.live
- Repository: https://github.com/greytide-inc/ss13.live

## Overview

ss13.live is a browser-based Space Station 13 game: TypeScript game rules run on a rewritten engine, with a worker-backed single-player mode and an optional Node/WebSocket multiplayer server. The user joins or starts a round, plays through the rendered station and game UI, and reaches round end/restart; Creative mode is a documented alternate play mode. Edges below rely on README statements and the shown source/index references; unsampled subsystems are represented at directory level rather than given speculative internal links.

Main entry points: [`web/worker`](https://github.com/greytide-inc/ss13.live/tree/main/web/worker) (Game page), [`web/src/vm/interpreter.ts`](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/interpreter.ts) (Proc interpreter), [`web/src/worker/boot-worker.ts`](https://github.com/greytide-inc/ss13.live/blob/main/web/src/worker/boot-worker.ts) (Worker boot), [`web/src/render/station-client.ts`](https://github.com/greytide-inc/ss13.live/blob/main/web/src/render/station-client.ts) (Station renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_gamecode["Game rules"]
end

subgraph group_engine["Engine"]
  node_vm["Proc interpreter<br/>[interpreter.ts]"]
  node_typeworld["Types and world<br/>[objtree.ts]"]
  node_objects["Objects and values<br/>[objects.ts]"]
  node_clients["Client services<br/>[clients.ts]"]
  node_appearance["Appearance model<br/>[appearance.ts]"]
  node_dmi["DMI icons<br/>[dmi.ts]"]
end

subgraph group_browser["Browser client"]
  node_page["Game page"]
  node_worker["Worker boot<br/>[boot-worker.ts]"]
  node_clientview["Client view<br/>[client-view.ts]"]
  node_renderer["Station renderer<br/>[station-client.ts]"]
  node_scene["Client scene<br/>[client-scene.ts]"]
  node_tgui["TGUI interface<br/>[tgui.js]"]
  node_save[("Browser saves<br/>[savefile.ts]")]
end

subgraph group_multiplayer["Multiplayer server"]
  node_server["Multiplayer server<br/>[server.mjs]"]
  node_socket["Player WebSocket"]
end

node_player(("Player"))
node_indexeddb[("IndexedDB")]

node_player -->|"plays in"| node_page
node_page -->|"starts worker"| node_worker
node_worker -->|"runs rules"| node_gamecode
node_worker -->|"boots engine"| node_vm
node_vm -->|"uses type tree"| node_typeworld
node_vm -->|"evaluates values"| node_objects
node_vm -->|"dispatches client calls"| node_clients
node_worker -->|"builds client view"| node_clientview
node_clientview -->|"resolves icons"| node_appearance
node_clientview -->|"sends view"| node_page
node_page -->|"draws station"| node_renderer
node_renderer -->|"draws appearances"| node_appearance
node_renderer -->|"loads icon metadata"| node_dmi
node_scene -->|"reuses icon drawing"| node_renderer
node_page -->|"opens UI windows"| node_tgui
node_gamecode -->|"stores game saves"| node_save
node_save -->|"persists in"| node_indexeddb
node_player -.->|"connects multiplayer"| node_socket
node_socket -->|"sends game messages"| node_server
node_server -->|"runs same rules"| node_gamecode
node_server -->|"serves game page"| node_page

click node_page "https://github.com/greytide-inc/ss13.live/tree/main/web/worker"
click node_worker "https://github.com/greytide-inc/ss13.live/blob/main/web/src/worker/boot-worker.ts"
click node_clientview "https://github.com/greytide-inc/ss13.live/blob/main/web/src/worker/client-view.ts"
click node_renderer "https://github.com/greytide-inc/ss13.live/blob/main/web/src/render/station-client.ts"
click node_scene "https://github.com/greytide-inc/ss13.live/blob/main/web/src/render/client-scene.ts"
click node_tgui "https://github.com/greytide-inc/ss13.live/blob/main/tgui/src/tgui.js"
click node_gamecode "https://github.com/greytide-inc/ss13.live/tree/main/web/game"
click node_vm "https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/interpreter.ts"
click node_typeworld "https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/objtree.ts"
click node_objects "https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/objects.ts"
click node_clients "https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/clients.ts"
click node_appearance "https://github.com/greytide-inc/ss13.live/blob/main/web/src/appearance/appearance.ts"
click node_dmi "https://github.com/greytide-inc/ss13.live/blob/main/web/src/dmi/dmi.ts"
click node_save "https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/savefile.ts"
click node_server "https://github.com/greytide-inc/ss13.live/blob/main/web/tools/server.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gamecode toneBlue
class node_vm,node_typeworld,node_objects,node_clients,node_appearance,node_dmi,node_indexeddb toneAmber
class node_page,node_worker,node_clientview,node_renderer,node_scene,node_tgui,node_save toneMint
class node_server,node_socket toneRose
class node_player toneIndigo
```

## Components

### Game runtime

- [Game rules](https://github.com/greytide-inc/ss13.live/tree/main/web/game): `web/game`

### Engine

- [Proc interpreter](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/interpreter.ts): `web/src/vm/interpreter.ts`
- [Types and world](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/objtree.ts): `web/src/vm/objtree.ts`
- [Objects and values](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/objects.ts): `web/src/vm/objects.ts`
- [Client services](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/clients.ts): `web/src/vm/clients.ts`
- [Appearance model](https://github.com/greytide-inc/ss13.live/blob/main/web/src/appearance/appearance.ts): `web/src/appearance/appearance.ts`
- [DMI icons](https://github.com/greytide-inc/ss13.live/blob/main/web/src/dmi/dmi.ts): `web/src/dmi/dmi.ts`

### Browser client

- [Game page](https://github.com/greytide-inc/ss13.live/tree/main/web/worker): `web/worker`
- [Worker boot](https://github.com/greytide-inc/ss13.live/blob/main/web/src/worker/boot-worker.ts): `web/src/worker/boot-worker.ts`
- [Client view](https://github.com/greytide-inc/ss13.live/blob/main/web/src/worker/client-view.ts): `web/src/worker/client-view.ts`
- [Station renderer](https://github.com/greytide-inc/ss13.live/blob/main/web/src/render/station-client.ts): `web/src/render/station-client.ts`
- [Client scene](https://github.com/greytide-inc/ss13.live/blob/main/web/src/render/client-scene.ts): `web/src/render/client-scene.ts`
- [TGUI interface](https://github.com/greytide-inc/ss13.live/blob/main/tgui/src/tgui.js): `tgui/src/tgui.js`
- [Browser saves](https://github.com/greytide-inc/ss13.live/blob/main/web/src/vm/savefile.ts): `web/src/vm/savefile.ts`

### Multiplayer server

- [Multiplayer server](https://github.com/greytide-inc/ss13.live/blob/main/web/tools/server.mjs): `web/tools/server.mjs`
- **Player WebSocket**

### Other components

- **Player**
- **IndexedDB**

## Connections

- Player → Game page: plays in
- Game page → Worker boot: starts worker
- Worker boot → Game rules: runs rules
- Worker boot → Proc interpreter: boots engine (evidence: `web/src/worker/boot-worker.ts`)
- Proc interpreter → Types and world: uses type tree (evidence: `web/src/vm/interpreter.ts`)
- Proc interpreter → Objects and values: evaluates values (evidence: `web/src/vm/interpreter.ts`)
- Proc interpreter → Client services: dispatches client calls (evidence: `web/src/vm/interpreter.ts`)
- Worker boot → Client view: builds client view (evidence: `web/src/worker/boot-worker.ts`)
- Client view → Appearance model: resolves icons (evidence: `web/src/worker/client-view.ts`)
- Client view → Game page: sends view
- Game page → Station renderer: draws station
- Station renderer → Appearance model: draws appearances (evidence: `web/src/render/station-client.ts`)
- Station renderer → DMI icons: loads icon metadata (evidence: `web/src/render/station-client.ts`)
- Client scene → Station renderer: reuses icon drawing (evidence: `web/src/render/client-scene.ts`)
- Game page → TGUI interface: opens UI windows
- Game rules → Browser saves: stores game saves
- Browser saves → IndexedDB: persists in
- Player → Player WebSocket: connects multiplayer
- Player WebSocket → Multiplayer server: sends game messages (evidence: `web/tools/server.mjs`)
- Multiplayer server → Game rules: runs same rules
- Multiplayer server → Game page: serves game page (evidence: `web/tools/server.mjs`)
