imported>Shr0x в 19:01, 15 мая 2024

2024-05-15T19:01:04Z

Новая страница

This event is triggered when a player dies.

{{ServersideCsJsEvent}}
{{CSharpContainer|1=
See [[OnPlayerDeath]].
}}

{{JSContainer|
{{Parameters}}
* '''player''': {{RageType|Player}} - victim, the player which died.
* '''reason''': {{RageType|Number}} - cause hash of death ('''list causes:''' [[Causes of death| Causes]]).
* '''killer''': {{RageType|Player}} - who killed the player.

{{Example}}
This example outputs chat message, when player dies.
<syntaxhighlight lang="javascript" style="width: 98%; background-color: #E4F1FE;">
function playerDeathHandler(player, reason, killer) {
const deathName = player.name;
const killerName = killer.name;
if(reason == 341774354) {
mp.players.broadcast(`${deathName} died in a chopper!`);
return;
}
mp.players.broadcast(`${killerName} killed ${deathName}. Reason: ${reason}`);
}

mp.events.add("playerDeath", playerDeathHandler);
</syntaxhighlight>
}}

{{ClientsideCsJsEvent}}

{{CSharpContainer|
<syntaxhighlight lang="csharp">
public delegate void OnPlayerDeathDelegate(Player player, uint reason, Player killer, CancelEventArgs cancel);
</syntaxhighlight>

{{Parameters}}
* '''player''': the player that died, expects '''RAGE.Elements.Player''' type.
* '''reason''': the reason for death, expects '''System.UInt32''' type.
* '''killer''': killer, expects '''RAGE.Elements.Player''' type.
* '''cancel''': cancel, expects '''RAGE.Events.CancelEventArgs''' type.

{{Example}}
The example below shows a chat message to the client when a player dies.

<syntaxhighlight lang="csharp">
Events.OnPlayerDeath += OnPlayerDeath;
</syntaxhighlight>
<syntaxhighlight lang="csharp">
public void OnPlayerDeath(RAGE.Elements.Player player, uint reason, RAGE.Elements.Player killer, RAGE.Events.CancelEventArgs cancel)
{
if (killer == null)
{
RAGE.Chat.Output($"{player.Name} just died ");
}
else if (reason == 539292904)
{
RAGE.Chat.Output($"{player.Name} was killed by {killer.Name} in an explosion");
}
else
{
RAGE.Chat.Output($"{player.Name} was killed by {killer.Name} ");
}
}
</syntaxhighlight>
}}

{{JSContainer|
{{Parameters}}
* '''player''': {{RageType|Player}} - local player who died.
* '''reason''': {{RageType|Number}} - cause hash of death ('''list causes:''' [[Causes of death| Causes]]).
* '''killer''': {{RageType|Player}} - who killed the player.

{{Example}}
This example sets up death camera effect for 5 seconds
<syntaxhighlight lang="javascript" style="width: 98%; background-color: #E4F1FE;">
mp.events.add("playerDeath", (player, reason, killer) => {
mp.game.graphics.startScreenEffect("DeathFailNeutralIn", 5000, false);
});
</syntaxhighlight>
}}

==See also==
{{Player_events}}

[[Category:Player]]
[[Category:Server-side Event]]
[[Category:Client-side Event]]

PlayerDeath - История изменений

imported>Shr0x в 19:01, 15 мая 2024