How donsmackzy/lugbe-to-maitama works
Lugbe to Maitama is a browser-based multiplayer Abuja survival game. Players accept the satire disclaimer, connect from the browser, and send intents to an authoritative Colyseus room; the room resolves simulation effects, persists economic changes, and syncs state back for client reconciliation and HUD rendering. The README documents additional simulation, Redis recovery/rate limiting, and optional AI dialogue capabilities. Some links reflect README documentation because sampled excerpts do not expose all runtime calls.
Main entry points: WorldRoom.ts World room · main.ts Client bootstrap · MainScene.ts Isometric scene · ColyseusClient.ts Colyseus client
Components 30
Browser game
- Disclaimer onboarding
apps/web/src/ui/SplashScreen.ts - Client bootstrap
apps/web/src/main.ts - Isometric scene
apps/web/src/game/MainScene.ts - Movement prediction
apps/web/src/game/PredictionManager.ts - Colyseus client
apps/web/src/network/ColyseusClient.ts - Game HUD
apps/web/src/ui/GameHUD.ts
Authoritative game
- World room
apps/server/src/rooms/WorldRoom.ts - Room state schema
apps/server/src/rooms/schema/WorldRoomState.ts - Player serial queue
apps/server/src/concurrency/PlayerSerial.ts - Economic ledger
apps/server/src/economy/ledger.ts - Redis services
apps/server/src/storage/redis.ts
Simulation engine
- Intent resolution
packages/engine/src/resolve.ts - Effect model
packages/engine/src/effects.ts - Rule evaluator
packages/engine/src/rules/evaluator.ts - Simulation state
packages/engine/src/state.ts - World advancement
packages/engine/src/advance.ts - Movement rules
packages/engine/src/movement.ts - Market rules
packages/engine/src/market.ts - Navigation grid
packages/engine/src/nav-grid.ts - Simulation helpers
packages/engine/src/simulation.ts - Abuja city pack
city-packs/abuja
NPC dialogue
- Dialogue HTTP service
apps/ai-service/src/server.ts - Request deduplicator
apps/ai-service/src/cache/stampede.ts - Dialogue cache
apps/ai-service/src/storage/redis.ts - LLM client
apps/ai-service/src/llm/client.ts - Prompt construction
apps/ai-service/src/llm/prompts.ts
Other components
- Player
- PostgreSQL
- Redis
- OpenAI API
Connections 33
- Player → Disclaimer onboarding: accepts disclaimer
- Disclaimer onboarding → Client bootstrap: provides credentials
apps/web/src/main.ts - Client bootstrap → Game HUD: creates
apps/web/src/main.ts - Client bootstrap → Colyseus client: connects
apps/web/src/main.ts - Client bootstrap → Isometric scene: starts
apps/web/src/main.ts - Isometric scene → Movement prediction: uses
apps/web/src/game/MainScene.ts - Isometric scene → Colyseus client: dispatches intents
apps/web/src/game/MainScene.ts - Isometric scene → Game HUD: updates
apps/web/src/game/MainScene.ts - Colyseus client → World room: sends intents
README.md - World room → Colyseus client: syncs state and ACKs
README.md - World room → Room state schema: uses schema
apps/server/src/rooms/WorldRoom.ts - World room → Player serial queue: queues player work
apps/server/src/rooms/WorldRoom.ts - Player serial queue → Intent resolution: runs intent resolution
README.md - World room → Economic ledger: commits effects
apps/server/src/rooms/WorldRoom.ts - World room → Redis services: checks limits and snapshots
apps/server/src/rooms/WorldRoom.ts - Economic ledger → PostgreSQL: writes transactions
apps/server/src/economy/ledger.ts - Redis services → Redis: stores snapshots and limits
README.md - Intent resolution → Rule evaluator: evaluates rules
packages/engine/src/resolve.ts - Rule evaluator → Effect model: produces effects
packages/engine/src/rules/evaluator.ts - Intent resolution → Simulation state: reads world state
packages/engine/src/resolve.ts - World advancement → Rule evaluator: evaluates ticks
packages/engine/src/advance.ts - World advancement → Effect model: produces effects
packages/engine/src/advance.ts - Simulation state → Navigation grid: uses grid
packages/engine/src/state.ts - Simulation helpers → Movement rules: uses movement rules
packages/engine/src/simulation.ts - Simulation helpers → Market rules: uses market rules
packages/engine/src/simulation.ts - World room → Abuja city pack: loads rules and data
apps/server/src/rooms/WorldRoom.ts - World room → Dialogue HTTP service: requests dialogue
README.md - Dialogue HTTP service → Dialogue cache: checks and stores cache
apps/ai-service/src/server.ts - Dialogue HTTP service → Request deduplicator: coalesces cache misses
apps/ai-service/src/server.ts - Request deduplicator → LLM client: runs single flight
README.md - Dialogue cache → Redis: reads and writes
README.md - LLM client → Prompt construction: builds prompt
apps/ai-service/src/llm/client.ts - LLM client → OpenAI API: requests completion
apps/ai-service/src/llm/client.ts