Skip to content
MTA:SA Neon Documentation

getPedWeaponShootingRate

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Reads GTA's current shooting-rate byte from a streamed ped's native instance.

Syntax

int getPedWeaponShootingRate(ped thePed)

GTA task mapping

NATIVE GTA BEHAVIOR 07DD
No CTask is created

SCM equivalent: SET_CHAR_SHOOT_RATE

There is no separate SCM getter and no CTask is created. This reads the byte written by SET_CHAR_SHOOT_RATE and consumed by GTA fight and gun-control tasks.

Arguments

thePedped

Streamed ped with a live native GTA instance.

Returns

The current value from 0 through 255, or -1 when the ped is streamed out 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 a client-local observation, not synchronized state.
  • A later native recreation may produce a different value unless the responsible resource reapplies its intended policy.

OOP aliases

  • ped:getWeaponShootingRate()
  • ped.weaponShootingRate

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDEDf4ae35fceRead the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf
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 →