Skip to content
MTA:SA Neon Documentation

getObjectGangTagProgress

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Reads the persistent progress byte of an acquired gang tag.

Syntax

int|false getObjectGangTagProgress(object theObject)

Arguments

theObjectobject

Tag object to inspect.

Returns

The current 0–255 progress, or false when the object has no gang-tag owner.

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

  • object:getGangTagProgress()

Where this comes from

SOURCECLuaObjectDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaObjectDefs.cpp INTRODUCED / EXTENDED33b8fb453Read the commit and why the change was made TEST RESOURCE native-gang-tag-test test-resources/native-gang-tag-test
RELATED NEON APIS

Continue exploring

Read the system guide →
setObjectGangTagAlpha Sets a logical 0–255 Grove-material alpha on a streamed native gang-tag object, or clears the opt-in override. acquireObjectGangTag Gives the calling resource exclusive ownership of a supported tag object and registers it with GTA's native spray path. setObjectGangTagProgress Applies an authoritative 0–255 progress byte to a gang tag owned by the calling resource.

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