Skip to content
San Andreas Online Docs

setPedExitVehicle

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

Tell an NPC to leave its vehicle and GTA performs the original exit movement, animation, and door handling.

Syntax

bool setPedExitVehicle(ped thePed)

GTA task mapping

ORIGINAL GTA TASK 05CD
CTaskComplexLeaveCar

SCM equivalent: TASK_LEAVE_CAR

The syncer constructs GTA's leave-car task only after the established MTA vehicle request is accepted; true does not mean the ped is already outside.

Arguments

thePedped

Ped requesting exit.

Returns

true when the authoritative exit request was accepted; false otherwise.

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:setExitVehicle()

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDEDc85759f0aRead the commit and why the change was made TEST RESOURCE native-ped-leave-car-test test-resources/native-ped-leave-car-test
RELATED SA:O APIS

Continue exploring

Read the system guide →
setPedEnterVehicle Tell an NPC which vehicle and seat to enter. GTA makes it approach the vehicle, use the correct door, and get in as driver or passenger. setPedDriveWander Put an NPC behind the wheel and tell it to cruise. GTA's original driving AI takes over: it follows the native road network, chooses streets, steers, accelerates, brakes, and reacts to traffic according to the driving style. setPedDriveTo Give an NPC driver a destination and GTA's original driving AI takes over: it follows the native road network, chooses a route, steers, accelerates, and brakes as it drives toward the target.

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