How qingtian1927/rune-race works
Rune Race is a 3D online horse-racing game with secret Rune tactics, multiplayer rooms, bots, accounts, profiles, and a shop. Players enter through the web client, join a lobby, and play through realtime server coordination and shared game rules; the client renders the match on a 3D board. The graph also includes the operator console and analytics. Some server routes and client pages are unsampled, so those connections are included only where the README or source index supports them.
Main entry points: handlers.ts Realtime handlers · App.tsx Web routes · bot-manager.ts Bot manager · OnlineGamePage.tsx Match experience
Components 21
Web client
- Web routes
apps/web/src/App.tsx - Player identity
apps/web/src/hooks/useAuth.tsx - Lobby experience
apps/web/src/pages/LobbyPage.tsx - Match experience
apps/web/src/pages/OnlineGamePage.tsx - 3D board
apps/web/src/scenes/BoardScene.tsx - Profiles
apps/web/src/pages/ProfileEdit.tsx - Cosmetics shop
apps/web/src/pages/ShopPage.tsx
Realtime server
- Lobby state
apps/server/src/lobby/lobby-store.ts - Realtime handlers
apps/server/src/socket/handlers.ts - Game sessions
apps/server/src/game/game-store.ts - Room chat
apps/server/src/chat/chat-store.ts - Bot manager
apps/server/src/bot/bot-manager.ts
Game domain
- Game engine
packages/game-engine/src/engine.ts - Rune state
packages/game-engine/src/rune/state.ts - Rune placement
packages/game-engine/src/rune/placement.ts
Shared rules
- Shared protocol
packages/shared/src/protocol/events.ts - Bot decisions
packages/bot-ai/src/decide.ts
Operations
- Admin console
apps/admin/src/App.tsx - Analytics service
apps/server/src/analytics/service.ts
Other components
- Player
- Supabase
Connections 25
- Player → Web routes: uses
README.md - Web routes → Player identity: provides identity
apps/web/src/App.tsx - Web routes → Lobby experience: routes to
apps/web/src/App.tsx - Web routes → Match experience: routes to
apps/web/src/App.tsx - Web routes → Profiles: routes to
apps/web/src/App.tsx - Web routes → Cosmetics shop: routes to
apps/web/src/App.tsx - Match experience → 3D board: renders
- Lobby experience → Realtime handlers: sends commands
- Match experience → Realtime handlers: sends commands
- Realtime handlers → Lobby state: dispatches lobby actions
apps/server/src/socket/handlers.ts - Realtime handlers → Game sessions: dispatches game actions
apps/server/src/socket/handlers.ts - Realtime handlers → Room chat: dispatches chat
apps/server/src/socket/handlers.ts - Realtime handlers → Bot manager: coordinates bots
apps/server/src/socket/handlers.ts - Bot manager → Lobby state: seats bots
apps/server/src/bot/bot-manager.ts - Bot manager → Game sessions: executes actions
apps/server/src/bot/bot-manager.ts - Bot manager → Room chat: generates chat
apps/server/src/bot/bot-manager.ts - Bot manager → Bot decisions: requests decisions
apps/server/src/bot/bot-manager.ts - Game sessions → Game engine: applies game rules
apps/server/src/game/game-store.ts - Game engine → Rune state: initializes Rune state
packages/game-engine/src/engine.ts - Game engine → Rune placement: opens placement phase
packages/game-engine/src/engine.ts - Realtime handlers → Shared protocol: validates commands
apps/server/src/socket/handlers.ts - Admin console → Analytics service: requests reports
- Analytics service → Supabase: reads and writes
apps/server/src/analytics/service.ts - Profiles → Supabase: uses account data
- Cosmetics shop → Supabase: uses account data