--- deliantra/server/pod/objects.pod	2006/12/19 13:41:45	1.5
+++ deliantra/server/pod/objects.pod	2006/12/19 21:06:08	1.7
@@ -96,6 +96,10 @@
 equal to 0 the absolute value of the speed field is added to speed_left
 on the end of the tick.
 
+This means: the lower the speed field is (but still above MIN_ACTIVE_SPEED)
+the more seldom the object is processed. And the higher the speed field is
+the more often the object is processed.
+
 =item no_drop (0|1)
 
 Sets the flag FLAG_NO_DROP.
@@ -329,8 +333,7 @@
 
 =item on_use_yield <archetype>
 
-When this object is applied this object will be created.
-This field is also used by FOOD and POISON.
+When this object is applied an instance of <archetype> will be created.
 
 =item subtypes <potion subtype>
 
@@ -360,6 +363,42 @@
 
 =back
 
+=head3 FOOD - type 6 - Eatable stuff
+
+This is for objects that are representing general eatables like
+beef or bread.
+
+The main difference between FOOD, FLESH and DRINK is that they
+give different messages.
+
+The specialty of FLESH is that it inherits the resistancies of the
+monsters it was generated in and will let dragons raise their resistancies
+with that.
+
+If a player runs low on food he will grab for FOOD, DRINK and POISON
+and if he doesn't find any of that he will start eating FLESH.
+
+=over 4
+
+=item title <string>
+
+If the food has a title or is cursed it is considered 'special', which means that the
+fields Str, Dex, Con, Int, Wis, Pow, resist_<resistancy>, hp and sp
+are interpreted and have further effects on the player.
+
+The higher the food field is the longer the improvement of the player lasts
+(except for hp and sp).
+
+=item food <number>
+
+This is the amount of food points the player gets when he eats this.
+
+=item on_use_yield <archetype>
+
+When this object is applied an instance of <archetype> will be created.
+
+=back
+
 =head3 WEAPON - type 15 - Weapons
 
 This type is for general hack and slash weapons like swords, maces
@@ -506,6 +545,69 @@
    FLAG_SEE_IN_DARK
    FLAG_UNDEAD
 
+=head3 DRINK - type 54 - Drinkable stuff
+
+See FOOD description.
+
+=head3 CHECK_INV - type 64 - Inventory checkers
+
+This object checks whether the player has a specific item in his
+inventory when he moves above the inventory checker. If the player has
+the item (or not, which can be controlled with a flag) a connection will be triggered.
+
+If you set move_block you can deny players and monsters to reach the space where
+the inventory checker is on, see 'move_block' description below.
+
+The conditions specified by hp, slaying and race are concationated with OR.
+So matching one of those conditions is enough.
+
+=over 4
+
+=item move_block <move type bitmask>
+
+If you set this field to block a movetype the move code will block any moves
+onto the space with the inventory checker, IF the moving object doesn't have
+(or has - if last_sp = 0) the item that the checker is searching for.
+
+=item last_sp (0|1)
+
+If last_sp is 1 'having' the item that is being checked for will
+activate the connection or make the space with the checker non-blocking.
+If last_sp is 0 'not having' the item will activate the connection
+or make the space with the checker non-blocking.
+
+=item last_heal (0|1)
+
+If last_heal is 1 the matching item will be removed if the inventory checker
+activates a connection and finds the item in the inventory.
+
+(A inventory checker that blocks a space won't remove anything from inventories)
+
+=item hp <number>
+
+If this field is not 0 the inventory checker will search for an object
+with the type id <number>.
+
+=item slaying <string>
+
+If this field is set the inventory checker will search for an object that
+has the same string in the slaying field (for example a key string of a key).
+
+=item race <string>
+
+If this field is set the inventory checker will search for an object which
+has the archetype name that matches <string>.
+
+=item connected <connection id>
+
+This is the connection that will be activated.
+
+=back
+
+=head3 FLESH - type 72 - Organs and body parts
+
+See FOOD description.
+
 =head3 HOLE - type 94 - Holes
 
 Holes are holes in the ground where objects can fall through.  When the hole
@@ -564,6 +666,12 @@
 speed and speed_left field. Look above at the generic description of these
 fields.
 
+NOTE: Setting FLAG_IS_USED_UP on an force will also consider the 'food' field
+like stated above in the FLAG_IS_USED_UP description. BUT: If the food field reaches
+0 before duration and FLAG_APPLIED is set, the force will last for 'duration'.
+If the FLAG_APPLIED is not set the force is removed when food reaches 0.
+Generally this means: FLAG_IS_USED_UP doesn't have good semantics on forces.
+
 =over 4
 
 =item duration