Skip to content
MTA:SA Neon Documentation

setPedKillOnFoot

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Queues GTA's native on-foot kill task against another ped.

Syntax

bool setPedKillOnFoot(ped thePed, ped target)

GTA task mapping

ORIGINAL GTA TASK 05E2
CTaskComplexKillPedOnFoot

SCM equivalent: TASK_KILL_CHAR_ON_FOOT

GTA keeps control of pursuit, weapon choice, aiming, melee fallback, and vehicle handling for this indefinite combat task.

Arguments

thePedped

Living streamed ped simulated by this client.

targetped

Distinct living streamed target ped.

Returns

true when the combat task was queued; false for invalid peds, liveness, streaming, ownership, or task construction.

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:setKillOnFoot(target)

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDEDc8176de3cRead 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 →
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. getPedWeaponShootingRate Reads GTA's current shooting-rate byte from a streamed ped's native instance.

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