Skip to content
MTA:SA Neon Documentation

isPedNativeEventProfileActive

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Reports whether this resource's native event-profile lease is active for the current authoritative ped generation.

Syntax

bool isPedNativeEventProfileActive(ped thePed, int token)

GTA task mapping

NATIVE GTA BEHAVIOR
No CTask is created

This is a generation-aware lease query, not a CTask or SCM command.

Arguments

thePedped

Script ped associated with the token.

tokenint

Resource-private profile token to check.

Returns

true only when the token belongs to this resource and ped, that profile's prerequisites still hold, this client is syncer, and the native profile is active; false otherwise.

Ownership and lifecycle

Low-level ped task calls require the client that simulates the living, streamed ped. Driving tasks also require control of the streamed vehicle. They do not create lifecycle handles; the optional native-task-runtime adds server-owned route epochs and reconstruction for drive_to routes. Gang-tag ownership is resource-exclusive, survives object streaming and recreation, and is released automatically when the owner stops.

Important behavior
  • false is expected while the ped is streamed out or another client owns synchronization; the same logical token may become active again on a later authoritative generation.

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED65c6b103cRead 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 →
setPedMissionActor Persists GTA's PED_MISSION classification on a script-created ped across native model recreation. isPedMissionActor Reports the locally persisted mission-actor policy, including while the native model is streamed out. acquirePedNativeEventProfile Exclusively leases one of Neon's stock native-event adapters for a script ped.

← Back to the Neon Lua API · How Native ped tasks and gang tags works →