IsPedInVehicle: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Server and client now.)
(Changed note to explain differences in client/server version)
 
(9 intermediate revisions by 5 users not shown)
Line 3: Line 3:


Checks whether or not a given ped is currently in a vehicle.
Checks whether or not a given ped is currently in a vehicle.
{{Note|1=Client side [[IsPedInVehicle]] only returns ''true'' if the ped is physically inside a vehicle. To check if the ped is entering or exiting a vehicle, use: <code>[[getPedOccupiedVehicle]](ped) ~= false</code> }}
{{Note|1=Server side [[IsPedInVehicle]] returns whether the ped is entering, inside or exiting a vehicle. }}


==Syntax==
==Syntax==
Line 8: Line 10:
bool isPedInVehicle ( ped thePed )
bool isPedInVehicle ( ped thePed )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ped]]:isInVehicle|inVehicle}}


===Required Arguments===
===Required Arguments===
Line 22: Line 25:
function outputIsInVehicle ( sourcePlayer, commandName, checkedPlayerName )
function outputIsInVehicle ( sourcePlayer, commandName, checkedPlayerName )
-- we get the player element from the nick specified
-- we get the player element from the nick specified
local checkedPlayer = getPlayerFromNick ( checkedPlayerName )
local checkedPlayer = getPlayerFromName ( checkedPlayerName )
-- if there exists a player with that nick
-- if there exists a player with that nick
if ( checkedPlayer ) then
if ( checkedPlayer ) then

Latest revision as of 20:49, 11 April 2021

Checks whether or not a given ped is currently in a vehicle.

[[{{{image}}}|link=|]] Note: Client side IsPedInVehicle only returns true if the ped is physically inside a vehicle. To check if the ped is entering or exiting a vehicle, use: getPedOccupiedVehicle(ped) ~= false
[[{{{image}}}|link=|]] Note: Server side IsPedInVehicle returns whether the ped is entering, inside or exiting a vehicle.

Syntax

bool isPedInVehicle ( ped thePed )

OOP Syntax Help! I don't understand this!

Method: ped:isInVehicle(...)
Variable: .inVehicle


Required Arguments

  • thePed: the ped you want to check.

Returns

Returns true if the ped is in a vehicle, false if he is on foot or an invalid element was passed.

Example

This code defines an isinvehicle command which tells a player whether another player is in a vehicle or not.

-- we create our handler function, where sourcePlayer is the player who sent the command,
-- and checkedPlayerName is the player name specified.
function outputIsInVehicle ( sourcePlayer, commandName, checkedPlayerName )
	-- we get the player element from the nick specified
	local checkedPlayer = getPlayerFromName ( checkedPlayerName )
	-- if there exists a player with that nick
	if ( checkedPlayer ) then
		-- if he's in a vehicle,
		if isPedInVehicle ( checkedPlayer ) then
			-- tell the source player
			outputChatBox ( checkedPlayerName .. " is in a vehicle.", sourcePlayer )
		-- if he's not in a vehicle,
		else
			-- tell the source player
			outputChatBox ( checkedPlayerName .. " is not in a vehicle.", sourcePlayer )
		end
	-- if it doesn't exist,
	else
		-- tell the source player
		outputChatBox ( "Invalid player name.", sourcePlayer )
	end
end

-- define a handler for the isinvehicle command
addCommandHandler ( "isinvehicle", outputIsInVehicle )

See Also