Vehicle Fleet

Tier Stat Multipliers

TypeScript Schema

export type VehicleRole =
  | 'building_destroyer'
  | 'debris_hauler'
  | 'drill_rig'
  | 'rock_digger'
  | 'rock_fragmenter';

export type VehicleTier = 1 | 2 | 3;

export interface VehicleDef {
  role: VehicleRole;
  tier: VehicleTier;
  nameKey: string;               // i18n key, e.g. 'vehicle.debris_hauler.tier1'
  purchaseCost: number;
  maintenanceCostPerTick: number;
  speed: number;                 // cells/tick
  capacity: number;              // kg for hauler, m³ for digger, etc.
  workRate: number;              // voxels/tick, kg/tick, etc. (role-specific)
  maxHp: number;
}

export interface Vehicle {
  id: number;
  role: VehicleRole;
  tier: VehicleTier;
  x: number;
  z: number;
  hp: number;
  driverId: number | null;       // Employee ID of driver; null = uncrewed
  state: VehicleState;
  targetX: number | null;
  targetZ: number | null;
  payloadKg: number;             // Debris Hauler only
}

export type VehicleState =
  | 'idle'      // parked, no task
  | 'moving'    // travelling to target
  | 'working'   // drilling, digging, hauling, demolishing, or fragmenting
  | 'waiting'   // blocked by traffic; retries each tick
  | 'broken';   // requires repair at Vehicle Depot

Driver Qualification

• Each vehicle role requires a distinct driving licence from the Driving Center
• Employee without the licence for a role cannot be assigned to that vehicle
• One driver per vehicle; one vehicle per driver at a time
• If driver is injured or leaves → vehicle becomes idle until qualified replacement assigned

Traffic & Routing

Vehicles use shared navmesh (Ch.6) with A* pathfinding. Congestion is gameplay-relevant:

• Vehicles cannot share a cell. Blocked vehicle → 'waiting' state, retries each tick
• Long waiting chains (≥ 3 vehicles on same path for ≥ 10 ticks) → TrafficJamEvent alert
• Rock debris after blast immediately marks cells as blocked until cleared
• Destroyed building collapses into debris cell → blocks navmesh until removed

Player solutions to congestion: widen ramps, build parallel haulage routes, relocate Freight Warehouse, clear debris with Rock Fragmenters before hauling.

Vehicle Tasks

Atomic Task Breakdown