DoesPedHaveJetPack

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use isPedWearingJetpack instead.


Checks whether or not a ped currently has a jetpack.

Syntax

bool doesPedHaveJetPack ( ped thePed )


OOP Syntax Help! I don't understand this!

Method: ped:doesHaveJetpack(...)


Required Arguments

  • thePed: the ped you want to check

Returns

Returns true if the ped is carrying a jetpack, false if he is not or an invalid element was passed.

Example

Click to collapse [-]
Server

Example 1: This examples adds a "jetpack" console command, which gives or removes a jetpack from the player.

-- Checks whether or not the player has a jetpack, and gives or removes it from the player
function consoleJetPack ( thePlayer, commandName )
   if ( not doesPedHaveJetPack ( thePlayer ) ) then            -- if the player doesn't have a jetpack
      local status = givePedJetPack ( thePlayer )              -- give him one
      if ( not status ) then
         outputConsole ( "Failed to give jetpack.", thePlayer )   -- tell him if it failed
      end
   else
      local status = removePedJetPack ( thePlayer )            -- remove his jetpack
      if ( not status ) then
         outputConsole ( "Failed to remove jetpack.", thePlayer ) -- tell him if it failed
      end
   end
end

-- add the function above to handle the "jetpack" command
addCommandHandler ( "jetpack", consoleJetPack )
Click to collapse [-]
Server

Example 2: This example provides a check to see if players have a jetpack when they enter a particular marker.

function onWarpMarkerHit ( thePlayer, matchingDimension )
   -- check whether the player has a jetpack and store it in the hasJetPack flag
   local hasJetPack = doesPedHaveJetPack ( thePlayer )
   if ( not hasJetPack ) then
      -- warp the player to their destination
      setElementPosition ( thePlayer, 1337, 1337, 50 )
   else
      -- tell the player to remove their jetpack
      outputChatBox ( "You must remove your jetpack to use this marker!", thePlayer )
   end
end

-- create a marker and add the function above to its onMarkerHit event
addEventHandler ( "onMarkerHit", createMarker(3180, 200, 27), onWarpMarkerHit )

See Also