How mattsurabian/duckhunt-js works
Duck Hunt JS is a browser-based arcade game. A player starts the game in the browser; Game loads Pixi assets, coordinates levels and input, and delegates scene behavior to Stage, which manages ducks, dog animations, and the HUD. Game also owns scoring, wave progression, and win/loss outcomes. The README documents Canvas/WebGL rendering, sprite-based animation and tweening, and Howler audio; the graph includes these runtime capabilities. Source evidence is sampled, so links to unsampled level data and optional rendering details are limited to documented relationships.
Main entry points: Game.js Game controller · Stage.js Game stage · Sound.js Sound playback · Duck.js Duck flight and hit
Components 15
Game flow
- Game controller
src/modules/Game.js - Level definitions
src/data/levels.json - Level creator parsing
src/libs/levelCreator.js
Scene and actors
- Game stage
src/modules/Stage.js - Duck flight and hit
src/modules/Duck.js - Dog animations
src/modules/Dog.js - Character animation base
src/modules/Character.js
Presentation
- HUD display
src/modules/Hud.js - Sound playback
src/modules/Sound.js - Sprite assets
src/assets/images - Audio assets
src/assets/sounds - PixiJS renderer
- Howler audio
Game support
- Geometry and fullscreen
src/libs/utils.js
Other components
- Player
Connections 23
- Player → Game controller: starts
- Game controller → PixiJS renderer: loads assets
src/modules/Game.js - Game controller → Level definitions: uses levels
src/modules/Game.js - Game controller → Game stage: creates stage
src/modules/Game.js - Game controller → Level creator parsing: uses query parser
src/modules/Game.js - Game controller → HUD display: updates display
src/modules/Game.js - Game controller → Sound playback: plays effects
src/modules/Game.js - Game controller → Geometry and fullscreen: uses helpers
src/modules/Game.js - Game stage → Duck flight and hit: creates ducks
src/modules/Stage.js - Game stage → Dog animations: creates dog
src/modules/Stage.js - Game stage → HUD display: creates HUD
src/modules/Stage.js - Game stage → Geometry and fullscreen: uses geometry
src/modules/Stage.js - Duck flight and hit → Character animation base: extends
src/modules/Duck.js - Dog animations → Character animation base: extends
src/modules/Dog.js - Duck flight and hit → Geometry and fullscreen: uses geometry
src/modules/Duck.js - Duck flight and hit → Sound playback: plays effects
src/modules/Duck.js - Dog animations → Sound playback: plays effects
src/modules/Dog.js - Character animation base → PixiJS renderer: uses sprites
src/modules/Character.js - HUD display → PixiJS renderer: renders display
src/modules/Hud.js - Sound playback → Howler audio: configures playback
src/modules/Sound.js - Game controller → Sprite assets: loads spritesheet
- Sound playback → Audio assets: uses audio data
src/modules/Sound.js - Game controller → Audio assets: plays audio