Harbor Heat

An arcade-realist 3D chase sandbox with two parallel tracks:

• a browser build powered by Babylon.js + Vite
• a native migration prototype in Godot 4

The project combines on-foot exploration, car stealing, AI traffic, pedestrians, cash pickups, a wanted system, and police pursuit inside a procedurally generated city district with a golden-hour presentation pass, new district landmarks, and a more readable pursuit HUD.

UI copy for the HUD and overlay lives in src/game/config.js, so in-game text can be tuned without touching the render loop or gameplay systems.

Run locally

npm install
npm run dev

Default dev URL:

http://localhost:5173

Godot Prototype

A parallel Godot prototype is available in godot/ as a migration track from the browser build.

Current Godot milestone:

• procedural city blockout with darker road/surface separation
• native third-person camera with on-foot and driving follow modes
• playable on-foot movement, car entry/exit, traffic, pedestrians, pickups, wanted level, and police spawning
• upgraded stylized city presentation, lighting, and HUD for the migration track

Run in Godot Editor

1. Install Godot 4.x (recommended: latest stable 4.x).
2. Open Godot Project Manager.
3. Click Import and select godot/project.godot.
4. Open the project and press F5 (or click Run Project).

Main scene is already configured as:

res://scenes/Main.tscn

Run from terminal

Fastest option from the repo root:

./run-godot.sh

You can also point it at a custom Godot binary:

GODOT_BIN="/path/to/Godot" ./run-godot.sh

If you have Godot binary in PATH:

godot4 --path godot

or (on systems where binary is named godot):

godot --path godot

If the CLI is not installed yet, import godot/project.godot through the Godot Project Manager first. The repository does not bundle the engine binary.

Current Godot controls mirror the web version:

• WASD or arrow keys: move on foot / drive
• Shift: sprint on foot
• E: enter or exit a car
• left mouse click or F: shoot (on foot)
• Space: handbrake
• R: reset active entity (and recover after game over)
• mouse drag: rotate camera
• mouse wheel: zoom camera

Build

npm run build

Test

npm run test

Controls

• WASD or arrow keys: move on foot / drive
• Shift: sprint on foot
• E: enter or exit a car
• left mouse click or F: shoot (on foot)
• Space: handbrake
• R: reset player or active vehicle position
• mouse drag: rotate camera
• mouse wheel: zoom camera

Audio starts after pressing the start button (browser autoplay policy).

Current gameplay

• third-person camera for both on-foot and driving modes
• procedural city layout with layered arcade-realist rendering
• district landmarks including a plaza, gas station, parking lot, and construction site
• on-foot movement and vehicle hijacking
• AI traffic with occasional junction hesitation for less deterministic street flow
• pedestrians walking on sidewalks
• cash pickups around the district
• wanted level with contact/search/cooling pursuit phases and more aggressive police spawns
• weapon combat with projectile fire (player and hostile NPCs)
• sharper low-speed driving, tighter high-speed steering, and stuck recovery
• oriented vehicle collisions with short hit reaction feedback
• basic collisions, damage, and game over state
• start overlay with in-game HUD telemetry, pursuit scan, and run/event progress meters