How hibaazmatkhan/axiom_project_ai works
AXIOM: THE LAST ROOM is a browser-based, four-player 3D escape-room game. Players join a room, authenticate or play as guests, then send actions over WebSockets to a server-authoritative match loop. The loop runs the shifting arena, role-specific information, puzzles, and Dealer adaptation; the client renders the arena and team state. Distinct supporting capabilities include accounts and profiles, avatar selection/uploads, and persistent match history. Several backend modules and UI routes are indexed but unsampled, so their documented roles are shown without asserting unverified call details.
Main entry points: game.py Authoritative match · main.py Web and WS server · GameClient.tsx Game client · page.tsx Room lobby
Components 22
Player entry
- Room lobby
frontend/app/lobby/page.tsx - Game page
frontend/app/game/page.tsx
Game client
- Game client
frontend/components/GameClient.tsx - Game socket
frontend/lib/useGameSocket.ts - 3D arena view
frontend/components/GameCanvas.tsx - Wristband map
frontend/components/WristbandMap.tsx
Match runtime
- Web and WS server
backend/app/main.py - Room registry
backend/app/room_registry.py - Authoritative match
backend/app/game.py
Game systems
- Shifting arena
backend/app/arena.py - Pattern engine
backend/app/patterns.py - Match stages
backend/app/stages.py - Asymmetric roles
backend/app/roles.py - Co-op puzzles
backend/app/puzzles.py - Dealer director
backend/app/nexus.py
Accounts and persistence
- Firebase auth
backend/app/auth.py - Account UI
frontend/app/login/page.tsx - Player profile
frontend/app/profile/page.tsx - Avatar service
backend/app/avatar_store.py - Match persistence
backend/app/db.py - Supabase profiles
backend/app/supabase_store.py
Other components
- Player
Connections 22
- Player → Room lobby: joins room
- Room lobby → Game page: opens match
- Game page → Game client: loads
frontend/app/game/page.tsx - Game client → Game socket: uses
frontend/components/GameClient.tsx - Game client → 3D arena view: renders
frontend/components/GameClient.tsx - Game client → Wristband map: renders
frontend/components/GameClient.tsx - Game socket → Web and WS server: sends actions
- Web and WS server → Room registry: reserves rooms
backend/app/main.py - Web and WS server → Authoritative match: routes match play
backend/app/main.py - Authoritative match → Shifting arena: uses arena
backend/app/game.py - Authoritative match → Pattern engine: uses rules
backend/app/game.py - Authoritative match → Match stages: advances stages
backend/app/game.py - Authoritative match → Asymmetric roles: filters information
backend/app/game.py - Authoritative match → Co-op puzzles: generates puzzles
backend/app/game.py - Authoritative match → Dealer director: adapts difficulty
backend/app/game.py - Player → Account UI: signs in
- Account UI → Firebase auth: authenticates
- Player → Player profile: manages profile
- Player profile → Avatar service: selects avatar
- Web and WS server → Firebase auth: verifies identity
backend/app/main.py - Web and WS server → Match persistence: persists matches
backend/app/main.py - Web and WS server → Supabase profiles: reads profiles
backend/app/main.py