[ViewVC] Diff of: cvs/deliantra/server/pod/objects.pod

Comparing deliantra/server/pod/objects.pod (file contents):
Revision 1.4 by elmex, Mon Dec 18 16:53:04 2006 UTC vs.
Revision 1.13 by elmex, Wed Dec 20 13:07:13 2006 UTC

…		…
94		94
95	If the object is on the active list and speed_left is lower or	95	If the object is on the active list and speed_left is lower or
96	equal to 0 the absolute value of the speed field is added to speed_left	96	equal to 0 the absolute value of the speed field is added to speed_left
97	on the end of the tick.	97	on the end of the tick.
98		98
		99	This means: the lower the speed field is (but still above MIN_ACTIVE_SPEED)
		100	the more seldom the object is processed. And the higher the speed field is
		101	the more often the object is processed.
		102
99	=item no_drop (0\|1)	103	=item no_drop (0\|1)
100		104
101	Sets the flag FLAG_NO_DROP.	105	Sets the flag FLAG_NO_DROP.
102	See Flags section below.	106	See Flags section below.
103		107
…		…
112	See Flags section below.	116	See Flags section below.
113		117
114	=item auto_apply (0\|1)	118	=item auto_apply (0\|1)
115		119
116	Sets the flag FLAG_AUTO_APPLY.	120	Sets the flag FLAG_AUTO_APPLY.
		121	See Flags section below.
		122
		123	=item no_steal (0\|1)
		124
		125	Sets the flag FLAG_NO_STEAL.
		126	See Flags section below.
		127
		128	=item reflecting (0\|1)
		129
		130	Sets the flag FLAG_REFLECTING.
		131	See Flags section below.
		132
		133	=item reflect_spell (0\|1)
		134
		135	Sets the flag FLAG_REFL_SPELL.
		136	See Flags section below.
		137
		138	=item no_skill_ident (0\|1)
		139
		140	Sets the flag FLAG_NO_SKILL_IDENT.
		141	See Flags section below.
		142
		143	=item activate_on_push (0\|1) (default: 1)
		144
		145	Sets the flag FLAG_ACTIVATE_ON_PUSH.
		146	See Flags section below.
		147
		148	=item activate_on_release (0\|1) (default: 1)
		149
		150	Sets the flag FLAG_ACTIVATE_ON_RELEASE.
