Skip to content
MTA:SA Neon Documentation

setPedWeaponShootingRate

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Sets GTA's persistent shooting-rate byte used by native gun tasks.

Syntax

bool setPedWeaponShootingRate(ped thePed, int rate)

GTA task mapping

NATIVE GTA BEHAVIOR 07DD
No CTask is created

SCM equivalent: SET_CHAR_SHOOT_RATE

This does not create a CTask. It writes the native shooting-rate byte later consumed by GunControl and related weapon tasks.

Arguments

thePedped

Living streamed ped simulated by this client.

rateint

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:setWeaponShootingRate(rate)

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 →