From the NannyMUD documentation

LAST CHANGE

2001-08-12

FUNCTION

NAME
        block_hit_player_hook - Prevent a living from being hit.


LOCATION
        This function can be located in any object.

DESCRIPTION
	'block_hit_player_hook' is called when the living has been
	hit. If it returns 1, the hit is blocked.

	ARGUMENTS

	block_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 of damage,
	     Damage type of the attack,
	     The ignore_ac flag
	  }),
	  The living being hit.
	)


NOTE
	This function is not called if the ignore_flag to hit_player()
	is true.


NOTE
	The actual damage done to the player is :
	'damage being done' - 'armour class reduction'.


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
        hit_player_hook in hooks/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