Skip to content
MTA:SA Neon Documentation

releasePedNativeEventProfile

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Releases one native ped event-profile token owned by the calling resource.

Syntax

bool releasePedNativeEventProfile(int token)

GTA task mapping

NATIVE GTA BEHAVIOR
No CTask is created

This changes the event adapter's lease state; it does not assign a task.

Arguments

tokenint

Token returned to this resource by acquirePedNativeEventProfile.

Returns

true when the owned token was released; false for an unknown, stale, or foreign token.

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
  • Resource shutdown revokes every surviving profile token automatically.
  • Release disables the adapter but does not cancel or migrate a response task that GTA already created.
  • For synchronized server peds, mirror the intended lease on every client so a later syncer can activate its own resource-private token.

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 →