GivePlayerJetPack - Revision history

IManGaaX at 07:40, 19 April 2025

2025-04-19T07:40:11Z

← Older revision		Revision as of 07:40, 19 April 2025
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server function}}		{{Server function}}
	{{Deprecated\|~~givePedJetPack~~}}		{{Deprecated\|setPedWearingJetpack}}

	This function is used to give a player a jetpack.		This function is used to give a player a jetpack.

AlexTMjugador: Visual improvement

2014-06-26T11:34:34Z

Visual improvement

← Older revision		Revision as of 11:34, 26 June 2014
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server function}}		{{Server function}}
	{{Deprecated}}		{{Deprecated\|givePedJetPack}}

	~~Please use [[givePedJetPack]]~~

	This function is used to give a player a jetpack.		This function is used to give a player a jetpack.

Arran Fortuna at 21:06, 20 April 2011

2011-04-20T21:06:07Z

← Older revision		Revision as of 21:06, 20 April 2011
Line 2:		Line 2:
	{{Server function}}		{{Server function}}
	{{Deprecated}}		{{Deprecated}}

			Please use [[givePedJetPack]]

	This function is used to give a player a jetpack.		This function is used to give a player a jetpack.

Ccw at 14:16, 20 January 2009

2009-01-20T14:16:19Z

← Older revision		Revision as of 14:16, 20 January 2009
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server function}}		{{Server function}}
			{{Deprecated}}
	This function is used to give a player a jetpack.		This function is used to give a player a jetpack.

Arc at 15:52, 17 August 2007

2007-08-17T15:52:48Z

← Older revision		Revision as of 15:52, 17 August 2007
Line 8:		Line 8:
	* Probably others too.		* 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.		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 14:		Line 14:

	===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===
Line 24:		Line 24:
	-- 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

Talidan at 13:48, 4 August 2007

2007-08-04T13:48:05Z

← Older revision		Revision as of 13:48, 4 August 2007
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
			{{Server function}}
	This function is used to give a player a jetpack.		This function is used to give a player a jetpack.

Talidan: Readded example

2007-07-29T14:59:43Z

Readded example

← Older revision		Revision as of 14:59, 29 July 2007
Line 7:		Line 7:
	* Probably others too.		* 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.		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 16:		Line 16:

	===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}}

EAi: /* Example */

2006-08-13T16:12:36Z

Example

← Older revision

Revision as of 16:12, 13 August 2006

EAi at 16:12, 13 August 2006

2006-08-13T16:12:14Z

← Older revision		Revision as of 16:12, 13 August 2006
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	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==

MrJax at 01:31, 13 August 2006

2006-08-13T01:31:59Z

New page

__NOTOC__
This function is used to give a player a jetpack.
Note: The player must be on-foot.

==Syntax==
<syntaxhighlight lang="lua">bool givePlayerJetPack ( player thePlayer )</syntaxhighlight>

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

===Returns===
Returns 'true' if the player was on-foot and didn't already have a jetpack, 'false' otherwise.

==Example==
<syntaxhighlight lang="lua">
addCommandHandler ( "jetpack", "jetPackCommand" )
function jetPackCommand ( source, key )
if ( doesPlayerHaveJetPack ( source ) ) then -- if he has a jetpack
removePlayerJetPack ( source ) -- remove it
else
givePlayerJetPack ( source ) -- give him one
end
end
</syntaxhighlight>

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