117	See Flags section below.	151	See Flags section below.
118		152
119	=item editable (more than deprecated)	153	=item editable (more than deprecated)
120		154
121	This field had a special meaning for crossedit, which used parts	155	This field had a special meaning for crossedit, which used parts
…		…
162	or other objects that have the flags FLAG_GENERATOR and FLAG_CONTENT_ON_GEN set.	196	or other objects that have the flags FLAG_GENERATOR and FLAG_CONTENT_ON_GEN set.
163		197
164	=item FLAG_AUTO_APPLY	198	=item FLAG_AUTO_APPLY
165		199
166	This flag has currently only meaning for the TREASURE type, see below.	200	This flag has currently only meaning for the TREASURE type, see below.
		201
		202	=item FLAG_ACTIVATE_ON_PUSH
		203
		204	This flag has only meaning for objects that can be linked together
		205	with the 'connected' field and controls wether the object should
		206	be activated when the connection is 'pushed' or it is 'released'.
		207
		208	This flag is by default on.
		209
		210	=item FLAG_ACTIVATE_ON_RELEASE
		211
		212	This flag has only meaning for objects that can be linked together
		213	with the 'connected' field and controls wether the object should
		214	be activated when the connection is 'pushed' or it is 'released'.
		215
		216	This flag is by default on.
		217
		218	=item FLAG_NO_STEAL
		219
		220	When this flag is set this object can't be stolen. The flag will be
		221	resetted once the object is placed on a map.
		222
		223	When this flag is set on a monster it can defent attempts of stealing
		224	(but in this context the flag is only used internally).
		225
		226	=item FLAG_NO_SKILL_IDENT
		227
		228	This flag is mostly used internal and prevents unidentified objects
		229	(objects which don't have FLAG_IDENTIFIED set) being identified by
		230	skills.
		231
		232	This flag is used to mark objects to never being identified by a skill
		233	once a player failed to identify an object. So that multiple tries
		234	of identifying aren't more effective than one.
		235
		236	=item FLAG_REFLECTING
		237
		238	This flag is used by spell effects (eg. SP_BOLT), THROWN_OBJ and ARROW
		239	to indicate whether this object reflects off walls.
		240
		241	=item FLAG_REFL_SPELL
		242
		243	This flag indicates whether something reflects spells, like spell reflecting
		244	amuletts.
167		245
168	=back	246	=back
169		247
170	=head2 Description of type specific attributes	248	=head2 Description of type specific attributes
171		249
…		…
301	with the treasurelist specified here. (I guess it's highly undefined what	379	with the treasurelist specified here. (I guess it's highly undefined what
302	happens if there is not a spell in the potions inventory).	380	happens if there is not a spell in the potions inventory).
303		381
304	=item on_use_yield <archetype>	382	=item on_use_yield <archetype>
305		383
306	When this object is applied this object will be created.	384	When this object is applied an instance of <archetype> will be created.
307	This field is also used by FOOD and POISON.
308		385
309	=item subtypes <potion subtype>	386	=item subtypes <potion subtype>
310		387
311	see include/spells.h for possible potion subtypes, there are currently 4:	388	see include/spells.h for possible potion subtypes, there are currently 4:
312		389
…		…
331	Unused, default behaiour of a potion.	408	Unused, default behaiour of a potion.
332		409
333	=back	410	=back
334		411
335	=back	412	=back
		413
		414	=head3 FOOD - type 6 - Eatable stuff
		415
		416	This is for objects that are representing general eatables like
		417	beef or bread.
		418
		419	The main difference between FOOD, FLESH and DRINK is that they
		420	give different messages.
		421
		422	The specialty of FLESH is that it inherits the resistancies of the
		423	monsters it was generated in and will let dragons raise their resistancies
		424	with that. If the monster has the POISON attacktype the FLESH
		425	will change into POISON.
		426
		427	If a player runs low on food he will grab for FOOD, DRINK and POISON
		428	and if he doesn't find any of that he will start eating FLESH.
		429
		430	=over 4
		431
		432	=item title <string>
		433
		434	If the food has a title or is cursed it is considered 'special', which means that the
		435	fields Str, Dex, Con, Int, Wis, Pow, resist_<resistancy>, hp and sp
		436	are interpreted and have further effects on the player.
		437
		438	The higher the food field is the longer the improvement of the player lasts
		439	(except for hp and sp).
		440
		441	=item food <number>
		442
		443	This is the amount of food points the player gets when he eats this.
		444
		445	=item on_use_yield <archetype>
		446
		447	When this object is applied an instance of <archetype> will be created.
		448
		449	=back
		450
		451	=head3 POISON - type 7 - Poisonous stuff
		452
		453	This type is for objects that can poison the player when drinking.
		454	When applied it will hit the attacked with AT_POISON and will create
		455	a POISONING object in the one who was hit.
		456
		457	=over 4
		458
		459	=item level <number>
		460
		461	This field affects the propability of poisoning. The higher the level difference
		462	between the one who is hit and the poision the mose propable it is the attacked
		463	one will be poisoned.
		464
		465	=item slaying <race>
		466
		467	On poison this field has the usual meaning of 'slaying', when the
		468	ones race matches the slaying field the damage done by the poison
		469	is multiplied by 3.
		470
		471	=item hp <number>
		472
		473	This is the amount of damage the player will receive from applying this. The
		474	attacktype AT_POISON will be used to hit the player and the damage will
		475	determine the strenght, duration and depletion of stats of the poisoning. The
		476	created POISONING object which is being placed in the one who was attacked will
		477	get the damage from this field (which is maybe adjusted by slaying or the
		478	resistancies).
		479
		480	=item food <number>
		481
		482	1/4 of <number> will be drained from the players food.
		483
		484	=item on_use_yield <archetype>
		485
		486	When this object is applied an instance of <archetype> will be created.
		487
		488	=back
		489
		490	=head3 BOOK - type 8 - Readable books
		491
		492	This type is basically for representing text books in the game.
		493
		494	Reading a book also identifys it (if FLAG_NO_SKILL_IDENT is not set).
		495
		496	=over 4
		497
		498	=item msg <text>
		499
		500	This is the contents of the book. When this field is unset
		501	at treasure generation a random text will be inserted.
		502
		503	=item skill <skill name>
		504
		505	The skill required to read this book. (The most resonable
		506	skill would be literacy).
		507
		508	=item exp <number>
		509
		510	The experience points the player get for reading this book.
		511
		512	=item subtype <readable subtype>
		513
		514	This field determines the type of the readable.
		515	Please see common/readable.C in the readable_message_types table.
		516
		517	=back
		518
		519	=head3 CLOCK - type 9 - Clocks
		520
		521	This type of objects just display the time when being applied.
		522
		523	=head3 LIGHTNING - type 12 - Lightnings (DEPRECATED, see SPELL_EFFECT subtype SP_BOLT)
		524
		525	This is a spell effect of a moving bolt. It moves straigt forward
		526	through the map until something blocks it.
		527	If FLAG_REFLECTING is set it even reflects on walls.
		528
		529	FLAG_IS_TURNABLE should be set on these objects.
		530
		531	=over 4
		532
		533	=item move_type <movetype>
		534
		535	This field affects the move type with which the lightning moves through
		536	the map and which map cells will reflect or block it.
		537
		538	=item attacktype <attacktype>
		539
		540	The attacktype with which it hits the objects on the map.
		541
		542	=item dam <number>
		543
		544	The damage this bolt inflicts when it hits objects on the map.
		545
		546	=item Dex <number>
		547
		548	This is the fork percentage, it is reduced by 10 per fork.
		549	And the damage is halved on each fork.
		550
		551	=item Con <number>
		552
		553	This value is a percentage of which the forking lightning
		554	is deflected to the left. This value should be mostly used internally.
		555
		556	=item duration <number>
		557
		558	The duration the bolt stays on a map cell. This field is decreased each time
		559	the object is processed (see the meaning of speed and speed_left fields in
		560	the object general description).
		561
		562	=item range <number>
		563
		564	This is the range of the bolt, each space it advances this field is decreased.
		565
		566	=back
		567
