From the NannyMUD documentation

LAST CHANGE

2001-08-12

FUNCTION

NAME
        value_hit_player_hook - Influence what damage a hit does.


LOCATION
        This function can be located in any object.

DESCRIPTION
	'value_hit_player_hook' is called when the living has been
	hit, and the 'block_hit_player_hook' has been called and
	returned zero.

        The value returned from 'value_hit_player_hook' is added to
	the damage done to the living.

	After 'value_hit_player_hook' has been called,
	'hit_player_hook' is called.

	ARGUMENTS

	value_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 living 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
        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