OnPlayerDamage - Revision history

Zangomangu: Removed fixed issues

2022-01-30T10:41:07Z

Removed fixed issues

← Older revision		Revision as of 10:41, 30 January 2022
Line 32:		Line 32:
	addEventHandler ( "onPlayerDamage", root, playerDamage_text ) --add an event handler for the onPlayerDamage event		addEventHandler ( "onPlayerDamage", root, playerDamage_text ) --add an event handler for the onPlayerDamage event
	</syntaxhighlight>		</syntaxhighlight>

	~~==Issues==~~
	~~{{Issues\|~~
	~~{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}~~
	~~{{Issue\|8082\|(Fixed in r9762) Custom weapons & objects don't fully work with ped damage events}}~~
	}}

	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}

Lettify: Enhanced argument readability

2020-06-13T04:12:10Z

Enhanced argument readability

← Older revision		Revision as of 04:12, 13 June 2020
Line 9:		Line 9:
	==Parameters==		==Parameters==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	player attacker, int ~~attackerweapon~~, int bodypart, float loss		player attacker, int damage_causing, int bodypart, float loss
	</syntaxhighlight>		</syntaxhighlight>

	*'''attacker''': a [[player]] element representing the player who was the attacker. If there was no attacker this returns false.		*'''attacker''': a [[player]] element representing the player who was the attacker. If there was no attacker this returns false.
	*'''~~attackerweapon~~''': an [[int]] representing the [[Weapons\|attacker weapon]] or ~~the~~ [[Damage Types\|damage ~~type~~]].		*'''damage_causing''': an [[int]] representing the cause of damage, either a [[Weapons\|attacker weapon]], or some other [[Damage Types\|types of damage]].
	*'''bodypart''': an [[int]] representing the bodypart ID the player was hit on when he got damaged.		*'''bodypart''': an [[int]] representing the bodypart ID the player was hit on when he got damaged.
	{{BodyParts}}		{{BodyParts}}

Arran Fortuna at 22:02, 10 September 2019

2019-09-10T22:02:36Z

← Older revision		Revision as of 22:02, 10 September 2019
Line 24:		Line 24:
	This example causes an instant kill when a player is shot in the head, and announces it in the chatbox.		This example causes an instant kill when a player is shot in the head, and announces it in the chatbox.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~--add an event handler for the onPlayerDamage event~~
	function playerDamage_text ( attacker, weapon, bodypart, loss ) --when a player is damaged		function playerDamage_text ( attacker, weapon, bodypart, loss ) --when a player is damaged
	if ( bodypart == 9 ) then -- if the body part is 9~~, i.e. the~~ head		if ( bodypart == 9 and attacker and attacker ~= source ) then -- if the body part is 9 (head) and there is an attacker and it wasn't self damage
	outputChatBox ( "Headshot!", ~~getRootElement ()~~, 255, 170, 0 ) --output "Headshot" into the chatbox		outputChatBox ( "Headshot!", attacker, 255, 170, 0 ) --output "Headshot" into the chatbox
	killPed ( source, attacker, weapon, bodypart ) -- and kill the player		killPed ( source, attacker, weapon, bodypart ) -- and kill the player
	end		end
	end		end
	addEventHandler ( "onPlayerDamage", ~~getRootElement ()~~, playerDamage_text )		addEventHandler ( "onPlayerDamage", root, playerDamage_text ) --add an event handler for the onPlayerDamage event
	</syntaxhighlight>		</syntaxhighlight>

Zver-CR at 23:01, 16 January 2019

2019-01-16T23:01:32Z

← Older revision		Revision as of 23:01, 16 January 2019
Line 37:		Line 37:
	{{Issues\|		{{Issues\|
	{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}		{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}
	{{Issue\|8082\|Custom weapons & objects don't fully work with ped damage events}}		{{Issue\|8082\|(Fixed in r9762) Custom weapons & objects don't fully work with ped damage events}}
	}}		}}

	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}

Botder at 03:01, 27 September 2018

2018-09-27T03:01:13Z

← Older revision		Revision as of 03:01, 27 September 2018
Line 40:		Line 40:
	}}		}}

	==See ~~Also==~~		{{See also/Server event\|Player events}}
	~~===~~Player events~~===~~
	~~{{Player_events}}~~
	~~===Event functions===~~
	~~{{Event functions~~}}

