How rawprogress/fable-cities works
Fable Cities is a browser-based city-building game. The player chooses a seed or demo city, then builds roads, zones adjacent lots, and lets the simulation grow the city; the game renders the resulting terrain, buildings, traffic, weather, and audio. The graph shows the documented gameplay stages and the module-loading structure visible in the excerpts. Several subsystem internals were not sampled, so their connections are limited to registry wiring or README-documented capabilities.
Main entry points: registry.js Module registry · main.js Game bootstrap · RoadNetwork.js Road network · index.js Zoning
Components 18
Startup & world
- Start menu
src/modules/menu/index.js - Game bootstrap
src/main.js - Module registry
src/modules/registry.js - World state
src/core/World.js - Render engine
src/core/Engine.js
City construction
- Road network
src/modules/roads/RoadNetwork.js - Zoning
src/modules/zoning/index.js - Buildings
src/modules/buildings/index.js - Street props
src/modules/props/index.js
Simulation
- City simulation
src/modules/simulation/index.js - Traffic
src/modules/traffic/index.js
World presentation
- Terrain & water
src/modules/terrain/index.js - Sky & weather
src/modules/environment/index.js - Visual effects
src/modules/effects/index.js - Procedural audio
src/modules/audio/index.js
Player interface
- Build tools
src/modules/tools/index.js - HUD & interface
src/modules/ui/index.js
Other components
- Player
Connections 24
- Player → Start menu: chooses city
src/modules/menu/index.js - Start menu → Game bootstrap: sets start choice
src/main.js - Game bootstrap → Module registry: loads modules
src/main.js - Game bootstrap → World state: creates world
src/main.js - Game bootstrap → Render engine: creates engine
src/main.js - Module registry → Terrain & water: registers
src/modules/registry.js - Module registry → Sky & weather: registers
src/modules/registry.js - Module registry → Road network: registers
src/modules/registry.js - Module registry → Zoning: registers
src/modules/registry.js - Module registry → Buildings: registers
src/modules/registry.js - Module registry → Street props: registers
src/modules/registry.js - Module registry → City simulation: registers
src/modules/registry.js - Module registry → Traffic: registers
src/modules/registry.js - Module registry → Build tools: registers
src/modules/registry.js - Module registry → HUD & interface: registers
src/modules/registry.js - Module registry → Visual effects: registers
src/modules/registry.js - Module registry → Procedural audio: registers
src/modules/registry.js - Player → Build tools: draws roads
README.md - Player → Zoning: zones frontage
README.md - Player → HUD & interface: uses HUD
README.md - Road network → Zoning: frontage cells
README.md - City simulation → Buildings: grows city
- Road network → Traffic: lane graph
README.md - Render engine → Visual effects: hosts postprocessing
src/modules/effects/index.js