GivePedJetPack: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(New page: __NOTOC__ {{Server function}} This function is used to give a ped a jetpack. This function is not guaranteed to succeed. There are some cases where the jetpack cannot be given, for exampl...)
 
(Deprecated)
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Server function}}
This function is used to give a ped a jetpack.
{{Deprecated|setPedWearingJetpack}}


This function is not guaranteed to succeed. There are some cases where the jetpack cannot be given, for example:
This function is used to give a ped a jetpack, it won't work if the ped is in a vehicle.
* If the ped is in a vehicle
* If the ped is falling
* Probably others too.


As such, you should either expect it to fail sometimes, or repeatedly try to give a jetpack every second or so until [[doesPlayerHaveJetPack]] returns true. Alternatively, you can force the ped into a 'safe' position (e.g. standing on the ground) before giving the jetpack, or user a pickup to handle it.
As such, you should either expect it to fail sometimes, or repeatedly try to give a jetpack every second or so until [[doesPedHaveJetPack]] returns true. Alternatively, you can force the ped into a 'safe' position (e.g. standing on the ground) before giving the jetpack, or use a [[pickup]] to handle it.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">bool givePedJetPack ( ped thePed )</syntaxhighlight>
<syntaxhighlight lang="lua">bool givePedJetPack ( ped thePed )</syntaxhighlight>
{{OOP||[[ped]]:giveJetPack}}


===Required Arguments===
===Required Arguments===
Line 21: Line 20:
==Example==
==Example==
This examples adds a "jetpack" console command, which gives or removes a jetpack from the player.
This examples adds a "jetpack" console command, which gives or removes a jetpack from the player.
<syntaxhighlight lang="lua"> [lua]
<syntaxhighlight lang="lua">
-- Checks whether or not the player has a jetpack, and gives or removes it from the player
-- Checks whether or not the player has a jetpack, and gives or removes it from the player
function consoleJetPack ( thePlayer, commandName )
function consoleJetPack ( thePlayer, commandName )
Line 40: Line 39:
addCommandHandler ( "jetpack", consoleJetPack )
addCommandHandler ( "jetpack", consoleJetPack )
</syntaxhighlight>
</syntaxhighlight>
==Issues==
{{Issues|
{{Issue|9522|Setting a [[ped|ped's]] or [[player|player's]] [[setElementPosition|position]], [[setPedAnimation|animation]], or [[setElementFrozen|freezing]] them whilst occupying a jetpack will remove their jetpack, but not the jetpack sound}}
}}


==See Also==
==See Also==
{{Ped functions}}
{{Ped functions}}
[[ru:givePedJetPack]]

Revision as of 09:06, 9 November 2018

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 setPedWearingJetpack instead.


This function is used to give a ped a jetpack, it won't work if the ped is in a vehicle.

As such, you should either expect it to fail sometimes, or repeatedly try to give a jetpack every second or so until doesPedHaveJetPack returns true. Alternatively, you can force the ped into a 'safe' position (e.g. standing on the ground) before giving the jetpack, or use a pickup to handle it.

Syntax

bool givePedJetPack ( ped thePed )


OOP Syntax Help! I don't understand this!

Method: ped:giveJetPack(...)


Required Arguments

  • thePed: The ped you want to give a jetpack to.

Returns

Returns true if a jetpack was successfully given to the ped, false if it could not be given.

Example

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 )

Issues

Issue ID Description
#9522 Setting a ped's or player's position, animation, or freezing them whilst occupying a jetpack will remove their jetpack, but not the jetpack sound

See Also