Botder at 02:13, 27 September 2018

2018-09-27T02:13:34Z

← Older revision		Revision as of 02:13, 27 September 2018
Line 40:		Line 40:
	}}		}}

	{{See ~~also/Server event\|~~Player events}}		==See Also==
			===Player events===
			{{Player_events}}
			===Event functions===
			{{Event functions}}

Myonlake: /* Parameters */

2018-04-02T21:41:37Z

Parameters

← Older revision		Revision as of 21:41, 2 April 2018
Line 12:		Line 12:
	</syntaxhighlight>		</syntaxhighlight>

	*'''attacker''': A player element representing the player who was the attacker. If there was no attacker this returns false.		*'''attacker''': a [[player]] element representing the player who was the attacker. If there was no attacker this returns false.
	*'''attackerweapon''': ~~An integer~~ representing the [[Weapons\|attacker weapon]] or the [[Damage Types\|damage type]].		*'''attackerweapon''': an [[int]] representing the [[Weapons\|attacker weapon]] or the [[Damage Types\|damage type]].
	*'''bodypart''': ~~An integer~~ representing the bodypart ID the player was hit on when he got damaged.		*'''bodypart''': an [[int]] representing the bodypart ID the player was hit on when he got damaged.
	{{BodyParts}}		{{BodyParts}}
	*'''loss''': A float representing the percentage of health the player lost.		*'''loss''': a [[float]] representing the percentage of health the player lost.

	==Source==		==Source==

Lexr128 at 15:29, 17 January 2017

2017-01-17T15:29:31Z

← Older revision		Revision as of 15:29, 17 January 2017
Line 13:		Line 13:

	*'''attacker''': A player element representing the player who was the attacker. If there was no attacker this returns false.		*'''attacker''': A player element representing the player who was the attacker. If there was no attacker this returns false.
	*'''attackerweapon''': An integer representing the weapon the ~~attacker used to kill the player~~		*'''attackerweapon''': An integer representing the [[Weapons\|attacker weapon]] or the [[Damage Types\|damage type]].
	*'''bodypart''': An integer representing the bodypart ID the player was hit on when he got damaged.		*'''bodypart''': An integer representing the bodypart ID the player was hit on when he got damaged.
	{{BodyParts}}		{{BodyParts}}

Lopez: /* Issues */ Added info about #8082

2016-05-25T19:14:02Z

Issues: Added info about #8082

← Older revision		Revision as of 19:14, 25 May 2016
Line 36:		Line 36:
	==Issues==		==Issues==
	{{Issues\|		{{Issues\|
	{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle }}		{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}
			{{Issue\|8082\|Custom weapons & objects don't fully work with ped damage events}}
	}}		}}

	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}

Arran Fortuna at 15:53, 8 April 2014

2014-04-08T15:53:22Z

← Older revision		Revision as of 15:53, 8 April 2014
Line 3:		Line 3:
	This event is triggered when a player is damaged, in any way.		This event is triggered when a player is damaged, in any way.

	~~It should be noted that this~~ event is not triggered when attacked by a team member if friendly fire is enabled.		*This event is not triggered when attacked by a team member if friendly fire is enabled.
			*Canceling this event has no effect. Cancel the client-side event [[onClientPlayerDamage]] instead.
	~~It should also be noted that canceling~~ this event has no effect. Cancel the client-side event [[onClientPlayerDamage]] instead.		*onPlayerDamage doesn't trigger if the damage kills the player, [[onPlayerWasted]] is called instead.

	==Parameters==		==Parameters==

← Older revision		Revision as of 23:01, 16 January 2019
Line 37:		Line 37:
	{{Issues\|		{{Issues\|
	{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}		{{Issue\|6495\|[Fixed in 1.3.3-5411] onPlayerDamage has wrong parameters if source on vehicle}}
	{{Issue\|8082\|Custom weapons & objects don't fully work with ped damage events}}		{{Issue\|8082\|(Fixed in r9762) Custom weapons & objects don't fully work with ped damage events}}
	}}		}}

	{{See also/Server event\|Player events}}		{{See also/Server event\|Player events}}