GivePlayerJetPack: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
m (Visual improvement)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Deprecated|givePedJetPack}}
This function is used to give a player a jetpack.
This function is used to give a player a jetpack.
Note: The player must be on-foot.
 
This function is not guaranteed to succeed. There are some cases where the jetpack cannot be given, for example:
* If the player is in a vehicle
* If the player 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 player into a 'safe' position (e.g. standing on the ground) before giving the jetpack, or user a pickup to handle it.


==Syntax==
==Syntax==
Line 7: Line 16:


===Required Arguments===
===Required Arguments===
*'''player''': The [[player]] you want to give a jetpack to.
*'''thePlayer:''' The [[player]] you want to give a jetpack to.


===Returns===
===Returns===
Returns 'true' if the player was on-foot and didn't already have a jetpack, 'false' otherwise.
Returns ''true'' if a jetpack was successfully given to the player, ''false'' if it could not be given.


==Example==
==Example==
<syntaxhighlight lang="lua">
This examples adds a "jetpack" console command, which gives or removes a jetpack from the player.
addCommandHandler ( "jetpack", "jetPackCommand" )
<syntaxhighlight lang="lua"> [lua]
function jetPackCommand ( source, key )
-- Checks whether or not the player has a jetpack, and gives or removes it from the player
  if ( doesPlayerHaveJetPack ( source ) ) then -- if he has a jetpack
function consoleJetPack ( thePlayer, commandName )
    removePlayerJetPack ( source ) -- remove it
  if ( not doesPlayerHaveJetPack ( thePlayer ) ) then           -- if the player doesn't have a jetpack
  else
      local status = givePlayerJetPack ( thePlayer )              -- give him one
    givePlayerJetPack ( source ) -- give him one
      if ( not status ) then
  end
        outputConsole ( "Failed to give jetpack.", thePlayer )  -- tell him if it failed
      end
  else
      local status = removePlayerJetPack ( thePlayer )           -- remove his jetpack
      if ( not status ) then
        outputConsole ( "Failed to remove jetpack.", thePlayer ) -- tell him if it failed
      end
  end
end
end
-- add the function above to handle the "jetpack" command
addCommandHandler ( "jetpack", consoleJetPack )
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 11:34, 26 June 2014

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


This function is used to give a player a jetpack.

This function is not guaranteed to succeed. There are some cases where the jetpack cannot be given, for example:

  • If the player is in a vehicle
  • If the player 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 player into a 'safe' position (e.g. standing on the ground) before giving the jetpack, or user a pickup to handle it.

Syntax

bool givePlayerJetPack ( player thePlayer )

Required Arguments

  • thePlayer: The player you want to give a jetpack to.

Returns

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

Example

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

 [lua]
-- Checks whether or not the player has a jetpack, and gives or removes it from the player
function consoleJetPack ( thePlayer, commandName )
   if ( not doesPlayerHaveJetPack ( thePlayer ) ) then            -- if the player doesn't have a jetpack
      local status = givePlayerJetPack ( thePlayer )              -- give him one
      if ( not status ) then
         outputConsole ( "Failed to give jetpack.", thePlayer )   -- tell him if it failed
      end
   else
      local status = removePlayerJetPack ( 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 )

See Also