Suspect Traffic Role

Reference for the suspect traffic role, which marks a vehicle as a wanted suspect that police will chase. Manages the transition from watched → wanted → fleeing → arrested states.

Role Properties

Actions

Key Methods

onRoleEnded()

If the player was the target, triggers police evasion event.

onTrafficTick(tickTime)

Main logic per 0.25s tick:

• When in "wanted" state, checks pursuit.sightValue against threshold (0.25 for AI, 1.0 for player)
• If sight threshold met and speed threshold met:
  • Finds available (non-busy, non-reset) police vehicles
  • Calls gameplay_police.setPursuitMode() to start the chase
  • Targets the nearest police vehicle

onUpdate(dt, dtSim)

Currently a no-op - all logic runs in the tick handler.

Internals

State Flow

watchPolice → (police notices) → fleePolice → (caught) → arrest → (cleared) → clear

Sight & Speed Thresholds

The driveCheck flag increases the speed threshold, requiring the suspect to actually be moving before police engage.

Flee Mode Details

When fleeing:

• AI mode set to "flee"
• Aggression set to 0.8
• Aggression mode OFF (no automatic slowing)
• Drive in lane OFF, speed mode OFF
• Respawn values heavily modified (800 active radius, 40 inner radius)

Usage Example

-- Assign suspect role to a traffic vehicle
local veh = gameplay_traffic.getTrafficData()[vehId]
veh:setRole('suspect')
veh.role:setAction('watchPolice')

-- Manually trigger flee
veh.role:setAction('fleePolice')

-- Arrest the suspect
veh.role:setAction('arrest')

-- Clear suspect status
veh.role:setAction('clear')

See Also

• gameplay/traffic/roles/empty - Empty Traffic Role - Related reference
• gameplay/traffic/roles/police - Police Traffic Role - Related reference
• gameplay/traffic/roles/standard - Standard Civilian Traffic Role - Related reference
• Gameplay Systems Guide - Guide