Revision Difference
GM:PlayerDeath#527211
<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 )
hook.Add( "PlayerDeath", "GlobalDeathMessage", function( 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⤶
end )⤶
</code>
<output>
If suicide:
Player1 has committed suicide.
Else:
Player1 was killed by Player2.
</output>
</example>