Skip to content
MTA:SA Neon Documentation

acquireObjectGangTag

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Gives the calling resource exclusive ownership of a supported tag object and registers it with GTA's native spray path.

Syntax

bool acquireObjectGangTag(object theObject [, int progress = 0])

Arguments

theObjectobject

Tag object using model 1490 or 1524 through 1531.

progressintoptional · default 0

Initial Grove-material progress from 0 through 255.

Returns

true when ownership was acquired or refreshed by the same resource; false for an unsupported object, invalid progress, or another 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.

Important behavior
  • Ownership and progress survive stream-out and native object recreation.
  • GTA advances progress in its original 8-alpha spray steps.

OOP aliases

  • object:acquireGangTag(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. setObjectGangTagProgress Applies an authoritative 0–255 progress byte to a gang tag owned by the calling resource. getObjectGangTagProgress Reads the persistent progress byte of an acquired gang tag.

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