# gandalfs3/migame architecture

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

- Interactive diagram: https://gitdiagram.com/gandalfs3/migame
- Repository: https://github.com/gandalfs3/migame

## Overview

MiGame is a real-time, multiplayer 3D RPG. Players choose a character, send movement and combat actions, and receive world updates rendered as a shared game scene. The server owns player and monster simulation, zone traversal, combat, and profile persistence; shared types and constants define the client/server contract. The sampled files support the main startup, rendering, and world-ownership relationships. Several UI and server capabilities are represented from the source index, so links not shown there are omitted.

Main entry points: [`packages/client/src/main.ts`](https://github.com/gandalfs3/migame/blob/main/packages/client/src/main.ts) (Client startup), [`packages/server/src/game/GameWorld.ts`](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/GameWorld.ts) (World coordinator), [`packages/client/src/network/NetworkClient.ts`](https://github.com/gandalfs3/migame/blob/main/packages/client/src/network/NetworkClient.ts) (Network client), [`packages/server/src/network/NetworkServer.ts`](https://github.com/gandalfs3/migame/blob/main/packages/server/src/network/NetworkServer.ts) (Network server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Game client"]
  node_client_app["Client startup<br/>[main.ts]"]
  node_engine["3D engine<br/>[Engine.ts]"]
  node_input["Input controls<br/>[InputManager.ts]"]
  node_client_net["Network client<br/>[NetworkClient.ts]"]
  node_login["Character login"]
  node_combat_hud["Combat HUD<br/>[CombatHUD.ts]"]
  node_hud["Game HUD<br/>[HUD.ts]"]
  node_settings["Settings menu<br/>[SettingsMenu.ts]"]
  node_floating_text["Combat feedback<br/>[FloatingText.ts]"]
  node_player_entity["Player rendering<br/>[PlayerEntity.ts]"]
  node_monster_entity["Monster rendering<br/>[MonsterEntity.ts]"]
  node_obstacle["Obstacle rendering"]
  node_portal["Portal rendering<br/>[PortalRenderer.ts]"]
  node_range["Range indicator<br/>[RangeIndicator.ts]"]
  node_textures["Procedural textures"]
  node_assets["Asset manager<br/>[AssetManager.ts]"]
end

subgraph group_shared["Shared contract"]
  node_common_types["Game data types<br/>[index.ts]"]
  node_common_constants["Game rules<br/>[index.ts]"]
end

subgraph group_server["Game server"]
  node_server_entry["Server startup<br/>[index.ts]"]
  node_network_server["Network server<br/>[NetworkServer.ts]"]
  node_world["World coordinator<br/>[GameWorld.ts]"]
  node_maps["Zones and maps<br/>[MapManager.ts]"]
  node_combat["Combat system<br/>[CombatSystem.ts]"]
  node_player_state["Player state<br/>[Player.ts]"]
  node_monster_state["Monster AI<br/>[Monster.ts]"]
end

subgraph group_persistence["Profile persistence"]
  node_database[("SQLite profiles<br/>[DatabaseManager.ts]")]
end

node_player(("Player"))
node_websocket{{"WebSocket transport"}}

node_player -->|"plays"| node_client_app
node_client_app -->|"creates"| node_engine
node_client_app -->|"creates"| node_input
node_client_app -->|"creates"| node_client_net
node_client_app -->|"creates"| node_login
node_client_app -->|"updates"| node_combat_hud
node_client_app -->|"uses"| node_hud
node_client_app -->|"uses"| node_settings
node_client_app -->|"uses"| node_floating_text
node_client_app -->|"updates"| node_range
node_client_app -->|"updates"| node_player_entity
node_client_app -->|"updates"| node_monster_entity
node_client_app -->|"uses"| node_obstacle
node_client_app -->|"uses"| node_portal
node_client_app -->|"uses"| node_assets
node_engine -->|"uses"| node_textures
node_client_net -->|"sends messages"| node_websocket
node_network_server -->|"serves clients"| node_websocket
node_server_entry -->|"creates"| node_world
node_server_entry -->|"creates"| node_network_server
node_network_server -->|"dispatches to"| node_world
node_world -->|"manages"| node_player_state
node_world -->|"manages"| node_monster_state
node_world -->|"uses"| node_maps
node_world -->|"uses"| node_combat
node_world -->|"persists profiles"| node_database
node_combat -->|"applies combat"| node_player_state
node_combat -->|"applies combat"| node_monster_state
node_monster_state -->|"uses"| node_maps
node_player_state -->|"uses"| node_maps
node_client_net -->|"uses protocol types"| node_common_types
node_player_entity -->|"uses materials"| node_textures
node_monster_entity -->|"uses materials"| node_textures

click node_client_app "https://github.com/gandalfs3/migame/blob/main/packages/client/src/main.ts"
click node_engine "https://github.com/gandalfs3/migame/blob/main/packages/client/src/core/Engine.ts"
click node_input "https://github.com/gandalfs3/migame/blob/main/packages/client/src/input/InputManager.ts"
click node_client_net "https://github.com/gandalfs3/migame/blob/main/packages/client/src/network/NetworkClient.ts"
click node_login "https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/CharacterLoginModal.ts"
click node_combat_hud "https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/CombatHUD.ts"
click node_hud "https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/HUD.ts"
click node_settings "https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/SettingsMenu.ts"
click node_floating_text "https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/FloatingText.ts"
click node_player_entity "https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/PlayerEntity.ts"
click node_monster_entity "https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/MonsterEntity.ts"
click node_obstacle "https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/ObstacleRenderer.ts"
click node_portal "https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/PortalRenderer.ts"
click node_range "https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/RangeIndicator.ts"
click node_textures "https://github.com/gandalfs3/migame/blob/main/packages/client/src/textures/ProceduralTextureFactory.ts"
click node_assets "https://github.com/gandalfs3/migame/blob/main/packages/client/src/core/AssetManager.ts"
click node_common_types "https://github.com/gandalfs3/migame/blob/main/packages/common/src/types/index.ts"
click node_common_constants "https://github.com/gandalfs3/migame/blob/main/packages/common/src/constants/index.ts"
click node_server_entry "https://github.com/gandalfs3/migame/blob/main/packages/server/src/index.ts"
click node_network_server "https://github.com/gandalfs3/migame/blob/main/packages/server/src/network/NetworkServer.ts"
click node_world "https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/GameWorld.ts"
click node_maps "https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/MapManager.ts"
click node_combat "https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/CombatSystem.ts"
click node_player_state "https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/Player.ts"
click node_monster_state "https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/Monster.ts"
click node_database "https://github.com/gandalfs3/migame/blob/main/packages/server/src/db/DatabaseManager.ts"

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_client_app,node_engine,node_input,node_client_net,node_login,node_combat_hud,node_hud,node_settings,node_floating_text,node_player_entity,node_monster_entity,node_obstacle,node_portal,node_range,node_textures,node_assets toneBlue
class node_common_types,node_common_constants toneAmber
class node_server_entry,node_network_server,node_world,node_maps,node_combat,node_player_state,node_monster_state toneMint
class node_database toneRose
class node_player,node_websocket toneIndigo
```

## Components

### Game client

- [Client startup](https://github.com/gandalfs3/migame/blob/main/packages/client/src/main.ts): `packages/client/src/main.ts`
- [3D engine](https://github.com/gandalfs3/migame/blob/main/packages/client/src/core/Engine.ts): `packages/client/src/core/Engine.ts`
- [Input controls](https://github.com/gandalfs3/migame/blob/main/packages/client/src/input/InputManager.ts): `packages/client/src/input/InputManager.ts`
- [Network client](https://github.com/gandalfs3/migame/blob/main/packages/client/src/network/NetworkClient.ts): `packages/client/src/network/NetworkClient.ts`
- [Character login](https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/CharacterLoginModal.ts): `packages/client/src/ui/CharacterLoginModal.ts`
- [Combat HUD](https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/CombatHUD.ts): `packages/client/src/ui/CombatHUD.ts`
- [Game HUD](https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/HUD.ts): `packages/client/src/ui/HUD.ts`
- [Settings menu](https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/SettingsMenu.ts): `packages/client/src/ui/SettingsMenu.ts`
- [Combat feedback](https://github.com/gandalfs3/migame/blob/main/packages/client/src/ui/FloatingText.ts): `packages/client/src/ui/FloatingText.ts`
- [Player rendering](https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/PlayerEntity.ts): `packages/client/src/entities/PlayerEntity.ts`
- [Monster rendering](https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/MonsterEntity.ts): `packages/client/src/entities/MonsterEntity.ts`
- [Obstacle rendering](https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/ObstacleRenderer.ts): `packages/client/src/entities/ObstacleRenderer.ts`
- [Portal rendering](https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/PortalRenderer.ts): `packages/client/src/entities/PortalRenderer.ts`
- [Range indicator](https://github.com/gandalfs3/migame/blob/main/packages/client/src/entities/RangeIndicator.ts): `packages/client/src/entities/RangeIndicator.ts`
- [Procedural textures](https://github.com/gandalfs3/migame/blob/main/packages/client/src/textures/ProceduralTextureFactory.ts): `packages/client/src/textures/ProceduralTextureFactory.ts`
- [Asset manager](https://github.com/gandalfs3/migame/blob/main/packages/client/src/core/AssetManager.ts): `packages/client/src/core/AssetManager.ts`

### Shared contract

- [Game data types](https://github.com/gandalfs3/migame/blob/main/packages/common/src/types/index.ts): `packages/common/src/types/index.ts`
- [Game rules](https://github.com/gandalfs3/migame/blob/main/packages/common/src/constants/index.ts): `packages/common/src/constants/index.ts`

### Game server

- [Server startup](https://github.com/gandalfs3/migame/blob/main/packages/server/src/index.ts): `packages/server/src/index.ts`
- [Network server](https://github.com/gandalfs3/migame/blob/main/packages/server/src/network/NetworkServer.ts): `packages/server/src/network/NetworkServer.ts`
- [World coordinator](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/GameWorld.ts): `packages/server/src/game/GameWorld.ts`
- [Zones and maps](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/MapManager.ts): `packages/server/src/game/MapManager.ts`
- [Combat system](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/CombatSystem.ts): `packages/server/src/game/CombatSystem.ts`
- [Player state](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/Player.ts): `packages/server/src/game/Player.ts`
- [Monster AI](https://github.com/gandalfs3/migame/blob/main/packages/server/src/game/Monster.ts): `packages/server/src/game/Monster.ts`

### Profile persistence

- [SQLite profiles](https://github.com/gandalfs3/migame/blob/main/packages/server/src/db/DatabaseManager.ts): `packages/server/src/db/DatabaseManager.ts`

### Other components

- **Player**
- **WebSocket transport**

## Connections

- Player → Client startup: plays
- Client startup → 3D engine: creates (evidence: `packages/client/src/main.ts`)
- Client startup → Input controls: creates (evidence: `packages/client/src/main.ts`)
- Client startup → Network client: creates (evidence: `packages/client/src/main.ts`)
- Client startup → Character login: creates (evidence: `packages/client/src/main.ts`)
- Client startup → Combat HUD: updates (evidence: `packages/client/src/main.ts`)
- Client startup → Game HUD: uses (evidence: `packages/client/src/main.ts`)
- Client startup → Settings menu: uses (evidence: `packages/client/src/main.ts`)
- Client startup → Combat feedback: uses (evidence: `packages/client/src/main.ts`)
- Client startup → Range indicator: updates (evidence: `packages/client/src/main.ts`)
- Client startup → Player rendering: updates (evidence: `packages/client/src/main.ts`)
- Client startup → Monster rendering: updates (evidence: `packages/client/src/main.ts`)
- Client startup → Obstacle rendering: uses (evidence: `packages/client/src/main.ts`)
- Client startup → Portal rendering: uses (evidence: `packages/client/src/main.ts`)
- Client startup → Asset manager: uses (evidence: `packages/client/src/main.ts`)
- 3D engine → Procedural textures: uses (evidence: `packages/client/src/core/Engine.ts`)
- Network client → WebSocket transport: sends messages (evidence: `packages/client/src/network/NetworkClient.ts`)
- Network server → WebSocket transport: serves clients (evidence: `packages/server/src/network/NetworkServer.ts`)
- Server startup → World coordinator: creates (evidence: `packages/server/src/index.ts`)
- Server startup → Network server: creates (evidence: `packages/server/src/index.ts`)
- Network server → World coordinator: dispatches to (evidence: `packages/server/src/network/NetworkServer.ts`)
- World coordinator → Player state: manages (evidence: `packages/server/src/game/GameWorld.ts`)
- World coordinator → Monster AI: manages (evidence: `packages/server/src/game/GameWorld.ts`)
- World coordinator → Zones and maps: uses (evidence: `packages/server/src/game/GameWorld.ts`)
- World coordinator → Combat system: uses (evidence: `packages/server/src/game/GameWorld.ts`)
- World coordinator → SQLite profiles: persists profiles (evidence: `packages/server/src/game/GameWorld.ts`)
- Combat system → Player state: applies combat (evidence: `packages/server/src/game/CombatSystem.ts`)
- Combat system → Monster AI: applies combat (evidence: `packages/server/src/game/CombatSystem.ts`)
- Monster AI → Zones and maps: uses (evidence: `packages/server/src/game/Monster.ts`)
- Player state → Zones and maps: uses (evidence: `packages/server/src/game/Player.ts`)
- Network client → Game data types: uses protocol types (evidence: `packages/client/src/network/NetworkClient.ts`)
- Player rendering → Procedural textures: uses materials (evidence: `packages/client/src/entities/PlayerEntity.ts`)
- Monster rendering → Procedural textures: uses materials (evidence: `packages/client/src/entities/MonsterEntity.ts`)
