From the NannyMUD documentation

LAST CHANGE

2001-09-09

NAME

        complex_food - Multiple drink object

INHERITS

	/std/simple_food

FUNCTIONS

SETUP FUNCTIONS

	set_sp_heal
	set_hp_heal
	set_full
	set_max_full
	set_part_name

QUERY FUNCTIONS

	query_sp_heal
	query_hp_heal
	query_full
	query_max_full
	query_part_name
	query_full_string

PROPERTIES

INTERNAL PROPERTIES

PROPERTY NAME
        _show_full_message - _show_full_message


DESCRIPTION
	Will if true tell the player how much there is left after he 
        has eaten from it.
	Will if true show how many pieces there are left in long_desc.


PROPERTY NAME
        _show_original_number - _show_original_number


DESCRIPTION
	Will if true show: 'There are five pieces of seven left.',
	instead of the normal printout: 'There are five pieces left.'



DESCRIPTION

NOTE
	Anything that uses this file has to be approved by the admin.


NOTE
	Note that if you use set_heal() from simple_food.c
	then it will heal that amount of spell and hit points 
	AND heal the spell points and hit points you set with set_sp_heal() 
	and set_hp_heal() every time you eat from it.






FUNCTION

NAME
        set_sp_heal - Set how many spell points the food shall heal.


SYNTAX
void set_sp_heal(mixed sp_heal)

DESCRIPTION
	This function sets how many spell points the player will get 
	for every time he eats from it.
	The value can also be negative. The value is sent to eval() when 
	the player eats the food.




FUNCTION

NAME
        set_hp_heal - Set how many hit points the food shall heal.


SYNTAX
void set_hp_heal(mixed hp_heal)

DESCRIPTION
	This function sets how many spell points the player will get 
	for every time he eats from it.
	The value can also be negative. The value is sent to eval() when 
	the player eats the food.




FUNCTION

NAME
        set_full - Set how many times the player can eat from this food.


SYNTAX
void set_full(int full)

DESCRIPTION
	This function will define how many times you eat from it.
	If you try to put more into the food then is possible,
	it expands so it can contain the new amount.
	Note that for EVERY SINGLE bite you will:
		* heal set_heal() hp and sp.
		* heal set_heal_sp() sp.
		* heal set_heal_hp() hp.
		* become set_strength() intoxicated.
		* become set_soak() soaked.




FUNCTION

NAME
        set_max_full - Set how many pieces the food contain originally.


SYNTAX
void set_max_full(int max_full)

DESCRIPTION
	This function will define how many pieces the food can be.
	Also if it shrinks so much it can not contain the 
	current amount of pieces, then how many times you can
	eat from it will be lowered to how the original(maximum) amount.




FUNCTION

NAME
        set_part_name - Set the name of a single piece of food.


SYNTAX
void set_part_name(string part_name)

DESCRIPTION
	This function allows you to set the name used in the long description
	when it tells the player how many pieces of food there are left.
        Default is "piece". 


EXAMPLE
        Set it to "slice" for pizza: set_part_name("slice");