SetPedExitVehicle

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

* FEATURE ADDED IN 1.5.9 (REVISION: r20740)
This function makes a ped exit a vehicle, similar to the enter_exit control state.
[[{{{image}}}|link=|]] Note: This function only works on synced peds and vehicles (i.e. created server-side).

Syntax

bool setPedExitVehicle ( ped thePed )

Required Arguments

  • thePed: The player or ped to exit the vehicle.

Returns

Returns true if the function was successful, false otherwise.

When this function returns true, the client will ask server for permission to exit a vehicle.

This function returns false in the following cases

  • Invalid arguments were parsed.
  • Time passed since last enter/exit for this ped is less than 1500 ms.
  • The ped is already being jacked.

Example

This example adds a command to make all synced peds exit their vehicles.

function exitPedVehicles()
	-- For all streamed-in peds
	for k,ped in ipairs(getElementsByType("ped", root, true)) do
		-- Are we syncing it and is it in a vehicle
		if isElementSyncer(ped) and isPedInVehicle(ped) then
			setPedExitVehicle(ped)
		end
	end
end
addCommandHandler("getout", exitPedVehicles)

Requirements

Minimum server version 1.5.8-9.20740
Minimum client version 1.5.8-9.20740

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.5.8-9.20740" client="1.5.8-9.20740" />

See Also

* FEATURE ADDED IN 1.5.9 (REVISION: r20935)
* FEATURE ADDED IN 1.5.9 (REVISION: r20935)
* FEATURE ADDED IN 1.5.9 (REVISION: r20740)