How alade017/osogbo-life-journey works
Osun Life is a browser-based life simulation in which players create a character, enter a shared town, travel between locations, and pursue housing, work, social, and recreational activities. The web routes and game services present and validate gameplay state; Supabase supplies persistent account and game data, while Colyseus rooms provide real-time multiplayer. The graph preserves the documented gameplay branches and principal world-rendering layers. Several capabilities are documented but their detailed implementation was not sampled, so those links are cited to the README.
Main entry points: server.ts Room server · _game.tsx Game shell · R3FTownSurface.tsx Town map surface · game.ts Game services
Components 24
Entry and routing
- Entry and auth
src/routes/index.tsx - Character creation
src/routes/_authenticated/create-character.tsx - Authenticated routes
src/routeTree.gen.ts - Game shell
src/routes/_authenticated/_game.tsx
Town and world
- Town model
src/lib/city-world.ts - Town map surface
src/components/map/R3FTownSurface.tsx - 3D world scene
src/components/3d/WorldScene.tsx - World theme
src/components/3d/world-theme.ts - Neighborhood model
src/game/neighborhood-model.ts - Town travel
src/lib/transport-service.ts - City dashboard
src/components/game/CityMapDashboard.tsx
Life simulation
- Jobs and schooling
src/routes/_authenticated/_game/jobs.tsx - Housing
src/routes/_authenticated/_game/house.tsx - Party life
src/routes/_authenticated/_game/party.tsx - Mini-games
src/lib/mini-games/ludo-engine.ts - Messaging
src/routes/api/messages/send.ts - Game services
src/lib/game.ts
Persistence and multiplayer
- Supabase client
src/integrations/supabase/client.ts - Room server
multiplayer/server.ts - Neighborhood room
multiplayer/neighborhood-room.ts - Party room
multiplayer/party-room.ts - Ludo room
multiplayer/ludo-room.ts - Mall room
multiplayer/mall-room.ts
Other components
- Player
Connections 24
- Player → Entry and auth: opens
- Entry and auth → Character creation: starts character
- Character creation → Game shell: enters town
- Game shell → Authenticated routes: uses routes
src/routeTree.gen.ts - Game shell → City dashboard: presents
- City dashboard → Town map surface: shows map
- Town map surface → Town model: renders town
- Town map surface → Town travel: initiates travel
- 3D world scene → World theme: uses theme
src/components/3d/WorldScene.tsx - Player → Jobs and schooling: pursues work
- Player → Housing: rents home
- Player → Party life: attends events
- Player → Mini-games: plays games
- Player → Messaging: sends messages
- Jobs and schooling → Game services: uses game data
- Housing → Game services: uses game data
- Game services → Supabase client: queries and mutates
src/lib/game.ts - Room server → Neighborhood room: registers
multiplayer/server.ts - Room server → Party room: registers
multiplayer/server.ts - Room server → Ludo room: registers
multiplayer/server.ts - Room server → Mall room: registers
multiplayer/server.ts - Player → Room server: joins shared world
- Neighborhood room → Neighborhood model: uses world model
multiplayer/neighborhood-room.ts - Ludo room → Mini-games: uses rules engine
multiplayer/ludo-room.ts