Skip to content
San Andreas Online Docs

isPedNativeAmbientCopWanderTask

Client-side
SA:O APISynchronized NPCs and road traffic

Reports whether San Andreas Online's safe ambient-cop wander task is the ped's current primary task.

Syntax

bool isPedNativeAmbientCopWanderTask(ped thePed)

GTA task mapping

ORIGINAL GTA TASK
CTaskComplexWander

San Andreas Online reuses GTA's base Wander locomotion vtable slots with a WANDER_TYPE_COP identity and an empty scanner. Retail CTaskComplexWanderCop is never installed on an MTA ped because it reads CCopPed-only state and can enter the wanted and pursuit systems.

Arguments

thePedped

Streamed ped simulated by this client.

Returns

true only when the exact custom ambient-cop task is present in a primary slot; false otherwise.

Ownership and lifecycle

Candidate queries create nothing. A multiplayer resource must validate each proposal, create and own the real NPCs and vehicles, assign one current syncer, handle ownership changes, and clean up every element. Native AI and event tokens belong to the calling resource and are revoked when that resource stops.

Important behavior
  • The check walks every primary slot rather than only the active leaf, so a temporary native hit or avoidance response does not make it report false.
  • It distinguishes the custom ambient-cop vtable from any other task that merely shares TASK_COMPLEX_WANDER.

Example

if isPedNativeAmbientCopWanderTask(cop) then
    outputDebugString("cop is patrolling natively")
end

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED500d3cf7eRead the commit and why the change was made TEST RESOURCE native-ped-traffic test-resources/native-ped-traffic
RELATED SA:O APIS

Continue exploring

Read the system guide →
acquirePedNativeGroup Put several NPCs into one group so GTA treats them as a single walking group and manages their shared movement. releasePedNativeGroup Releases a native ambient group token owned by the calling resource. isPedNativeGroupActive Reports whether the calling resource still owns a live native ambient group.

← Back to the SA:O Lua API · How Synchronized NPCs and road traffic works →