How hexianweb/cubecity works
CubeCity is a Vue and Three.js city-building simulation. Players inspect the city, choose a mode, and place, relocate, upgrade, or demolish buildings; the game state tracks resources and city conditions, while the 3D scene visualizes the map. The README also documents local progress storage, RCI/ESG planning, building income, and rotating building-status indicators. UI composition and several runtime links are supported by the source index; some deeper scene and simulation connections are not shown in excerpts.
Main entry points: useGameState.js Game state · App.vue App shell · experience.js Scene runtime · handlers.js Mode handlers
Components 21
Game interface
- App shell
src/App.vue - City controls
src/components/TopBar.vue - Building catalog
src/components/BuildingSidebar.vue - Game canvas
src/components/GameCanvas.vue - Building details
src/components/BuildingDetails.vue - City dashboard
src/components/DashboardFooter.vue - Action dialogs
src/components/layers/DialogLayer.vue - Player guide
src/components/GuideModal.vue
City simulation
- Game state
src/stores/useGameState.js - Building transactions
src/hooks/useBuilding.js - Mode handlers
src/js/tools/interactor/handlers.js - Placement rules
src/js/tools/interactor/utils.js
3D runtime
- Scene runtime
src/js/experience.js - World simulation
src/js/world/world.js - Camera
src/js/camera.js - Scene resources
src/js/utils/resources.js
Game rules
- Building definitions
src/constants/constants.js - Building behavior
src/js/components/tiles/building.js - Building effects
src/js/utils/building-interaction-utils.js
Other components
- Player
- Local storage
Connections 27
- Player → App shell: plays through
README.md - App shell → City controls: renders
src/App.vue - App shell → Building catalog: renders
src/App.vue - App shell → Game canvas: renders
src/App.vue - App shell → Building details: renders
src/App.vue - App shell → City dashboard: renders
src/App.vue - App shell → Action dialogs: renders
src/App.vue - City controls → Player guide: opens
src/components/TopBar.vue - City controls → Game state: reads and updates
src/components/TopBar.vue - Building catalog → Game state: reads
src/components/BuildingSidebar.vue - Building details → Game state: reads
src/components/BuildingDetails.vue - City dashboard → Game state: reads
src/components/DashboardFooter.vue - Game canvas → Scene runtime: creates
src/components/GameCanvas.vue - Action dialogs → Building transactions: calls
src/components/layers/DialogLayer.vue - Action dialogs → Game state: signals actions
src/components/layers/DialogLayer.vue - Building transactions → Game state: updates
src/hooks/useBuilding.js - Game state → Building effects: calculates effects with
src/stores/useGameState.js - Mode handlers → Placement rules: calls placement helpers
src/js/tools/interactor/handlers.js - Mode handlers → Game state: updates tiles
src/js/tools/interactor/handlers.js - Mode handlers → World simulation: updates roads
src/js/tools/interactor/handlers.js - Placement rules → Building definitions: uses definitions
src/js/tools/interactor/utils.js - Building behavior → Building effects: checks status effects
src/js/components/tiles/building.js - Scene runtime → Game state: gets game state
src/js/experience.js - Scene runtime → World simulation: creates and updates
src/js/experience.js - Scene runtime → Camera: creates and updates
src/js/experience.js - Scene runtime → Scene resources: loads
src/js/experience.js - Game state → Local storage: persists progress
README.md