Revision Difference
GM:PlayerDeath#511095
<function name="PlayerDeath" parent="GM" type="hook">⤶
<ishook>yes</ishook>⤶
<description>⤶
Called when a player is killed by <page>Player:Kill</page> or any other normal means.⤶
⤶
This hook is **not** called if the player is killed by <page>Player:KillSilent</page>. See <page>GM:PlayerSilentDeath</page> for that.⤶
⤶
* <page>GM:DoPlayerDeath</page> is called **before** this hook.⤶
* <page>GM:PostPlayerDeath</page> is called **after** this hook.⤶
⤶
See <page>Player:LastHitGroup</page> if you need to get the last hit hitgroup of the player.⤶
⤶
<note><page>Player:Alive</page> will return true in this hook.</note>⤶
</description>⤶
<realm>Server</realm>⤶
<predicted>No</predicted>⤶
<args>⤶
<arg name="victim" type="Player">The player who died</arg>⤶
<arg name="inflictor" type="Entity">Item used to kill the victim</arg>⤶
<arg name="attacker" type="Entity">Player or entity that killed the victim</arg>⤶
</args>⤶
</function>⤶
⤶
<example>⤶
<description>If the player suicides (he is the killer and the victim (ply)), then it will print a message to console. If someone else kills him, it will print a different message to console.</description>⤶
<code>⤶
function GM:PlayerDeath( victim, inflictor, attacker )⤶
if ( victim == attacker ) then⤶
PrintMessage( HUD_PRINTTALK, victim:Name() .. " committed suicide." )⤶
else⤶
PrintMessage( HUD_PRINTTALK, victim:Name() .. " was killed by " .. attacker:Name() .. ".")⤶
end⤶
end⤶
</code>⤶
<output>⤶
If suicide:⤶
⤶
Player1 has committed suicide.⤶
⤶
Else:⤶
⤶
Player1 was killed by Player2.⤶
</output>⤶
⤶
</example>