Skip to content
MTA:SA Neon Documentation

setPedWeaponAccuracy

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

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

Syntax

bool setPedWeaponAccuracy(ped thePed, int accuracy)

GTA task mapping

NATIVE GTA BEHAVIOR 02E2
No CTask is created

SCM equivalent: SET_CHAR_ACCURACY

This does not create a CTask. It writes GTA's persistent accuracy byte, which native weapon tasks use when calculating spread.

Arguments

thePedped

Living streamed ped simulated by this client.

accuracyint

Value from 0 through 255.

Returns

true when applied; false for ownership, streaming, liveness, or range failure.

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:setWeaponAccuracy(accuracy)

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDEDa9745bb5bRead the commit and why the change was made RELATED CATEGORY HARNESS native-ped-go-to-test Category-level coverage · test-resources/native-ped-go-to-test
RELATED NEON APIS

Continue exploring

Read the system guide →
setPedKillOnFoot Queues GTA's native on-foot kill task against another ped. setPedDriveBy Queues GTA's native gang drive-by task for an owned script ped already riding in an owned vehicle. setPedShootAt Replaces the owned ped's primary task with GTA's native coordinate GunControl firing task.

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