# namak1/3dgame architecture

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

- Interactive diagram: https://gitdiagram.com/namak1/3dgame
- Repository: https://github.com/namak1/3dgame

## Overview

Volcano Island — Cargo Run is a standalone browser-based 3D arcade game. The main workflow is steering a boat between two islands, loading and discharging timed cargo contracts, avoiding threats, and earning cash for upgrades. The game’s substantial runtime is concentrated in game.js; the README documents gameplay capabilities beyond the sampled excerpts, so those links cite the README rather than implying the unsampled code was inspected.

Main entry points: [`game.js`](https://github.com/namak1/3dgame/blob/main/game.js) (Hull And Run State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_world["Game World"]
  node_scene["3D Scene<br/>[game.js]"]
  node_islands["Volcano Islands<br/>[game.js]"]
  node_camera["Orbit Camera<br/>[game.js]"]
end

subgraph group_voyage["Cargo Voyage"]
  node_controls["Boat Controls<br/>[game.js]"]
  node_boat["Boat Handling<br/>[game.js]"]
  node_contracts["Cargo Contracts<br/>[game.js]"]
  node_dock["Dock Actions<br/>[game.js]"]
  node_pickups["Cash And Health<br/>[game.js]"]
  node_upgrades["Upgrade Shop<br/>[game.js]"]
  node_runstate["Hull And Run State<br/>[game.js]"]
end

subgraph group_hazards["Threats And Defense"]
  node_threats["Mines And Shells<br/>[game.js]"]
  node_carriers["Carrier Patrols<br/>[game.js]"]
  node_jets["Escort Jets<br/>[game.js]"]
  node_batteries["Coast Batteries<br/>[game.js]"]
  node_safezones["Island Safe Zones<br/>[game.js]"]
end

subgraph group_interface["Player Interface"]
  node_hud["HUD And Radar<br/>[game.js]"]
end

node_player(("Player"))

node_player -->|"steers"| node_controls
node_player -->|"loads cargo"| node_dock
node_player -->|"orbits view"| node_camera
node_controls -->|"drives"| node_boat
node_boat -->|"moves in"| node_scene
node_islands -->|"appear in"| node_scene
node_camera -->|"views"| node_scene
node_dock -->|"loads or discharges"| node_contracts
node_contracts -->|"deadline affects"| node_runstate
node_pickups -->|"restore or reward"| node_runstate
node_runstate -->|"funds"| node_upgrades
node_threats -->|"damage hull and cargo"| node_runstate
node_carriers -->|"intercept"| node_boat
node_jets -->|"fire at"| node_boat
node_batteries -->|"destroy nearby mines"| node_threats
node_batteries -->|"fire beams at"| node_jets
node_safezones -->|"protect"| node_boat
node_hud -->|"shows status"| node_player
node_runstate -->|"updates"| node_hud

click node_scene "https://github.com/namak1/3dgame/blob/main/game.js"
click node_islands "https://github.com/namak1/3dgame/blob/main/game.js"
click node_camera "https://github.com/namak1/3dgame/blob/main/game.js"
click node_controls "https://github.com/namak1/3dgame/blob/main/game.js"
click node_boat "https://github.com/namak1/3dgame/blob/main/game.js"
click node_contracts "https://github.com/namak1/3dgame/blob/main/game.js"
click node_dock "https://github.com/namak1/3dgame/blob/main/game.js"
click node_pickups "https://github.com/namak1/3dgame/blob/main/game.js"
click node_upgrades "https://github.com/namak1/3dgame/blob/main/game.js"
click node_threats "https://github.com/namak1/3dgame/blob/main/game.js"
click node_carriers "https://github.com/namak1/3dgame/blob/main/game.js"
click node_jets "https://github.com/namak1/3dgame/blob/main/game.js"
click node_batteries "https://github.com/namak1/3dgame/blob/main/game.js"
click node_safezones "https://github.com/namak1/3dgame/blob/main/game.js"
click node_hud "https://github.com/namak1/3dgame/blob/main/game.js"
click node_runstate "https://github.com/namak1/3dgame/blob/main/game.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_scene,node_islands,node_camera toneBlue
class node_controls,node_boat,node_contracts,node_dock,node_pickups,node_upgrades,node_runstate toneAmber
class node_threats,node_carriers,node_jets,node_batteries,node_safezones toneMint
class node_hud toneRose
class node_player toneIndigo
```

## Components

### Game World

- [3D Scene](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Volcano Islands](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Orbit Camera](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`

### Cargo Voyage

- [Boat Controls](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Boat Handling](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Cargo Contracts](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Dock Actions](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Cash And Health](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Upgrade Shop](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Hull And Run State](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`

### Threats And Defense

- [Mines And Shells](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Carrier Patrols](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Escort Jets](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Coast Batteries](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`
- [Island Safe Zones](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`

### Player Interface

- [HUD And Radar](https://github.com/namak1/3dgame/blob/main/game.js): `game.js`

### Other components

- **Player**

## Connections

- Player → Boat Controls: steers (evidence: `README.md`)
- Player → Dock Actions: loads cargo (evidence: `README.md`)
- Player → Orbit Camera: orbits view (evidence: `README.md`)
- Boat Controls → Boat Handling: drives (evidence: `game.js`)
- Boat Handling → 3D Scene: moves in (evidence: `game.js`)
- Volcano Islands → 3D Scene: appear in (evidence: `game.js`)
- Orbit Camera → 3D Scene: views (evidence: `README.md`)
- Dock Actions → Cargo Contracts: loads or discharges (evidence: `README.md`)
- Cargo Contracts → Hull And Run State: deadline affects (evidence: `README.md`)
- Cash And Health → Hull And Run State: restore or reward (evidence: `README.md`)
- Hull And Run State → Upgrade Shop: funds (evidence: `README.md`)
- Mines And Shells → Hull And Run State: damage hull and cargo (evidence: `README.md`)
- Carrier Patrols → Boat Handling: intercept (evidence: `README.md`)
- Escort Jets → Boat Handling: fire at (evidence: `README.md`)
- Coast Batteries → Mines And Shells: destroy nearby mines (evidence: `README.md`)
- Coast Batteries → Escort Jets: fire beams at (evidence: `README.md`)
- Island Safe Zones → Boat Handling: protect (evidence: `README.md`)
- HUD And Radar → Player: shows status (evidence: `README.md`)
- Hull And Run State → HUD And Radar: updates (evidence: `game.js`)
