How gangsonic/bug_hunters works
Bug Hunters is an educational 2D debugging game. The player starts, selects one of four cases across two worlds, observes an anomaly, records a hypothesis, chooses a repair, runs it, and sees the outcome and case record. The mission screen coordinates case simulation, state transitions, hints, and progress; the app shell routes between screens and overlays. The README also documents help/tutorial, BugDex, settings, saved progress, audio, and pilot mode. Some feature implementations were not sampled, so their internal links are omitted where source evidence is unavailable.
Main entry points: App.tsx App shell · PantallaMision.tsx Mission screen · mision Mission runtime · Seleccion.tsx Case selection
Components 18
App shell
- App shell
src/app/App.tsx - Navigation
src/app/navegacion/navegacionStore.ts
Case gameplay
- Start screen
src/features/inicio/components/Inicio.tsx - Case selection
src/features/seleccion/components/Seleccion.tsx - Mission screen
src/features/mision/components/PantallaMision.tsx - Mission runtime
src/features/mision - Case simulations
src/features/expedientes - Results
src/features/resultado - BugDex
src/features/bugdex/components/BugDex.tsx
Player support
- Help and tutorial
src/features/ayuda - Settings
src/features/configuracion - Music playback
src/features/audio - Pilot mode
src/features/piloto
Settings and state
- Saved progress
src/features/progreso/store/progresoStore.ts - Navigation state
src/app/navegacion/navegacionStore.ts
Shared interface
- Shared UI
src/shared/ui - Icon rendering
src/shared/ui/Icono.tsx
Other components
- Player
Connections 23
- Player → App shell: starts game
src/app/App.tsx - App shell → Navigation: reads route state
src/app/App.tsx - App shell → Start screen: shows screen
src/app/App.tsx - App shell → Case selection: routes to
src/app/App.tsx - App shell → Mission screen: routes to
src/app/App.tsx - App shell → Results: routes to
src/app/App.tsx - App shell → BugDex: shows screen
src/app/App.tsx - App shell → Help and tutorial: opens help
src/app/App.tsx - App shell → Settings: opens settings
src/app/App.tsx - App shell → Music playback: starts music
src/app/App.tsx - Start screen → Case selection: starts case flow
- Case selection → Mission screen: opens selected case
- Mission screen → Mission runtime: uses mission runtime
src/features/mision/components/PantallaMision.tsx - Mission screen → Case simulations: loads case
src/features/mision/components/PantallaMision.tsx - Mission runtime → Case simulations: evaluates repair
src/features/mision/hooks/useMision.ts - Mission runtime → Saved progress: marks resolved
src/features/mision/hooks/useMision.ts - Mission screen → Results: signals resolved
- Results → BugDex: opens case record
- Mission runtime → Pilot mode: records attempts
src/features/mision/hooks/useMision.ts - Help and tutorial → Case selection: offers case link
- Settings → Music playback: controls music
src/features/audio/useMusica.ts - App shell → Shared UI: renders notice
src/app/App.tsx - Shared UI → Icon rendering: uses icons
src/shared/ui/Boton.tsx