DoesPlayerHaveJetPack: Difference between revisions
Jump to navigation
Jump to search
m (Changed "DeprecatedWithAlt" template to "Deprecated") |
|||
(7 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
This function is used to determine whether or not a player has a jetpack. | {{Server client function}} | ||
{{Deprecated|doesPedHaveJetPack|}} | |||
This function is used to determine whether or not a player has a jetpack. Jetpacks can be given to players using the [[givePlayerJetPack]] function and removed with the [[removePlayerJetPack]] function. | |||
==Syntax== | ==Syntax== | ||
Line 12: | Line 15: | ||
==Example== | ==Example== | ||
'''Example 1:''' This examples adds a "jetpack" console command, which gives | <section name="Server" class="server" show="true"> | ||
<syntaxhighlight lang="lua"> | '''Example 1:''' This examples adds a "jetpack" console command, which gives or removes a jetpack from the player. | ||
<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 ) | ||
if ( not doesPlayerHaveJetPack ( thePlayer ) ) then --if the player doesn't have a jetpack | if ( not doesPlayerHaveJetPack ( thePlayer ) ) then -- if the player doesn't have a jetpack | ||
local status = givePlayerJetPack ( thePlayer ) --give him one | local status = givePlayerJetPack ( thePlayer ) -- give him one | ||
if ( not status ) then | if ( not status ) then | ||
outputConsole ( "Failed to give jetpack.", thePlayer )--tell him if it failed | outputConsole ( "Failed to give jetpack.", thePlayer ) -- tell him if it failed | ||
end | end | ||
else | else | ||
local status = removePlayerJetPack ( thePlayer ) --remove his jetpack | local status = removePlayerJetPack ( thePlayer ) -- remove his jetpack | ||
if ( not status ) then | if ( not status ) then | ||
outputConsole ( "Failed to remove jetpack.", thePlayer ) --tell him if it failed | outputConsole ( "Failed to remove jetpack.", thePlayer ) -- tell him if it failed | ||
end | end | ||
end | end | ||
Line 32: | Line 36: | ||
addCommandHandler ( "jetpack", consoleJetPack ) | addCommandHandler ( "jetpack", consoleJetPack ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</section> | |||
<section name="Server and client" class="both" show="true"> | |||
'''Example 2:''' This example provides a check to see if players have a jetpack when they enter a particular marker. | '''Example 2:''' This example provides a check to see if players have a jetpack when they enter a particular marker. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function onWarpMarkerHit(thePlayer, matchingDimension) | function onWarpMarkerHit(thePlayer, matchingDimension) | ||
-- check whether the player has a | -- check whether the player has a jetpack and store it in the hasJetPack flag | ||
local hasJetPack = doesPlayerHaveJetPack(thePlayer) | local hasJetPack = doesPlayerHaveJetPack(thePlayer) | ||
if (not hasJetPack) then | if (not hasJetPack) then | ||
-- warp the player to their destination | -- warp the player to their destination | ||
setElementPosition(thePlayer, | setElementPosition(thePlayer, 1337, 1337, 50) | ||
else | else | ||
-- tell the player to remove their jetpack | -- tell the player to remove their jetpack | ||
Line 47: | Line 53: | ||
end | end | ||
-- create a marker and add the function above to | -- create a marker and add the function above to its onMarkerHit event | ||
addEventHandler("onMarkerHit", createMarker( | addEventHandler("onMarkerHit", createMarker(3180, 200, 27), onWarpMarkerHit) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</section> | |||
==See Also== | ==See Also== | ||
{{Player functions}} | {{Player functions}} |
Latest revision as of 16:21, 13 February 2015
This function is deprecated. This means that its use is discouraged and that it might not exist in future versions. | |
Please use doesPedHaveJetPack instead. |
This function is used to determine whether or not a player has a jetpack. Jetpacks can be given to players using the givePlayerJetPack function and removed with the removePlayerJetPack function.
Syntax
bool doesPlayerHaveJetPack ( player thePlayer )
Required Arguments
- thePlayer: The player you are checking.
Returns
Returns true if a player has a jetpack, false otherwise.
Example
Click to collapse [-]
ServerExample 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 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 )
Click to collapse [-]
Server and clientExample 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 = doesPlayerHaveJetPack(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
- getPlayerTeam
- getPlayerBlurLevel
- setPlayerBlurLevel
- getPlayerSerial
- forcePlayerMap
- getPlayerScriptDebugLevel
- getPlayerFromName
- getPlayerMoney
- getPlayerName
- getPlayerNametagColor
- getPlayerNametagText
- getPlayerPing
- getPlayerWantedLevel
- givePlayerMoney
- isPlayerMapForced
- isPlayerNametagShowing
- setPlayerHudComponentVisible
- setPlayerMoney
- setPlayerNametagColor
- setPlayerNametagShowing
- setPlayerNametagText
- takePlayerMoney
- countPlayersInTeam
- getPlayersInTeam
- isVoiceEnabled
- setControlState
- getControlState