# paradisess13/paradise architecture

> Architecture diagram of the GitHub repository paradisess13/paradise, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paradisess13/paradise
- Repository: https://github.com/paradisess13/paradise

## Overview

Paradise Station is a BYOND Space Station 13 game, with TGUI providing player-facing interfaces written in JavaScript and exchanging data with DreamMaker. The main visible workflow is game state reaching TGUI, route selection choosing an interface, and interface actions returning through the backend to BYOND. The repository also contains Rust gameplay/support subsystems, map-manipulation tools, and browser UI assets. Source excerpts are selective; unsampled components are included only where the tree or README identifies a meaningful product capability, and uncertain links are omitted.

Main entry points: [`rust/src/milla`](https://github.com/paradisess13/paradise/tree/master/rust/src/milla) (Milla simulation), [`rust/src/mapmanip/mod.rs`](https://github.com/paradisess13/paradise/blob/master/rust/src/mapmanip/mod.rs) (Map manipulation), [`tgui/packages/tgui/interfaces`](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui/interfaces) (Game interfaces), [`tgui/packages/tgui/backend.ts`](https://github.com/paradisess13/paradise/blob/master/tgui/packages/tgui/backend.ts) (Backend bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["TGUI client"]
  node_tgui["TGUI framework"]
  node_backend["Backend bridge<br/>[backend.ts]"]
  node_routing["Interface routing<br/>[routes.tsx]"]
  node_interfaces["Game interfaces"]
  node_layouts["Window layouts"]
  node_panel["Panel client"]
  node_say["Chat client"]
end

subgraph group_game["Game runtime"]
  node_byond["BYOND runtime"]
  node_milla["Milla simulation"]
  node_milla_api["Milla API<br/>[api.rs]"]
  node_milla_model["Simulation model<br/>[model.rs]"]
  node_milla_sim["Simulation logic<br/>[simulate.rs]"]
  node_milla_tick["Simulation ticks<br/>[tick.rs]"]
  node_jobs["Background jobs<br/>[mod.rs]"]
end

subgraph group_map["Map tools"]
  node_mapmanip["Map manipulation<br/>[mod.rs]"]
  node_mapcore["Map representation"]
  node_mapgen["Map generation"]
  node_maptools["Submap tools"]
  node_dmm["DMM map processing<br/>[dmm.py]"]
end

subgraph group_browser["Browser UI"]
  node_browser_assets["Browser interfaces"]
  node_search["Search UI<br/>[search.js]"]
  node_stats["Statistics browser<br/>[statbrowser.js]"]
end

node_player(("Player"))

node_player -->|"uses"| node_tgui
node_tgui -->|"resolves views"| node_routing
node_routing -->|"loads interface"| node_interfaces
node_interfaces -->|"renders windows"| node_layouts
node_interfaces -->|"reads state; sends actions"| node_backend
node_backend -->|"exchanges messages"| node_byond
node_byond -->|"sends updates"| node_backend
node_player -.->|"uses"| node_panel
node_player -.->|"uses"| node_say
node_mapmanip -->|"uses map types"| node_mapcore
node_mapmanip -->|"calls generation"| node_mapgen
node_mapmanip -->|"extracts submaps"| node_maptools
node_milla -->|"exposes"| node_milla_api
node_milla -->|"declares"| node_milla_model
node_milla -->|"declares"| node_milla_sim
node_milla -->|"declares"| node_milla_tick
node_dmm -.->|"map data exchange"| node_mapmanip

click node_tgui "https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui"
click node_backend "https://github.com/paradisess13/paradise/blob/master/tgui/packages/tgui/backend.ts"
click node_routing "https://github.com/paradisess13/paradise/blob/master/tgui/packages/tgui/routes.tsx"
click node_interfaces "https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui/interfaces"
click node_layouts "https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui/layouts"
click node_panel "https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui-panel"
click node_say "https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui-say"
click node_milla "https://github.com/paradisess13/paradise/tree/master/rust/src/milla"
click node_milla_api "https://github.com/paradisess13/paradise/blob/master/rust/src/milla/api.rs"
click node_milla_model "https://github.com/paradisess13/paradise/blob/master/rust/src/milla/model.rs"
click node_milla_sim "https://github.com/paradisess13/paradise/blob/master/rust/src/milla/simulate.rs"
click node_milla_tick "https://github.com/paradisess13/paradise/blob/master/rust/src/milla/tick.rs"
click node_jobs "https://github.com/paradisess13/paradise/blob/master/rust/src/jobs/mod.rs"
click node_mapmanip "https://github.com/paradisess13/paradise/blob/master/rust/src/mapmanip/mod.rs"
click node_mapcore "https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/core"
click node_mapgen "https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/procgen"
click node_maptools "https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/tools"
click node_dmm "https://github.com/paradisess13/paradise/blob/master/tools/mapmerge2/dmm.py"
click node_browser_assets "https://github.com/paradisess13/paradise/tree/master/html/browser"
click node_search "https://github.com/paradisess13/paradise/blob/master/html/search.js"
click node_stats "https://github.com/paradisess13/paradise/blob/master/html/statbrowser.js"

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_tgui,node_backend,node_routing,node_interfaces,node_layouts,node_panel,node_say toneBlue
class node_byond,node_milla,node_milla_api,node_milla_model,node_milla_sim,node_milla_tick,node_jobs toneAmber
class node_mapmanip,node_mapcore,node_mapgen,node_maptools,node_dmm toneMint
class node_browser_assets,node_search,node_stats toneRose
class node_player toneIndigo
```

## Components

### TGUI client

- [TGUI framework](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui): `tgui/packages/tgui`
- [Backend bridge](https://github.com/paradisess13/paradise/blob/master/tgui/packages/tgui/backend.ts): `tgui/packages/tgui/backend.ts`
- [Interface routing](https://github.com/paradisess13/paradise/blob/master/tgui/packages/tgui/routes.tsx): `tgui/packages/tgui/routes.tsx`
- [Game interfaces](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui/interfaces): `tgui/packages/tgui/interfaces`
- [Window layouts](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui/layouts): `tgui/packages/tgui/layouts`
- [Panel client](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui-panel): `tgui/packages/tgui-panel`
- [Chat client](https://github.com/paradisess13/paradise/tree/master/tgui/packages/tgui-say): `tgui/packages/tgui-say`

### Game runtime

- **BYOND runtime**
- [Milla simulation](https://github.com/paradisess13/paradise/tree/master/rust/src/milla): `rust/src/milla`
- [Milla API](https://github.com/paradisess13/paradise/blob/master/rust/src/milla/api.rs): `rust/src/milla/api.rs`
- [Simulation model](https://github.com/paradisess13/paradise/blob/master/rust/src/milla/model.rs): `rust/src/milla/model.rs`
- [Simulation logic](https://github.com/paradisess13/paradise/blob/master/rust/src/milla/simulate.rs): `rust/src/milla/simulate.rs`
- [Simulation ticks](https://github.com/paradisess13/paradise/blob/master/rust/src/milla/tick.rs): `rust/src/milla/tick.rs`
- [Background jobs](https://github.com/paradisess13/paradise/blob/master/rust/src/jobs/mod.rs): `rust/src/jobs/mod.rs`

### Map tools

- [Map manipulation](https://github.com/paradisess13/paradise/blob/master/rust/src/mapmanip/mod.rs): `rust/src/mapmanip/mod.rs`
- [Map representation](https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/core): `rust/src/mapmanip/core`
- [Map generation](https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/procgen): `rust/src/mapmanip/procgen`
- [Submap tools](https://github.com/paradisess13/paradise/tree/master/rust/src/mapmanip/tools): `rust/src/mapmanip/tools`
- [DMM map processing](https://github.com/paradisess13/paradise/blob/master/tools/mapmerge2/dmm.py): `tools/mapmerge2/dmm.py`

### Browser UI

- [Browser interfaces](https://github.com/paradisess13/paradise/tree/master/html/browser): `html/browser`
- [Search UI](https://github.com/paradisess13/paradise/blob/master/html/search.js): `html/search.js`
- [Statistics browser](https://github.com/paradisess13/paradise/blob/master/html/statbrowser.js): `html/statbrowser.js`

### Other components

- **Player**

## Connections

- Player → TGUI framework: uses (evidence: `README.md`)
- TGUI framework → Interface routing: resolves views (evidence: `tgui/packages/tgui/routes.tsx`)
- Interface routing → Game interfaces: loads interface (evidence: `tgui/packages/tgui/routes.tsx`)
- Game interfaces → Window layouts: renders windows (evidence: `tgui/packages/tgui/interfaces/SuitStorage.jsx`)
- Game interfaces → Backend bridge: reads state; sends actions (evidence: `tgui/packages/tgui/interfaces/SecureStorage.jsx`)
- Backend bridge → BYOND runtime: exchanges messages (evidence: `tgui/packages/tgui/backend.ts`)
- BYOND runtime → Backend bridge: sends updates (evidence: `tgui/packages/tgui/backend.ts`)
- Player → Panel client: uses
- Player → Chat client: uses
- Map manipulation → Map representation: uses map types (evidence: `rust/src/mapmanip/mod.rs`)
- Map manipulation → Map generation: calls generation (evidence: `rust/src/mapmanip/mod.rs`)
- Map manipulation → Submap tools: extracts submaps (evidence: `rust/src/mapmanip/mod.rs`)
- Milla simulation → Milla API: exposes (evidence: `rust/src/milla/mod.rs`)
- Milla simulation → Simulation model: declares (evidence: `rust/src/milla/mod.rs`)
- Milla simulation → Simulation logic: declares (evidence: `rust/src/milla/mod.rs`)
- Milla simulation → Simulation ticks: declares (evidence: `rust/src/milla/mod.rs`)
- DMM map processing → Map manipulation: map data exchange
