How msm691/epitopia works
Epitopia is a browser-based multiplayer 4X strategy game. Players browse or create lobbies, join a match, then explore a generated map and submit turn-based actions; the server synchronizes game state to clients. The graph includes the documented strategy systems and the sampled engine, shared protocol, and 3D client layers. Several server-to-engine and UI-to-renderer connections are not shown in the excerpts or reference index, so they are omitted or marked unverified.
Main entry points: applyAction.ts Action resolution · gameServer.ts Game server · net.ts Socket client · protocol.ts Socket protocol
Components 31
Browser client
- App shell
client/src/App.tsx - Socket client
client/src/net.ts - Lobby browser
client/src/LobbyBrowser.tsx - Game interface
client/src/GameView.tsx - Chat
client/src/Chat.tsx - Map preview
client/src/MapPreview.tsx - 3D scene
client/src/three/Scene3D.tsx - Terrain renderer
client/src/three/Terrain.tsx - Building renderer
client/src/three/Buildings.tsx - Effects renderer
client/src/three/Effects.tsx - Unit renderer
client/src/three/Units.tsx - 3D models
client/src/three/models.ts - Map projection
client/src/three/projection.ts - Audio
client/src/audio.ts
Game engine
- Initial game state
engine/src/state.ts - Map generation
engine/src/generateMap.ts - Action resolution
engine/src/applyAction.ts - Action validation
engine/src/isLegal.ts - AI decisions
engine/src/ai.ts - Combat rules
engine/src/combat.ts - Economy rules
engine/src/economy.ts - Technology rules
engine/src/tech.ts - Pathfinding
engine/src/pathfinding.ts - Sage encounters
engine/src/sages.ts - Victory rules
engine/src/victory.ts - Seeded randomness
engine/src/rng.ts
Shared contracts
- Socket protocol
shared/src/protocol.ts - Game actions
shared/src/actions.ts - Game data types
shared/src/types.ts
Multiplayer server
- Game server
server/src/gameServer.ts
Other components
- Player
Connections 30
- Player → App shell: plays in
- App shell → Socket client: uses
client/src/App.tsx - Player → Lobby browser: browses lobbies
- Player → Game interface: plays match
- Game interface → Audio: plays audio
client/src/GameView.tsx - Socket client → Game server: sends socket events
- Game server → Socket client: synchronizes state
- Game server → Socket protocol: uses event contract
- Socket client → Socket protocol: uses event contract
- Socket protocol → Game actions: defines action events
shared/src/protocol.ts - Socket protocol → Game data types: defines state payloads
shared/src/protocol.ts - Game actions → Game data types: uses data types
shared/src/actions.ts - Game server → Action resolution: routes actions · Inferred; not shown in the code that was read.
- Initial game state → Map generation: generates map
engine/src/state.ts - Initial game state → Economy rules: computes starting income
engine/src/state.ts - Map generation → Seeded randomness: seeds generation
engine/src/generateMap.ts - Action resolution → Action validation: validates action
engine/src/applyAction.ts - Action resolution → Economy rules: computes income
engine/src/applyAction.ts - Action resolution → Technology rules: resolves research
engine/src/applyAction.ts - Action resolution → Sage encounters: resolves encounter
engine/src/applyAction.ts - AI decisions → Action validation: checks legality
engine/src/ai.ts - AI decisions → Combat rules: scores attacks
engine/src/ai.ts - AI decisions → Technology rules: checks unlocks
engine/src/ai.ts - Economy rules → Pathfinding: checks trade routes
engine/src/economy.ts - 3D scene → Map projection: uses projection
client/src/three/Scene3D.tsx - Terrain renderer → Map projection: projects tiles
client/src/three/Terrain.tsx - Building renderer → Map projection: projects buildings
client/src/three/Buildings.tsx - Building renderer → 3D models: uses models
client/src/three/Buildings.tsx - Effects renderer → Map projection: projects effects
client/src/three/Effects.tsx - Unit renderer → 3D models: uses models
client/src/three/Units.tsx