336		568
337	=head3 WEAPON - type 15 - Weapons	569	=head3 WEAPON - type 15 - Weapons
338		570
339	This type is for general hack and slash weapons like swords, maces	571	This type is for general hack and slash weapons like swords, maces
340	and daggers and and ....	572	and daggers and and ....
…		…
478	FLAG_XRAYS	710	FLAG_XRAYS
479	FLAG_BLIND	711	FLAG_BLIND
480	FLAG_SEE_IN_DARK	712	FLAG_SEE_IN_DARK
481	FLAG_UNDEAD	713	FLAG_UNDEAD
482		714
		715	=head3 GRIMREAPER - type 28 - Grimreapers
		716
		717	These type are mostly used for monsters, they give the
		718	monster the ability to dissapear after 10 hits with AT_DRAIN.
		719
		720	=over 4
		721
		722	=item value <number>
		723
		724	This field stores the hits the monster did yet.
		725
		726	=back
		727
		728	=head3 DRINK - type 54 - Drinkable stuff
		729
		730	See FOOD description.
		731
		732	=head3 CHECK_INV - type 64 - Inventory checkers
		733
		734	This object checks whether the player has a specific item in his
		735	inventory when he moves above the inventory checker. If the player has
		736	the item (or not, which can be controlled with a flag) a connection will be triggered.
		737
		738	If you set move_block you can deny players and monsters to reach the space where
		739	the inventory checker is on, see 'move_block' description below.
		740
		741	The conditions specified by hp, slaying and race are concationated with OR.
		742	So matching one of those conditions is enough.
		743
		744	=over 4
		745
		746	=item move_block <move type bitmask>
		747
		748	If you set this field to block a movetype the move code will block any moves
		749	onto the space with the inventory checker, IF the moving object doesn't have
		750	(or has - if last_sp = 0) the item that the checker is searching for.
		751
		752	=item last_sp (0\|1)
		753
		754	If last_sp is 1 'having' the item that is being checked for will
		755	activate the connection or make the space with the checker non-blocking.
		756	If last_sp is 0 'not having' the item will activate the connection
		757	or make the space with the checker non-blocking.
		758
		759	=item last_heal (0\|1)
		760
		761	If last_heal is 1 the matching item will be removed if the inventory checker
		762	activates a connection and finds the item in the inventory.
		763
		764	(A inventory checker that blocks a space won't remove anything from inventories)
		765
		766	=item hp <number>
		767
		768	If this field is not 0 the inventory checker will search for an object
		769	with the type id <number>.
		770
		771	=item slaying <string>
		772
		773	If this field is set the inventory checker will search for an object that
		774	has the same string in the slaying field (for example a key string of a key).
		775
		776	=item race <string>
		777
		778	If this field is set the inventory checker will search for an object which
		779	has the archetype name that matches <string>.
		780
		781	=item connected <connection id>
		782
		783	This is the connection that will be activated.
		784
		785	=back
		786
		787	=head3 FLESH - type 72 - Organs and body parts
		788
		789	See FOOD description.
		790
		791	=head3 MISC_OBJECT - type 79 - Misc. objects
		792
		793	A type for any object that has no special behaviour.
		794
		795	=head3 HOLE - type 94 - Holes
		796
		797	Holes are holes in the ground where objects can fall through. When the hole
		798	opens and/or is completly open all objects above it fall through (more
		799	precisely: if their head is above the hole).
		800
		801	Trapdoors can only transfer the one who falls through to other coordinates
		802	on the B<same> map.
		803
		804	=over 4
		805
		806	=item maxsp (0\|1)
		807
		808	This field negates the state of the connection: When maxsp is 1 the pit will
		809	open/close when the connection is deactivated. Otherwise it will open/close
		810	when the connection is activated. This field only has effect when the
		811	connection is triggered. So if you put a closed hole on a map, and the
		812	connection is deactivated, and maxsp is 1 the hole will remain closed until the
		813	connection was triggered once.
		814
		815	=item connected <connection id>
		816
		817	This is the connection id, which lets the hole opening or closing when
		818	activated. The flags FLAG_ACTIVATE_ON_PUSH and FLAG_ACTIVATE_ON_RELEASE control
		819	at which connection state the object is activated.
		820
		821	For example: if FLAG_ACTIVATE_ON_RELEASE is set to 0 the hole won't react when
		822	the connection is released.
		823
		824	=item wc <number> (internal)
		825
		826	This is an internal flag. If it is greater than 0 it means that the hole is not
		827	yet fully open. More preciesly: this field is the animation-step and if it is
		828	set to the 'closed' step of the animation the hole is closed and if it is on
		829	the 'open' animation step (wc = 0), the hole is open.
		830
		831	=item sp <number>
		832
		833	The destination y coordinates on the same map.
		834
		835	=item hp <number>
		836
		837	The destination x coordinates on the same map.
		838
		839	=back
		840
		841	=head3 POISONING - type 105 - The poisoning of players and monsters
		842
		843	This type is doing the actual damage to the ones who were attacked
		844	via AT_POISON (or drank POISON).
		845
		846	The duration is handled via the FLAG_IS_USED_UP mechanism (please look
		847	there for details).
		848
		849	=over 4
		850
		851	=item dam <number>
		852
		853	Each time the poisoning is processed (which is determined by the speed and speed_left
		854	fields, see the general object attributes above) it hits the player with
		855	<number> damage and the AT_INTERNAL attacktype (means: it will simply
		856	hit the player with no strings attached).
		857
		858	=item food <number>
		859
		860	Just a note: The posion is removed when food == 1 and not when
		861	the whole duration is up, because the POISONING code has to remove
		862	the poison-effects from the player before the FLAG_IS_USED_UP mechanism
		863	deletes the POISONING object.
		864
		865	=back
		866
483	=head3 FORCE - type 114 - Forces	867	=head3 FORCE - type 114 - Forces
484		868
485	Forces are a very 'thin' type. They don't have much behaviour other than	869	Forces are a very 'thin' type. They don't have much behaviour other than
486	disappearing after a time and/or affecting the player if they are in his inventory.	870	disappearing after a time and/or affecting the player if they are in his
		871	inventory.
487		872
488	Forces only take effect on the player if they have set FLAG_APPLIED.	873	Forces only take effect on the player if they have set FLAG_APPLIED.
489		874
490	Whether the duration field is processed or not a tick is controlled via the	875	Whether the duration field is processed or not a tick is controlled via the
491	speed and speed_left field. Look above at the generic description of these	876	speed and speed_left field. Look above at the generic description of these
492	fields.	877	fields.
493		878
		879	NOTE: Setting FLAG_IS_USED_UP on an force will also consider the 'food' field
		880	like stated above in the FLAG_IS_USED_UP description. BUT: If the food field reaches
		881	0 before duration and FLAG_APPLIED is set, the force will last for 'duration'.
		882	If the FLAG_APPLIED is not set the force is removed when food reaches 0.
		883	Generally this means: FLAG_IS_USED_UP doesn't have good semantics on forces.
		884
494	=over 4	885	=over 4
495		886
496	=item duration	887	=item duration
497		888
498	While this field is greater than 0 the force/object is not destroyed.	889	While this field is greater than 0 the force/object is not destroyed. It is
499	It is decreased each tick by 1.	890	decreased each tick by 1.
500		891
501	If it reaches 0 the force/object is destroyed.	892	If it reaches 0 the force/object is destroyed.
502		893
503	This field can have this meaning for B<any> object if that object has	894	This field can have this meaning for B<any> object if that object has
504	FLAG_IS_USED_UP and FLAG_APPLIED set. See the description of FLAG_IS_USED_UP	895	FLAG_IS_USED_UP and FLAG_APPLIED set. See the description of FLAG_IS_USED_UP
…		…
506		897
507	=back	898	=back
508		899
509	=head3 POTION_EFFECT - type 115 - Potion effects (resistancies)	900	=head3 POTION_EFFECT - type 115 - Potion effects (resistancies)
510		901
511	This object is generated by the POTION code when the potion is a	902	This object is generated by the POTION code when the potion is a resistance
512	resistance giving potion. It has mainly the same behaviour as a FORCE.	903	giving potion. It has mainly the same behaviour as a FORCE.
513		904
514	The specialty of the potion effect is that the resistancy it gives is absolute,	905	The specialty of the potion effect is that the resistancy it gives is absolute,
515	so if you drin a resistancy potion of fire+60 you will get 60% resistancy to fire.	906	so if you drin a resistancy potion of fire+60 you will get 60% resistancy to
		907	fire.
516		908
517	Multiple potion effects only give you the maximum of their resistancy.	909	Multiple potion effects only give you the maximum of their resistancy.

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing deliantra/server/pod/objects.pod (file contents): Revision 1.4 by elmex, Mon Dec 18 16:53:04 2006 UTC vs. Revision 1.13 by elmex, Wed Dec 20 13:07:13 2006 UTC

Diff Legend

Comparing deliantra/server/pod/objects.pod (file contents):
Revision 1.4 by elmex, Mon Dec 18 16:53:04 2006 UTC vs.
Revision 1.13 by elmex, Wed Dec 20 13:07:13 2006 UTC