SA:O APISynchronized NPCs and road traffic

Runs GTA's ped-only zone-model residency pass around an origin without enabling unmanaged population creation.

Syntax

Copy signature

bool updateAmbientPedPopulationModels(Vector3 origin)

Arguments

originVector3

Finite world position whose native population zone should be kept current.

Returns

true after the native residency pass runs; argument validation reports an error for an invalid vector.

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

• Call this while candidate generation is active, normally from onClientPreRender as the reference resource does.
• The pass can retain up to eight stock population models and creates no ped. Call resetAmbientPedPopulationModels when generation stops.

Where this comes from

SOURCECLuaWorldDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaWorldDefs.cpp INTRODUCED / EXTENDEDb159bcd0cRead 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 →

resetAmbientPedPopulationModels Releases the stock population-model residency established by the ambient-ped update pass. addPedNativeGunAimedAtEvent Inserts GTA's real aimed-at event on the authoritative ambient-ped owner. addPedNativeDamageResponseEvent Replays GTA's civilian damage decision on the authoritative owner without applying physical damage again.

Next in category →resetAmbientPedPopulationModels

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