SA:O EXTENSIONNative ped tasks and gang tags

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.

Syntax

Copy signature

bool setPedEnterVehicle(ped thePed [, vehicle theVehicle, bool|int passengerOrSeat])

GTA task mapping

ORIGINAL GTA TASK 05CA / 05CB

CTaskComplexEnterCarAsDriverCTaskComplexEnterCarAsPassenger

SCM equivalent: TASK_ENTER_CAR_AS_PASSENGER / TASK_ENTER_CAR_AS_DRIVER

The selected seat decides which direct GTA task the syncer creates after MTA's server confirmation. Unlike SCM 05CA/05CB, this API keeps MTA's authoritative request lifecycle and does not use the opcode-specific timed wrapper.

Arguments

thePedped

Ped requesting entry.

theVehiclevehicleoptional

Target vehicle; the established MTA inference remains available.

passengerOrSeatbool|intoptional

Passenger flag or explicit MTA seat. Seat 0 is driver; seat 1 is the first passenger/SCM passenger index 0.

Returns

true when the authoritative 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:setEnterVehicle(vehicle, passengerOrSeat)

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-enter-car-test test-resources/native-ped-enter-car-test

RELATED SA:O APIS

Continue exploring

Read the system guide →

setPedExitVehicle Tell an NPC to leave its vehicle and GTA performs the original exit movement, animation, and door handling. 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.

← Previous in categorystopPedFacialTalk Next in category →setPedExitVehicle

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