WarpPlayerIntoVehicle: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 5: Line 5:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool warpPlayerIntoVehicle ( player player, vehicle vehicle, [ int seat=0 ] )           
bool warpPlayerIntoVehicle ( player thePlayer, vehicle theVehicle, [ int seat=0 ] )           
</syntaxhighlight>  
</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''player:''' The player in which you wish to force inside the vehicle
*'''thePlayer:''' The player which you wish to force inside the vehicle
*'''vehicle:''' The vehicle you wish to force the player inside
*'''theVehicle:''' The vehicle you wish to force the player into


===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}  
{{OptionalArg}}  
*'''seat:''' An integer representing the seat ID. ''0'' represents the driver, any higher represent passenger seats
*'''seat:''' An integer representing the seat ID. ''0'' represents the driver, any higher represent passenger seats.


===Returns===
===Returns===
Line 22: Line 22:
This example creates a vehicle and warps a player inside immediately
This example creates a vehicle and warps a player inside immediately
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function createstartvehicles ( playerSource, commandName, car, x, y, z ) --the function allows specification of your car, and the position
function createstartvehicles ( playerSource, commandName, car, x, y, z ) -- the function allows specification of your car, and the position
     racevehicle = createVehicle ( car, x, y, z ) --create a vehicle at a position specified by the startrace command
     local racevehicle = createVehicle ( car, x, y, z )                   -- create a vehicle at the position specified by the startrace command
     warpPlayerIntoVehicle ( playerSource, racevehicle ) --warp them straight into the vehicle
     warpPlayerIntoVehicle ( playerSource, racevehicle )                 -- warp them straight into the vehicle
end
end
addCommandHandler ( "startrace", createstartvehicles ) --add a command to start race
addCommandHandler ( "startrace", createstartvehicles )                   -- add a command to start race
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Player functions}}
{{Player functions}}

Revision as of 15:01, 21 August 2007

This function is used to warp or force a player into a vehicle. There are no animations involved when this happens.

Syntax

bool warpPlayerIntoVehicle ( player thePlayer, vehicle theVehicle, [ int seat=0 ] )          

Required Arguments

  • thePlayer: The player which you wish to force inside the vehicle
  • theVehicle: The vehicle you wish to force the player into

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • seat: An integer representing the seat ID. 0 represents the driver, any higher represent passenger seats.

Returns

Returns true if the operation is successful, false otherwise.

Example

This example creates a vehicle and warps a player inside immediately

function createstartvehicles ( playerSource, commandName, car, x, y, z ) -- the function allows specification of your car, and the position
    local racevehicle = createVehicle ( car, x, y, z )                   -- create a vehicle at the position specified by the startrace command
    warpPlayerIntoVehicle ( playerSource, racevehicle )                  -- warp them straight into the vehicle
end
addCommandHandler ( "startrace", createstartvehicles )                   -- add a command to start race

See Also