From the NannyMUD documentation

LAST CHANGE

2001-08-12

FUNCTION

NAME
        hit_player_hook - Get told when a living gets hit.


LOCATION
        This function cen be located in any object.

DESCRIPTION
	This function is called if a living gets hit, but after the
	calls to block_hit_player_hook and value_hit_player_hook, and
	only if block_hit_player_hook returned zero

	ARGUMENTS

	hit_player_hook(
	  ({ Damage being done,
	     Player/npc/object doing the damage, can be 0,
	     Object doing the damage, can be 0,
	     Armour class reduction to damage,
	     Damage type of the attack
	  })
	  The living being hit.
	)


NOTE
        The 'armour class reduction' has already been subtracted
	from the damage when this function is called.


NOTE
	'Object doing the damage' is the object that called
	hit_player(). That can be whatever - it is not necessarily
	a weapon object.


SEE ALSO
        block_hit_player_hook in hooks/block_hit_player_hook


SEE ALSO
        value_hit_player_hook in hooks/value_hit_player_hook


SEE ALSO
        attack_hook in hooks/attack_hook


SEE ALSO
        die_hook in hooks/die_hook
        die_hook in std/line/line_control
        die_hook in std/misc/kill_logger
        die_hook in std/misc/logger


SEE ALSO
        kill_hook in hooks/kill_hook
        kill_hook in std/line/line_control
        kill_hook in std/misc/logger