Garry's Mod Wiki

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>