Skip to content
San Andreas Online Docs

setPedShootAt

Client-side
SA:O APINative ped tasks and gang tags

Give an NPC a world position and GTA makes it aim and fire controlled bursts at that point for the requested duration.

Syntax

bool setPedShootAt(ped thePed, Vector3 target [, int duration = 1000, int burstLength = 5])

GTA task mapping

ORIGINAL GTA TASK 0668
CTaskSimpleGunControl

SCM equivalent: TASK_SHOOT_AT_COORD

GunControl receives the coordinate and FIREBURST command directly, then creates its own CTaskSimpleUseGun attack subtask. Negative durations remain indefinite.

Arguments

thePedped

Living streamed ped simulated by this client.

targetVector3

Finite target; an XY value of 0,0 is rejected because GTA treats it as no coordinate.

durationintoptional · default 1000

Milliseconds; every negative value is indefinite.

burstLengthintoptional · default 5

Positive native burst size.

Returns

true when the native task was installed; false for failed ownership, liveness, target, or burst validation.

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:setShootAt(target, duration, burstLength)

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 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. getPedWeaponShootingRate Reads GTA's current shooting-rate byte from a streamed ped's native instance.

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