How zshebjtzs/tree-grow-game works
Growth Tree is a browser strategy game in which players expand tree-shaped forces across a generated region graph and resolve structural combat. The main runtime coordinates setup, turns, validated growth, combat, feedback and match results; players can also play against a worker-based AI, follow a tutorial, save games and inspect replays. The graph emphasizes these product stages and the rule, map, state and presentation layers. Connections are limited to README statements and shown source references; tutorial internals are not in the supplied tree.
Main entry points: main.js Game coordinator · AIController.js AI decisions · ReplaySaveValidator.js Save validation · MapManager.js Map generation
Components 22
Game runtime
- Game coordinator
js/main.js - Match configuration
js/app/AppState.js
Map and rules
- Map generation
js/core/MapManager.js - Growth validation
js/game/RuleEngine.js - Game state
js/game/GameState.js - Growth action
js/game/GrowthActionService.js - Combat resolution
js/game/CombatResolver.js - Match statistics
js/game/MatchTracker.js - Action history
js/game/MatchHistory.js
AI opponent
- AI worker
js/ai/AIWorker.js - AI decisions
js/ai/AIController.js - Difficulty profiles
js/ai/DifficultyProfiles.js - Position evaluation
js/ai/PositionEvaluator.js - Adversarial search
js/ai/SearchEngine.js
Player experience
- Interactive tutorial
js/tutorial - Canvas rendering
js/renderer/CanvasDrawer.js - Combat presentation
js/presentation/PresentationController.js - Sound effects
js/presentation/AudioController.js
Saves and replays
- Save encoding
js/storage/SaveCodec.js - Save validation
js/replay/ReplaySaveValidator.js - Replay session
js/replay/ReplaySession.js
Other components
- Player
Connections 26
- Player → Game coordinator: plays through
README.md - Game coordinator → Match configuration: configures match
README.md - Game coordinator → Map generation: generates map
README.md - Game coordinator → Game state: coordinates state
README.md - Game coordinator → Growth validation: checks growth
js/main.js - Game coordinator → Growth action: executes growth
js/main.js - Game coordinator → Combat resolution: resolves combat
js/main.js - Game coordinator → Match statistics: records match
README.md - Game coordinator → Action history: records actions
README.md - Growth validation → Map generation: reads adjacency
js/game/RuleEngine.js - Game coordinator → AI worker: requests AI move
README.md - AI worker → AI decisions: runs decision
js/ai/AIWorker.js - AI decisions → Difficulty profiles: uses difficulty
js/ai/AIController.js - AI decisions → Position evaluation: evaluates positions
js/ai/AIController.js - AI decisions → Adversarial search: searches moves
js/ai/AIController.js - AI decisions → Combat resolution: simulates combat
js/ai/AIController.js - Game coordinator → Canvas rendering: renders game
README.md - Game coordinator → Combat presentation: presents combat
js/main.js - Game coordinator → Sound effects: plays effects
js/main.js - Game coordinator → Interactive tutorial: offers tutorial
README.md - Game coordinator → Save encoding: encodes saves
js/main.js - Game coordinator → Save validation: validates imports
README.md - Game coordinator → Replay session: opens replays
README.md - Save validation → Map generation: rebuilds map
js/replay/ReplaySaveValidator.js - Save validation → Game state: checks state
js/replay/ReplaySaveValidator.js - Replay session → Action history: reads history
js/replay/ReplaySession.js