Skip to content
MTA:SA Neon Documentation

setPedJump

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Starts GTA's native jump, airborne, optional climb, and landing task chain on a ped simulated by this client.

Syntax

bool setPedJump(ped thePed [, bool allowClimb = true])

GTA task mapping

ORIGINAL GTA TASK
CTaskComplexJumpCTaskSimpleJumpCTaskComplexInAirAndLandCTaskSimpleLandCTaskSimpleClimb

SCM equivalent: TASK_JUMP

GTA owns the launch, airborne, optional climb, and landing chain after dispatch. The audited source does not verify a numeric SCM opcode for this mapping.

Arguments

thePedped

Living streamed ped simulated by the local player, its owning resource, or the current syncer.

allowClimbbooloptional · default true

Allow GTA to scan for a climb or vault during the jump.

Returns

true when GTA accepted the jump task; false for an invalid, dead, unstreamed, or remotely simulated ped, a missing native game object, or task-construction 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.

Important behavior
  • Commit 161dc1b7 extended the original dispatch so script peds use GTA's native climb scan.
  • The focused handoff tests cover the supported airborne and climb state, not arbitrary GTA task reconstruction.

OOP aliases

  • ped:setJump([allowClimb])

Example

if isElementStreamedIn(ped) then
    setPedJump(ped, true)
end

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDEDadb30851aRead the commit and why the change was made TEST RESOURCE native-ped-traffic test-resources/native-ped-traffic
RELATED NEON APIS

Continue exploring

Read the system guide →
setPedGoTo Replaces the owned ped's primary task with GTA's native go-to-and-stand-still task. setPedChatWith Starts GTA's native partner-chat task between two distinct peds. setPedStandStill Queues GTA's simple stand-still task on a simulated ped.

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