Garry's Mod Wiki

GM:PlayerDeath

  GM:PlayerDeath( Player victim, Entity inflictor, Entity attacker )

Description

Called when a player is killed by Player:Kill or any other normal means.

This hook is not called if the player is killed by Player:KillSilent. See GM:PlayerSilentDeath for that.

See Player:LastHitGroup if you need to get the last hit hitgroup of the player.

Player:Alive will return false in this hook.

Arguments

1 Player victim
The player who died
2 Entity inflictor
Item used to kill the victim
3 Entity attacker
Player or entity that killed the victim

Example

If the player suicides (they are the killer and the victim), then it will print a message to console. If someone else kills them, it will print a different message to console.

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 )
Output:
-- If suicide... Player1 has committed suicide. -- else... Player1 was killed by Player2.