Scripting/Squirrel/Events/OnPlayerDeath

This is called when a player dies. e.g.: drowned or self-kill.

Syntax

function onPlayerDeath( player, reason )

Arguments

• Player player - The player that died
• int reason - Death reason

Death Reasons

• Death from falling - 44 (WEP_FALL)
• Death from an explosion - 41
• Death from drowning - 43 (WEP_DROWNED)
• Death from dying in a car - 39 (WEP_VEHICLE)
• Suicide - 70 (WEP_SUICIDE)

Example

function onPlayerDeath( player, reason )
{
	switch (reason)
	{
		case 44:
		{
			Message(player.Name + " fell down and died.");
			break;
		}
		case 41:
		{
			Message(player.Name + " exploded to bits!");
			break;
		}
		case 43:
		{
			Message(player.Name + " drowned to death.");
			break;
		}
		case 39:
		{
			Message(player.Name + " died in a car accident.");
			break;
		}
		case 70:
		{
			Message(player.Name + " suicided.");
			break;
		}
	}
}

Notes

The functions Message and Player.Name were used in this example. More info about them in corresponding pages.

Related Functions

• onPlayerJoin( player )
• onPlayerPart( player, reason )

• onPlayerRequestClass( player, classID )
• onPlayerRequestSpawn( player )
• onPlayerSpawn( player )

• onPlayerDeath( player, reason )
• onPlayerKill( killer, player, reason, bodypart )
• onPlayerTeamKill( killer, player, reason, bodypart )

• onPlayerChat( player, message )
• onPlayerCommand( player, command, arguments )
• onPlayerPM( player, playerTo, message )

• onPlayerBeginTyping( player )
• onPlayerEndTyping( player )

• onLoginAttempt( playerName, password, ipAddress )
• onNameChangeable( player ) // Currently can't work.

• onPlayerMove( player, lastX, lastY, lastZ, newX, newY, newZ )
• onPlayerHealthChange( player, lastHP, newHP )
• onPlayerArmourChange( player, lastArmour, newArmour )
• onPlayerWeaponChange( player, oldWep, newWep )

• onKeyDown( player, bindID )
• onKeyUp( player, bindID )
• onPlayerAwayChange( player, newStatus )
• onPlayerSpectate( player, target )
• onPlayerCrashDump( player, crashReport )
• onPlayerNameChange( player, oldName, newName )
• onPlayerActionChange( player, oldAction, newAction )
• onPlayerStateChange( player, oldState, newState )
• onPlayerOnFireChange( player, isOnFireNow )
• onPlayerCrouchChange( player, isCrouchingNow )
• onPlayerGameKeysChange( player, oldKeys, newKeys )