From the NannyMUD documentation

LAST CHANGE

2009-07-27

FUNCTION

NAME
        add_hp - change the hit points of a living object


LOCATION
	/obj/living_functions.c

SYNTAX
	varargs int add_hp(int amount [, ignore_flag])

DESCRIPTION
	With this function you can add an amount, positive or negative, to
        a living's hit points. Checks on limits can be turned off by using
        the ignore flag. The use of the ignore flag is logged. The function
        returns the living object's number of hit points after it completes.


NOTE
	Use of this function in weapons and in combat is expressly
	forbidden.  Doing so may be grounds for demotion.  Check the
	rules or ask an admin for more current info.


NOTE
	The function will not reduce the hit points below 1, thus it will
	not kill a living object.


NOTE
	This could be used to heal hit points alone (as opposed to
	heal_self(L) which heals hit points and spell points together).


NOTE
	Unlike hit_player(L), which adjusts the damage for armour class,
	this function adds or subtracts an absolute amount from the total
	hit points.

	Use this for poisons and the like.


NOTE
	With the ignore flag, this can be used to raise a living object above
	its maximum normal hit point range.  This must be approved.


SEE ALSO
        add_sp in lfun/living/add_sp


SEE ALSO
        heal_self in lfun/living/heal_self