SA:O APINative ped tasks and gang tags

Reads GTA's persistent 0-255 weapon-accuracy byte used for shot spread.

Syntax

Copy signature

int getPedWeaponAccuracy(ped thePed)

GTA task mapping

NATIVE GTA BEHAVIOR

No CTask is created

This does not create a CTask. It reads the same persistent accuracy byte that native weapon tasks use when calculating spread.

Arguments

thePedped

Streamed ped.

Returns

The current accuracy from 0 through 255, or -1 when the ped is not streamed in or has no native instance.

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

• This is the read counterpart to setPedWeaponAccuracy.
• -1 means unknown, not zero accuracy.

OOP aliases

• ped:getWeaponAccuracy()

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED5318f4360Read the commit and why the change was made TEST RESOURCE native-ai-test-harness test-resources/native-ai-test-harness

RELATED SA:O APIS

Continue exploring

Read the system guide →

setPedKillOnFoot Give an NPC a target and GTA's combat AI takes over: it follows them, chooses between guns and melee, aims, attacks, and reacts to nearby vehicles. setPedDriveBy Give a passenger a target and GTA makes them turn, aim, animate, and fire from the vehicle using its built-in drive-by behavior. setPedShootAt Give an NPC a world position and GTA makes it aim and fire controlled bursts at that point for the requested duration.

← Previous in categoryisPedOnlyDamagedByPlayer

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