How therealpaulplay/openguessr works
OpenGuessr is a geography-guessing game and web application. A player enters through the game menu, chooses a map or mode, plays rounds using Street View locations, and sees a result; the README identifies a separate location-generation server and Google Maps Street View. The repository also includes multiplayer, community maps, competitions, accounts, and a shop. The graph preserves these documented capabilities, but several links are necessarily high-level: sampled source does not expose the gameplay route’s full runtime wiring or backend calls.
Main entry points: MapPage.svelte Map page · MainMenu.svelte Game menu · multiplayerLogic.js Multiplayer runtime · +page.svelte Game route
Components 25
Entry and navigation
- Game menu
src/lib/components/MainMenu.svelte - Game route
src/routes/(game)/+page.svelte - Game layout
src/routes/(game)/+layout.svelte
Guessing gameplay
- Map page
src/lib/components/MapPage.svelte - Map display
src/lib/components/Map.svelte - Street View
src/lib/components/Panorama.svelte - Location generation
- Round results
src/lib/components/ResultScreen.svelte - Result calculations
src/lib/logic/resultScoreLogic.js
Multiplayer
- Multiplayer pages
src/routes/(game)/(menu)/multiplayer/+page.svelte - Multiplayer runtime
src/lib/logic/multiplayerLogic.js - Matchmaking
src/lib/logic/matchmakingLogic.js - Match state
src/lib/stores/context-specific/multiplayerStore.js
Maps and competitions
- Map browsing
src/routes/(game)/(menu)/maps/+page.svelte - Map creation
src/routes/(game)/(menu)/maps/create/+page.svelte - Competitions
src/routes/(game)/(menu)/competitions/+page.svelte
Accounts and commerce
- Account state
src/lib/stores/accountStore.js - Signup flow
src/routes/(other)/signup/+page.svelte - Shop
src/routes/(game)/(menu)/shop/+page.svelte - Purchase operations
src/lib/utils/shopHelper.js
Other components
- Player
- Account backend
- Location server
- Google Maps
- PlaySocket
Connections 25
- Player → Game menu: opens
- Game menu → Game route: starts game
- Game route → Map page: renders
- Map page → Map display: displays map
- Map page → Street View: shows panorama
- Location server → Location generation: provides locations
README.md - Location generation → Map page: supplies locations
README.md - Google Maps → Street View: powers Street View
README.md - Map page → Round results: shows round result
- Round results → Result calculations: uses scoring
- Player → Multiplayer pages: opens multiplayer
- Multiplayer pages → Multiplayer runtime: runs matches
- Multiplayer runtime → Matchmaking: uses matchmaking
- Multiplayer runtime → Match state: updates state
- PlaySocket → Multiplayer runtime: supports multiplayer
README.md - Player → Map browsing: browses maps
- Player → Map creation: creates maps
- Player → Competitions: joins competitions
- Game menu → Account state: reads login state
src/lib/components/MainMenu.svelte - Game menu → Signup flow: prompts signup
src/lib/components/MainMenu.svelte - Player → Shop: browses shop
- Shop → Purchase operations: handles purchases
- Purchase operations → Account backend: requests purchases
src/lib/utils/shopHelper.js - Signup flow → Account backend: authenticates
README.md - Game route → Game layout: uses layout