SA:O APISynchronized NPCs and road traffic

Runs GTA's camera-frustum sphere test without creating an entity.

Syntax

Copy signature

bool isAmbientPedSphereVisible(Vector3 position, float radius)

Arguments

positionVector3

Sphere center.

radiusfloat

Sphere radius.

Returns

true when the sphere is visible to the current GTA camera; 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 reference population resource uses this as one input to a multi-client spawn veto.

Where this comes from

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

updateAmbientPedPopulationModels Runs GTA's ped-only zone-model residency pass around an origin without enabling unmanaged population creation. 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.

← Previous in categorysetAmbientPedPopulationZoneState Next in category →getAmbientPedGangGroupCandidate

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