KillPlayer - Revision history

XLive at 07:08, 4 November 2020

2020-11-04T07:08:41Z

← Older revision		Revision as of 07:08, 4 November 2020
Line 38:		Line 38:
	end		end
	end		end
	addEventHandler ( "onPlayerDamage", ~~getRootElement()~~, headshotKill )		addEventHandler ( "onPlayerDamage", root, headshotKill )
	</syntaxhighlight>		</syntaxhighlight>

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

2015-02-13T16:13:49Z

Changed "DeprecatedWithAlt" template to "Deprecated"

← Older revision		Revision as of 16:13, 13 February 2015
Line 1:		Line 1:
			__NOTOC__
	{{Server function}}		{{Server function}}
	~~__NOTOC__~~		{{Deprecated\|killPed\|}}
	{{~~DeprecatedWithAlt~~\|killPed\|}}

	This function kills the specified player.		This function kills the specified player.

2011-11-10T19:50:17Z

Replaced template deprecated with DeprecatedWithAlt

← Older revision		Revision as of 19:50, 10 November 2011
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	{{~~Deprecated~~}}		{{DeprecatedWithAlt\|killPed\|}}

	~~Please use [[killPed]]~~

	This function kills the specified player.		This function kills the specified player.

2011-04-20T20:55:10Z

← Older revision		Revision as of 20:55, 20 April 2011
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	{{Deprecated}}		{{Deprecated}}

			Please use [[killPed]]

	This function kills the specified player.		This function kills the specified player.

2009-04-13T07:09:06Z

Removed 'DP3' things

← Older revision		Revision as of 07:09, 13 April 2009
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool killPlayer ( player thePlayer, [ player theKiller = nil, int weapon=255, int bodyPart=255~~, bool stealth~~ ] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool killPlayer ( player thePlayer, [ player theKiller = nil, int weapon=255, int bodyPart=255 ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
Line 14:		Line 14:
	* '''weapon:''' The ID of the weapon that should appear to have killed the player (doesn't affect how they die)		* '''weapon:''' The ID of the weapon that should appear to have killed the player (doesn't affect how they die)
	* '''bodyPart:''' The ID of the body part that should appear to have been hit by the weapon (doesn't affect how they die)		* '''bodyPart:''' The ID of the body part that should appear to have been hit by the weapon (doesn't affect how they die)
	* '''stealth:''' Boolean value, representing whether or not this a stealth kill ('''From DP3''')

	===Returns===		===Returns===

2009-01-20T14:20:24Z

← Older revision		Revision as of 14:20, 20 January 2009
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
			{{Deprecated}}
	This function kills the specified player.		This function kills the specified player.

2008-04-01T09:53:26Z

← Older revision		Revision as of 09:53, 1 April 2008
Line 4:		Line 4:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool killPlayer ( player thePlayer, [ player theKiller = nil, int weapon=255, int bodyPart=255 ] )</syntaxhighlight>		<syntaxhighlight lang="lua">bool killPlayer ( player thePlayer, [ player theKiller = nil, int weapon=255, int bodyPart=255, bool stealth ] )</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
Line 13:		Line 13:
	* '''weapon:''' The ID of the weapon that should appear to have killed the player (doesn't affect how they die)		* '''weapon:''' The ID of the weapon that should appear to have killed the player (doesn't affect how they die)
	* '''bodyPart:''' The ID of the body part that should appear to have been hit by the weapon (doesn't affect how they die)		* '''bodyPart:''' The ID of the body part that should appear to have been hit by the weapon (doesn't affect how they die)
			* '''stealth:''' Boolean value, representing whether or not this a stealth kill ('''From DP3''')

	===Returns===		===Returns===

2007-08-29T16:47:38Z

added another example

← Older revision		Revision as of 16:47, 29 August 2007
Line 18:		Line 18:

	==Example==		==Example==
	This simple example adds a '''kill''' command to commit suicide.		'''Example 1:''' This simple example adds a '''kill''' command to commit suicide.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function commitSuicide(sourcePlayer)		function commitSuicide(sourcePlayer)
Line 26:		Line 26:
	-- attach our handler to the "kill" command		-- attach our handler to the "kill" command
	addCommandHandler("kill", commitSuicide)		addCommandHandler("kill", commitSuicide)
			</syntaxhighlight>

			'''Example 2:''' This example enables 1 hit kills if a player is shot in the head.
			<syntaxhighlight lang="lua">
			function headshotKill ( attacker, attackerweapon, bodypart, loss )
			if bodypart == 9 then --if the bodypart is the head
			--kill the player, emulating the correct killer, weapon and bodypart.
			killPlayer ( source, attacker, attackerweapon, bodypart )
			end
			end
			addEventHandler ( "onPlayerDamage", getRootElement(), headshotKill )
	</syntaxhighlight>		</syntaxhighlight>

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

2007-08-26T17:33:18Z

Replaced example

← Older revision		Revision as of 17:33, 26 August 2007
Line 18:		Line 18:

	==Example==		==Example==
			This simple example adds a '''kill''' command to commit suicide.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~-- Get the player with an ID of 1~~		function commitSuicide(sourcePlayer)
	~~thePlayer = getPlayerFromID ( 1 )~~		-- kill the player and make him responsible for it
	~~-- If a player was found with an ID of 1 then~~		killPlayer(sourcePlayer, sourcePlayer)
	if ( ~~thePlayer~~ ) ~~then~~
	-- ~~Kill~~ the player
	~~if (~~ killPlayer ( ~~thePlayer ) ) then~~
	~~-- Inform everyone that they were killed.~~
	~~outputChatBox ( getPlayerName ( thePlayer ) .. " was eliminated."~~ )
	~~end~~
	end		end
			-- attach our handler to the "kill" command
			addCommandHandler("kill", commitSuicide)
	</syntaxhighlight>		</syntaxhighlight>

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

2007-08-26T15:51:39Z

← Older revision		Revision as of 15:51, 26 August 2007
Line 20:		Line 20:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- Get the player with an ID of 1		-- Get the player with an ID of 1
	~~bastard~~ = getPlayerFromID ( 1 )		thePlayer = getPlayerFromID ( 1 )
	-- If a player was found with an ID of 1 then		-- If a player was found with an ID of 1 then
	if ( ~~bastard~~ ) then		if ( thePlayer ) then
	-- Kill the player		-- Kill the player
	if ( killPlayer ( ~~bastard~~ ) ) then		if ( killPlayer ( thePlayer ) ) then
	-- Inform everyone that they were killed.		-- Inform everyone that they were killed.
	outputChatBox ( getPlayerName ( ~~bastard~~ ) .. " was eliminated." )		outputChatBox ( getPlayerName ( thePlayer ) .. " was eliminated." )
	end		end
	end		end