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