How gandalfs3/migame works
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: main.ts Client startup · GameWorld.ts World coordinator · NetworkClient.ts Network client · NetworkServer.ts Network server
Components 28
Game client
- Client startup
packages/client/src/main.ts - 3D engine
packages/client/src/core/Engine.ts - Input controls
packages/client/src/input/InputManager.ts - Network client
packages/client/src/network/NetworkClient.ts - Character login
packages/client/src/ui/CharacterLoginModal.ts - Combat HUD
packages/client/src/ui/CombatHUD.ts - Game HUD
packages/client/src/ui/HUD.ts - Settings menu
packages/client/src/ui/SettingsMenu.ts - Combat feedback
packages/client/src/ui/FloatingText.ts - Player rendering
packages/client/src/entities/PlayerEntity.ts - Monster rendering
packages/client/src/entities/MonsterEntity.ts - Obstacle rendering
packages/client/src/entities/ObstacleRenderer.ts - Portal rendering
packages/client/src/entities/PortalRenderer.ts - Range indicator
packages/client/src/entities/RangeIndicator.ts - Procedural textures
packages/client/src/textures/ProceduralTextureFactory.ts - Asset manager
packages/client/src/core/AssetManager.ts
Shared contract
- Game data types
packages/common/src/types/index.ts - Game rules
packages/common/src/constants/index.ts
Game server
- Server startup
packages/server/src/index.ts - Network server
packages/server/src/network/NetworkServer.ts - World coordinator
packages/server/src/game/GameWorld.ts - Zones and maps
packages/server/src/game/MapManager.ts - Combat system
packages/server/src/game/CombatSystem.ts - Player state
packages/server/src/game/Player.ts - Monster AI
packages/server/src/game/Monster.ts
Profile persistence
- SQLite profiles
packages/server/src/db/DatabaseManager.ts
Other components
- Player
- WebSocket transport
Connections 33
- Player → Client startup: plays
- Client startup → 3D engine: creates
packages/client/src/main.ts - Client startup → Input controls: creates
packages/client/src/main.ts - Client startup → Network client: creates
packages/client/src/main.ts - Client startup → Character login: creates
packages/client/src/main.ts - Client startup → Combat HUD: updates
packages/client/src/main.ts - Client startup → Game HUD: uses
packages/client/src/main.ts - Client startup → Settings menu: uses
packages/client/src/main.ts - Client startup → Combat feedback: uses
packages/client/src/main.ts - Client startup → Range indicator: updates
packages/client/src/main.ts - Client startup → Player rendering: updates
packages/client/src/main.ts - Client startup → Monster rendering: updates
packages/client/src/main.ts - Client startup → Obstacle rendering: uses
packages/client/src/main.ts - Client startup → Portal rendering: uses
packages/client/src/main.ts - Client startup → Asset manager: uses
packages/client/src/main.ts - 3D engine → Procedural textures: uses
packages/client/src/core/Engine.ts - Network client → WebSocket transport: sends messages
packages/client/src/network/NetworkClient.ts - Network server → WebSocket transport: serves clients
packages/server/src/network/NetworkServer.ts - Server startup → World coordinator: creates
packages/server/src/index.ts - Server startup → Network server: creates
packages/server/src/index.ts - Network server → World coordinator: dispatches to
packages/server/src/network/NetworkServer.ts - World coordinator → Player state: manages
packages/server/src/game/GameWorld.ts - World coordinator → Monster AI: manages
packages/server/src/game/GameWorld.ts - World coordinator → Zones and maps: uses
packages/server/src/game/GameWorld.ts - World coordinator → Combat system: uses
packages/server/src/game/GameWorld.ts - World coordinator → SQLite profiles: persists profiles
packages/server/src/game/GameWorld.ts - Combat system → Player state: applies combat
packages/server/src/game/CombatSystem.ts - Combat system → Monster AI: applies combat
packages/server/src/game/CombatSystem.ts - Monster AI → Zones and maps: uses
packages/server/src/game/Monster.ts - Player state → Zones and maps: uses
packages/server/src/game/Player.ts - Network client → Game data types: uses protocol types
packages/client/src/network/NetworkClient.ts - Player rendering → Procedural textures: uses materials
packages/client/src/entities/PlayerEntity.ts - Monster rendering → Procedural textures: uses materials
packages/client/src/entities/MonsterEntity.ts