HIT_PLAYER(L)

NAME
	hit_player - attempt to do damage to a living object

SYNOPSIS
	int hit_player(int damage, int ignoreflag);

LOCATION
	/obj/living.c

RETURN VALUE
	The actual damage done to the living object is returned.  Due
	to armour and other causes, this may be lower than the
	passed value.

DESCRIPTION
	This function is used to attack a living object and attempt to
	do damage amount of hit point damage to the living.  An attack
	on a non-PK (player-killing) character by another interactive
	character will fail unless a true value is passed as a second
	argument.  

NOTES
	Do not use the ignoreflag without obtaining permission from a
	35++ wizard.  Use of the ignoreflag may be logged.

	This function is meant for combat usage.  Poisons and the like
	should use add_hp(-L).

	Almost all combat occurs in this function.  Because this may
	change in the future, if you redefine this function do not copy
	the information over.  Instead use ::hit_player(damage) to
	pass the damage on to the living.  You may wish to modify the
	damage beforehand depending on your purposes.  See the
	inheritance(LPC) doc to understand the '::'.

	Uses for this function include custom spells and the like.

SEE ALSO
	add_hp()

Help topics available:

add_hp	add_money	add_sp	catch_tell	heal_self
hit_player	monster_died	move_player	query_max_sp	query_money
query_attack	query_npc	query_objective	query_gender	query_possessive
query_pronoun	query_gender_string	query_sp	query_worn	query_hp
query_level	query_living	query_max_hp	set_wet	stop_fight