NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Applies an authoritative 0–255 progress byte to a gang tag owned by the calling resource.

Syntax

Copy signature

bool setObjectGangTagProgress(object theObject, int progress)

Arguments

theObjectobject

Tag object currently owned by the calling resource.

progressint

Authoritative progress from 0 through 255.

Returns

true when the owned tag was updated; false for invalid progress or ownership.

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

• Use this to mirror server-validated client spray reports.

OOP aliases

• object:setGangTagProgress(progress)

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. getObjectGangTagProgress Reads the persistent progress byte of an acquired gang tag.

← Previous in categoryacquireObjectGangTag Next in category →getObjectGangTagProgress

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