Traffic Utilities

Reference for gameplay_traffic_trafficUtils, a collection of utility functions used by the traffic system for spawn point finding, vehicle group creation, road validation, and role loading.

Module Exports (M)

Spawn Point Finding

Vehicle Group Creation

Utilities

Module Fields

Internals

Spawn Search Strategy (findSafeSpawnPoint)

1. Route search - Generates a pathfinder route ahead of camera/player, tests points at intervals
2. Small radial search (200–1000m) - Random directions if route fails
3. Large radial search (200–2000m) - More permissive drivability
4. Emergency fallback (10000m) - Last resort, places at ground level

Spawn Point Validation

checkSpawnPoint(pos) verifies:

• Position is at least minDist (80m) from camera
• Position is at least minVehDist (15m) from all active vehicles
• Accounts for vehicle velocity (moving vehicles need larger buffer using braking distance calculation)

Lane Finalization (finalizeSpawnPoint)

Snaps a road-center position to a specific lane:

• Estimates lane count from road width (≥6.1m → 3.05m lanes, otherwise 2.2m)
• Respects one-way roads and right/left-hand drive rules
• roadDir parameter controls facing direction relative to player
• legalDirection enforces correct driving direction

Vehicle Group Params

Groups are created via core_multiSpawn.createGroup() with filters:

• Type: car (1.0), truck (0.6), optionally automation (1.0)
• Config Type: Police excluded for civilian traffic
• Country/Region: Based on level info for smart selections
• Population: Min 50 for variety, 0 for police/mods

Role Constructor Cache

getRoleConstructor() caches loaded role modules by name. Falls back to "standard" if the role file doesn't exist.

Usage Example

-- Find a safe spawn point 200m ahead
local spawnData, valid = gameplay_traffic_trafficUtils.findSafeSpawnPoint(
  core_camera.getPosition(),
  core_camera.getForward(),
  200, 800, 400
)
if valid then
  local pos, dir = gameplay_traffic_trafficUtils.finalizeSpawnPoint(
    spawnData.pos, spawnData.dir, spawnData.n1, spawnData.n2,
    {legalDirection = true, roadDir = 1}
  )
end

-- Create a group of 5 police vehicles
local policeGroup = gameplay_traffic_trafficUtils.createPoliceGroup(5)

See Also

• gameplay/traffic/baseRole - Traffic Role Base Class - Related reference
• gameplay/traffic/vehicle - Traffic Vehicle Object - Related reference
• Gameplay Systems Guide - Guide