Skip to content
MTA:SA Neon Documentation

updateAmbientPedPopulationModels

Client-side
NEON APISynchronized ambient pedestrians

Available in Neon, not standard MTA

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

Syntax

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

The model-residency pass retains GTA's eight stock zone-ped slots until reset or game teardown. Candidate queries create no element; a multiplayer resource must validate proposals, create and own peds, assign one syncer, advance owner epochs, and clean up every element. Native-event tokens belong to the calling resource, activate only on the current syncer, and are revoked on resource shutdown.

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 NEON APIS

Continue exploring

Read the system guide →
getAmbientPedSpawnCandidate Asks GTA's native civilian and path rules for one read-only ambient-ped proposal. 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.

← Back to the Neon Lua API · How Synchronized ambient pedestrians works →