Skip to content
MTA:SA Neon Documentation

getPedTaskSequenceProgress

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Returns the zero-based child index of a ped's active native UseSequence task.

Syntax

int getPedTaskSequenceProgress(ped thePed)

GTA task mapping

ORIGINAL GTA TASK 0646
CTaskComplexUseSequence

SCM equivalent: GET_SEQUENCE_PROGRESS

This reads GTA's active UseSequence object. It is an observation, not a completion event or resource-owned sequence handle.

Arguments

thePedped

Streamed ped whose active task hierarchy should be inspected.

Returns

The current zero-based task index, or -1 when the ped is unavailable or has no active UseSequence task.

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.

OOP aliases

  • ped:getTaskSequenceProgress()

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED7346d730fRead the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf
RELATED NEON APIS

Continue exploring

Read the system guide →
setPedTaskSequence Builds and dispatches one native GTA sequence containing up to eight supported child tasks. setPedGoTo Replaces the owned ped's primary task with GTA's native go-to-and-stand-still task. setPedChatWith Starts GTA's native partner-chat task between two distinct peds.

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