How spinjitsu12/scout works
SCOUT is an offline-first, first-person scout simulator. The player creates or selects a career, completes an opening story, explores and drives through a town, visits venues, meets people, and advances a career through scouting choices. The renderer coordinates gameplay and career state; the game domain models progression and field state, while world modules provide the 3D environment. Electron supplies native saves, display controls, and update checks. Some subsystem links rely on README descriptions or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: App.tsx Game coordinator · game.ts Career rules · ImmersiveWorld.tsx First-person world · desktop.ts Desktop bridge
Components 23
Game experience
- Game coordinator
src/App.tsx - Career setup
src/components/game/CareerSetup.tsx - Opening story
src/components/game/Prologue.tsx - Town exploration
src/components/game/RoadWorld.tsx - First-person world
src/components/game/ImmersiveWorld.tsx - Gameplay panels
src/components/game/GameplayPanels.tsx - Game settings
src/components/game/ImmersiveSettings.tsx - Update panel
src/components/game/UpdatePanel.tsx
World simulation
- World layout
src/lib/immersive-world.ts - World assets
src/lib/immersive-assets.ts - Driving model
src/lib/driving.ts - Driving camera
src/components/game/driving-camera.ts
Career and sound
- Career rules
src/lib/game.ts - Field state
src/lib/expedition.ts - Immersion state
src/lib/immersive-runtime.ts - Audio system
src/lib/audio.ts
Desktop services
- Desktop bridge
src/lib/desktop.ts - Electron main
electron/main.cjs - Save slots
electron/save-store.cjs - Career files
- Update manager
electron/update-manager.cjs
Other components
- Player
- Update service
Connections 30
- Player → Game coordinator: starts game
README.md - Game coordinator → Career setup: opens setup
src/App.tsx - Game coordinator → Opening story: shows story
src/App.tsx - Game coordinator → Town exploration: opens town
src/App.tsx - Game coordinator → First-person world: opens world
src/App.tsx - Game coordinator → Gameplay panels: shows panels
src/App.tsx - Game coordinator → Game settings: opens settings
src/App.tsx - Game coordinator → Update panel: shows updates
src/App.tsx - Game coordinator → Career rules: validates career
src/App.tsx - Career setup → Desktop bridge: uses desktop
src/components/game/CareerSetup.tsx - Opening story → Career rules: advances story
- Town exploration → Driving model: uses driving model
src/components/game/RoadWorld.tsx - Town exploration → Driving camera: renders driving view
src/components/game/RoadWorld.tsx - First-person world → Immersion state: updates snapshots
src/components/game/ImmersiveWorld.tsx - First-person world → Career rules: dispatches actions
src/components/game/ImmersiveWorld.tsx - First-person world → World layout: gets locations
src/components/game/ImmersiveWorld.tsx - World layout → World assets: uses assets
src/lib/immersive-world.ts - Career rules → Field state: uses field rules
src/lib/game.ts - Career rules → Immersion state: creates immersion
src/lib/game.ts - Gameplay panels → Career rules: reads career state
src/components/game/GameplayPanels.tsx - Game settings → Audio system: configures sound
src/components/game/ImmersiveSettings.tsx - Game settings → Desktop bridge: configures display
src/components/game/ImmersiveSettings.tsx - First-person world → Audio system: plays world audio
src/components/game/ImmersiveWorld.tsx - Game coordinator → Desktop bridge: lists and saves
src/App.tsx - Desktop bridge → Electron main: calls native bridge
- Electron main → Save slots: handles career saves
electron/main.cjs - Save slots → Career files: reads and writes
electron/save-store.cjs - Electron main → Update manager: initializes updates
electron/main.cjs - Update manager → Update service: checks and downloads
- Update panel → Desktop bridge: requests update status
src/components/game/UpdatePanel.tsx