ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/Deliantra/res/types.xml
Revision: 1.21
Committed: Wed Dec 20 19:19:05 2006 UTC (17 years, 5 months ago) by elmex
Content type: text/xml
Branch: MAIN
CVS Tags: rel-0_96
Changes since 1.20: +7 -1 lines
Log Message:
added description of the speed field of creators to types.xml.

File Contents

# Content
1 <?xml version="1.0" standalone="no" ?>
2 <!--
3 ######################################################################
4 # types.xml - This is the definitions-file for all the different #
5 # Crossfire object types and their attributes. #
6 # #
7 # The server code of the Crossfire game is always changing and #
8 # evolving. From time to time, object-attributes change in purpose, #
9 # or new ones are created. #
10 # Therefore, it is important that an Editor is flexible and #
11 # easy to "upgrade" to handle such new features. That's why the #
12 # CFJavaEditor reads the type-definitions from this xml file. #
13 # #
14 # If you encounter bugs, typos or missing entries in the LATEST #
15 # VERSION of this file - Don't hesitate to improve it, contact me #
16 # and eventually send the improved file to me: <red.blaze@gmx.net>. #
17 # I will put it into the "official version" of the CFJavaEditor #
18 # and all fellow Crossfire-Map-Makers can benefit from your work! #
19 # #
20 # IMPORTANT: Make a backup copy of this file before you start #
21 # to modify it! #
22 # #
23 # New types must be inserted maintaining the alphabetical order. #
24 # #
25 # about the 'type' elements: #
26 # #
27 # <type number="15" name="Type Name"> #
28 # <import_type name="Type Name" /> import attributes of this type #
29 # <required> #
30 # list of required attributes to identifying this type #
31 # </required> #
32 # <ignore> #
33 # list of attributes not to import from default_type #
34 # </ignore> #
35 # <description><![CDATA[ #
36 # Description of this type. ]]> #
37 # </description> #
38 # <use><![CDATA[ #
39 # How to use this type. ]]> #
40 # </use> #
41 # ... attributes ... #
42 # </type> #
43 # #
44 # about the 'attribute' type: <attribute ... type="XXX" > #
45 # #
46 # bool - This attribute can only be set to '1' or '0' #
47 # int - This attribute contains a decimal number #
48 # float - This attr. contains a floating point number #
49 # string - This attribute contains a string #
50 # text - This attribute contains a text ("text" can have #
51 # linebreaks, unlike "string") #
52 # fixed - This attribute is always set to a fixed 'value' #
53 # (There is no user-input for this attribute) #
54 # spell - This attribute contains a spell. The mapmaker can #
55 # choose spells from a combo box. #
56 # nz_spell - works just like 'spell', except that the #
57 # spell-value zero is always interpreted as <none>, #
58 # never as "magic bullet" #
59 # bool_special - Like bool, but with customized true/false values #
60 # treasurelist - CF treasure list (see "treasures" file) #
61 # list_LISTNAME - list, must be defined as a <list> element #
62 # bitmask_BITMASKNAME - bitmask, must be defined as a <bitmask> #
63 # element #
64 # #
65 # Created by Andreas Vogl. #
66 ######################################################################
67 -->
68 <!DOCTYPE types [
69 <!ELEMENT types ((bitmask | list | ignore_list)*, default_type, ignore_list*, type+)>
70
71 <!ELEMENT bitmask (entry*)>
72 <!ATTLIST bitmask name CDATA #REQUIRED>
73
74 <!ELEMENT list (entry*)>
75 <!ATTLIST list name CDATA #REQUIRED>
76
77 <!ELEMENT entry EMPTY>
78 <!ATTLIST entry bit CDATA #IMPLIED
79 value CDATA #IMPLIED
80 name CDATA #REQUIRED>
81
82 <!ELEMENT ignore_list (attribute* | EMPTY)>
83 <!ATTLIST ignore_list name CDATA #REQUIRED>
84
85 <!ELEMENT default_type (attribute*)>
86
87 <!ELEMENT type (import_type?,required?,ignore?,description?,use?,(section | attribute)*)>
88 <!ATTLIST type name CDATA #REQUIRED
89 number CDATA #REQUIRED>
90
91 <!ELEMENT description (#PCDATA)>
92 <!ELEMENT use (#PCDATA)>
93
94 <!ELEMENT import_type EMPTY>
95 <!ATTLIST import_type name CDATA #REQUIRED>
96
97 <!ELEMENT required (attribute+)>
98 <!ELEMENT ignore (attribute*,ignore_list*)>
99
100 <!ELEMENT section (attribute+)>
101 <!ATTLIST section name CDATA #REQUIRED>
102
103 <!ELEMENT attribute (#PCDATA)>
104 <!ATTLIST attribute type CDATA #IMPLIED
105 arch CDATA #IMPLIED
106 arch_begin CDATA #IMPLIED
107 arch_end CDATA #IMPLIED
108 editor CDATA #IMPLIED
109 value CDATA #IMPLIED
110 length CDATA #IMPLIED
111 true CDATA #IMPLIED
112 false CDATA #IMPLIED>
113
114 <!ENTITY move_on "
115 <attribute arch='move_on' editor='movement type' type='bitmask_movement_type'>
116 Which movement types automatically (as opposed to manually) activate this object.
117 </attribute>
118 ">
119 <!ENTITY move_off "
120 <attribute arch='move_off' editor='movement type' type='bitmask_movement_type'>
121 Which movement types deactivate this object (e.g. button).
122 </attribute>
123 ">
124 <!ENTITY move_type "
125 <attribute arch='move_type' editor='movement type' type='bitmask_movement_type'>
126 Determines which kinds of movement this object can use (e.g. for monsters)
127 or grants (e.g. for amulets).
128 </attribute>
129 ">
130 <!ENTITY movement_types_terrain "
131 <attribute arch='move_block' editor='blocked movement' type='bitmask_movement_type'>
132 Objects using these movement types cannot move over this space.
133 </attribute>
134 <attribute arch='move_allow' editor='allowed movement' type='bitmask_movement_type'>
135 Objects using these movement types are allowed to move over this space. Takes
136 precedence over 'blocked movements'.
137 </attribute>
138 <attribute arch='move_slow' editor='slowed movement' type='bitmask_movement_type'>
139 The types of movement that should by slowed down by the 'slow movement penalty'.
140 </attribute>
141 <attribute arch='move_slow_penalty' editor='slow movement penalty' type='int'>
142 If &lt;slow movement&gt; is set to a value greater zero, all
143 creatures matching 'slow move' will be slower than normal on this spot.
144
145 &lt;slow movement&gt; 1 - rough terrain
146 &lt;slow movement&gt; 2 - very rough terrain
147 ...
148 &lt;slow movement&gt; 5 - default for deep swamp
149 ...
150 &lt;slow movement&gt; 7 - spider web (sticky as hell)
151 </attribute>
152 ">
153 <!ENTITY speed_left "
154 <attribute arch='speed_left' editor='speed left' type='float'>
155 The speed left to the object. On every tick, if this value is higher
156 than 0, the object acts/triggers/moves etc. and the value gets
157 decremented by 1. Otherwise, it is incremented by &lt;speed&gt; on
158 every tick.
159 </attribute>
160 ">
161 <!ENTITY activate_on "
162 <attribute arch='activate_on_push' editor='Activate on push' type='bool'>
163 Whether the teleporter should only be activated on push.
164 </attribute>
165 <attribute arch='activate_on_release' editor='Activate on release' type='bool'>
166 Whether the teleporter should only be activated on release.
167 </attribute>
168 ">
169 ]>
170
171 <types>
172
173 <!--###################### bitmask definitions ######################-->
174
175 <bitmask name="attacktype">
176 <entry bit="0" name="Physical" />
177 <entry bit="1" name="Magical" />
178 <entry bit="2" name="Fire" />
179 <entry bit="3" name="Electricity" />
180 <entry bit="4" name="Cold" />
181 <entry bit="5" name="Confusion" />
182 <entry bit="6" name="Acid" />
183 <entry bit="7" name="Drain" />
184 <entry bit="8" name="Weaponmagic" />
185 <entry bit="9" name="Ghosthit" />
186 <entry bit="10" name="Poison" />
187 <entry bit="11" name="Slow" />
188 <entry bit="12" name="Paralyze" />
189 <entry bit="13" name="Turn Undead" />
190 <entry bit="14" name="Fear" />
191 <entry bit="15" name="Cancellation" />
192 <entry bit="16" name="Depletion" />
193 <entry bit="17" name="Death" />
194 <entry bit="18" name="Chaos" />
195 <entry bit="19" name="Counterspell" />
196 <entry bit="20" name="God Power" />
197 <entry bit="21" name="Holy Power" />
198 <entry bit="22" name="Blinding" />
199 </bitmask>
200
201 <bitmask name="material">
202 <entry bit="0" name="Paper" />
203 <entry bit="1" name="Iron" />
204 <entry bit="2" name="Glass" />
205 <entry bit="3" name="Leather" />
206 <entry bit="4" name="Wood" />
207 <entry bit="5" name="Organics" />
208 <entry bit="6" name="Stone" />
209 <entry bit="7" name="Cloth" />
210 <entry bit="8" name="Adamantite" />
211 <entry bit="9" name="Liquid" />
212 <entry bit="10" name="Soft Metal" />
213 <entry bit="11" name="Bone" />
214 <entry bit="12" name="Ice" />
215 <entry bit="13" name="(supress name on display)" />
216
217 </bitmask>
218
219 <bitmask name="spellpath">
220 <entry bit="0" name="Protection" />
221 <entry bit="1" name="Fire" />
222 <entry bit="2" name="Frost" />
223 <entry bit="3" name="Electricity" />
224 <entry bit="4" name="Missiles" />
225 <entry bit="5" name="Self" />
226 <entry bit="6" name="Summoning" />
227 <entry bit="7" name="Abjuration" />
228 <entry bit="8" name="Restoration" />
229 <entry bit="9" name="Detonation" />
230 <entry bit="10" name="Mind" />
231 <entry bit="11" name="Creation" />
232 <entry bit="12" name="Teleportation" />
233 <entry bit="13" name="Information" />
234 <entry bit="14" name="Transmutation" />
235 <entry bit="15" name="Transferrence" />
236 <entry bit="16" name="Turning" />
237 <entry bit="17" name="Wounding" />
238 <entry bit="18" name="Death" />
239 <entry bit="19" name="Light" />
240 </bitmask>
241
242 <bitmask name="will_apply">
243 <entry bit="0" name="Apply Handles" />
244 <entry bit="1" name="Open Chests" />
245 <entry bit="2" name="Break Walls" />
246 <entry bit="3" name="Open Doors" />
247 </bitmask>
248
249 <bitmask name="pick_up">
250 <entry bit="0" name="Nothing" />
251 <entry bit="1" name="Wealth" />
252 <entry bit="2" name="Food" />
253 <entry bit="3" name="Weapons" />
254 <entry bit="4" name="Armour" />
255 <entry bit="5" name="Inverse" />
256 <entry bit="6" name="All" />
257 </bitmask>
258
259 <bitmask name="movement_type">
260 <entry bit="0" name="Walk" />
261 <entry bit="1" name="Fly Low" />
262 <entry bit="2" name="Fly High" />
263 <entry bit="3" name="Swim" />
264 <entry bit="4" name="Boat" />
265 <entry bit="16" name="Other" />
266 </bitmask>
267
268 <!--###################### list definitions ######################-->
269
270 <list name="direction">
271 <entry value="0" name="&lt;none&gt;" />
272 <entry value="1" name="north" />
273 <entry value="2" name="northeast" />
274 <entry value="3" name="east" />
275 <entry value="4" name="southeast" />
276 <entry value="5" name="south" />
277 <entry value="6" name="southwest" />
278 <entry value="7" name="west" />
279 <entry value="8" name="northwest" />
280 </list>
281
282 <list name="mood">
283 <entry value="0" name="furious" />
284 <entry value="1" name="angry" />
285 <entry value="2" name="calm" />
286 <entry value="3" name="sleep" />
287 <entry value="4" name="charm" />
288 </list>
289
290 <list name="potion_effect">
291 <entry value="0" name="&lt;none&gt;" />
292 <entry value="65536" name="life restoration" />
293 <entry value="1048576" name="improvement" />
294 </list>
295
296 <list name="weapon_type">
297 <entry value="0" name="&lt;unknown&gt;" />
298 <entry value="1" name="sword" />
299 <entry value="2" name="arrows" />
300 <entry value="3" name="axe" />
301 <entry value="4" name="katana" />
302 <entry value="5" name="knife, dagger" />
303 <entry value="6" name="whip, chain" />
304 <entry value="7" name="hammer, flail" />
305 <entry value="8" name="club, stick" />
306 </list>
307
308 <list name="skill_type">
309 <entry value="1" name="lockpicking" />
310 <entry value="2" name="hiding" />
311 <entry value="3" name="smithery" />
312 <entry value="4" name="bowyer" />
313 <entry value="5" name="jeweler" />
314 <entry value="6" name="alchemy" />
315 <entry value="7" name="stealing" />
316 <entry value="8" name="literacy" />
317 <entry value="9" name="bargaining" />
318 <entry value="10" name="jumping" />
319 <entry value="11" name="detect magic" />
320 <entry value="12" name="oratory" />
321 <entry value="13" name="singing" />
322 <entry value="14" name="detect curse" />
323 <entry value="15" name="find traps" />
324 <entry value="16" name="mediatation" />
325 <entry value="17" name="punching" />
326 <entry value="18" name="flame touch" />
327 <entry value="19" name="karate" />
328 <entry value="20" name="climbing" />
329 <entry value="21" name="woodsman" />
330 <entry value="22" name="inscription" />
331 <entry value="23" name="one handed weapons" />
332 <entry value="24" name="missile weapons" />
333 <entry value="25" name="throwing" />
334 <entry value="26" name="use magic item" />
335 <entry value="27" name="disarm traps" />
336 <entry value="28" name="set traps" />
337 <entry value="29" name="thaumaturgy" />
338 <entry value="30" name="praying" />
339 <entry value="31" name="clawing" />
340 <entry value="32" name="levitation" />
341 <entry value="33" name="summoning" />
342 <entry value="34" name="pyromancy" />
343 <entry value="35" name="evocation" />
344 <entry value="36" name="sorcery" />
345 <entry value="37" name="two handed weapons" />
346 </list>
347
348 <list name="spell_type">
349 <entry value="1" name="raise dead" />
350 <entry value="2" name="rune" />
351 <entry value="3" name="make mark" />
352 <entry value="4" name="bolt" />
353 <entry value="5" name="bullet" />
354 <entry value="6" name="explosion" />
355 <entry value="7" name="cone" />
356 <entry value="8" name="bomb" />
357 <entry value="9" name="wonder" />
358 <entry value="10" name="smite" />
359 <entry value="11" name="magic missile" />
360 <entry value="12" name="summon golem" />
361 <entry value="13" name="dimension door" />
362 <entry value="14" name="magic mapping" />
363 <entry value="15" name="magic wall" />
364 <entry value="16" name="destruction" />
365 <entry value="17" name="perceive self" />
366 <entry value="18" name="word of recall" />
367 <entry value="19" name="invisible" />
368 <entry value="20" name="probe" />
369 <entry value="21" name="healing" />
370 <entry value="22" name="create food" />
371 <entry value="23" name="earth to dust" />
372 <entry value="24" name="change ability" />
373 <entry value="25" name="bless" />
374 <entry value="26" name="curse" />
375 <entry value="27" name="summon monster" />
376 <entry value="28" name="recharge" />
377 <entry value="29" name="polymorph" />
378 <entry value="30" name="alchemy" />
379 <entry value="31" name="remove curse" />
380 <entry value="32" name="identify" />
381 <entry value="33" name="detection" />
382 <entry value="34" name="mood change" />
383 <entry value="35" name="moving ball" />
384 <entry value="36" name="swarm" />
385 <entry value="37" name="charge mana" />
386 <entry value="38" name="dispel rune" />
387 <entry value="39" name="create missile" />
388 <entry value="40" name="consecrate" />
389 <entry value="41" name="animate weapon" />
390 <entry value="42" name="light" />
391 <entry value="43" name="change map light" />
392 <entry value="44" name="faery fire" />
393 <entry value="45" name="disease" />
394 <entry value="46" name="aura" />
395 <entry value="47" name="town portal" />
396 </list>
397
398 <list name="event_type">
399 <entry value="0" name="none" />
400 <entry value="1" name="apply" />
401 <entry value="2" name="attack" />
402 <entry value="3" name="death" />
403 <entry value="4" name="drop" />
404 <entry value="5" name="pickup" />
405 <entry value="6" name="say" />
406 <entry value="7" name="stop" />
407 <entry value="8" name="time" />
408 <entry value="9" name="throw" />
409 <entry value="10" name="trigger" />
410 <entry value="11" name="close" />
411 <entry value="12" name="timer" />
412 <entry value="28" name="move" />
413 <entry value="41" name="drop_on" />
414 </list>
415
416 <list name="attack_movement_bits_0_3">
417 <entry value="0" name="default" />
418 <entry value="1" name="attack from distance" />
419 <entry value="2" name="run away" />
420 <entry value="3" name="hit and run" />
421 <entry value="4" name="wait, then hit, then move" />
422 <entry value="5" name="rush blindly" />
423 <entry value="6" name="always run" />
424 <entry value="7" name="attack from distance if hit" />
425 <entry value="8" name="do not approach" />
426 </list>
427
428 <list name="attack_movement_bits_4_7">
429 <entry value="0" name="none" />
430 <entry value="16" name="pet" />
431 <entry value="32" name="small circle" />
432 <entry value="48" name="large circle" />
433 <entry value="64" name="small horizontal" />
434 <entry value="80" name="large horizontal" />
435 <entry value="96" name="random direction" />
436 <entry value="112" name="random movement" />
437 <entry value="128" name="small vertical" />
438 <entry value="144" name="large vertical" />
439 </list>
440
441 <!--###################### default attributes ######################-->
442
443 <!--
444 The attributes of the default_type get added to all other types by default.
445 Every type can have an 'ignore' element however, which is used to specify
446 default attributes *not* to inherit.
447 -->
448 <default_type>
449 <attribute arch="name" editor="name" type="string">
450 This is the name of the object, displayed to the player.
451 </attribute>
452 <attribute arch="name_pl" editor="plural name" type="string">
453 This is the plural name of the object. A plural name must be set for
454 all items that can be picked up and collected by the player.
455 </attribute>
456 <attribute arch="title" editor="title" type="string">
457 This is the object's title. Once an object is identified the title is
458 attached to the name. Typical titles are "of Mostrai", "of xray vision" etc.
459 </attribute>
460 <attribute arch="face" editor="image" type="string">
461 The image-name defines what image is displayed for this object in-game.
462 </attribute>
463 <attribute arch="nrof" editor="number" type="int">
464 This value determines the number of objects in one stack (for example:
465 100 goldcoins =&gt; "number = 100"). You should set this at least to one, for
466 any pickable object - otherwise it won't be mergeable into a stack.
467 </attribute>
468 <attribute arch="weight" editor="weight" type="int">
469 This value defines the object's weight in grams (1000g is 1kg). Objects with
470 zero weight are not pickable for players. Still, set the "non-pickable"-flag
471 for explicitly non-pickable objects (hey, this is opensource.. you
472 never know ;) ).
473 </attribute>
474 <attribute arch="value" editor="value" type="int">
475 Determines the value of the object, in units of silver coins (one
476 platinum coin == 50 silver coins). Value for buying/selling will be
477 further modified by various factors. Hence, testing values in-game is
478 usually inevitable.
479 </attribute>
480 <attribute arch="glow_radius" editor="glow radius" type="int">
481 If &lt;glow radius&gt; is set to a value greater zero, the object
482 appears lit up on dark maps. &lt;glow radius&gt; can be a value
483 between 0 and 4, the higher, the more light does the object emit.
484 </attribute>
485 <attribute arch="material" editor="material" type="bitmask_material">
486 This bitmask-value informs the player of which material(s) the
487 object consists. Material does also affect how likely the object
488 can be destroyed by hazardous spell-effects.
489 </attribute>
490 <attribute arch="no_pick" editor="non-pickable" type="bool">
491 If set, the object cannot be picked up (Neither by players nor monsters).
492 </attribute>
493 <attribute arch="invisible" editor="invisible" type="bool">
494 Generally makes the object invisible. Depending on the object-type,
495 some can be made visible by the show_invisible spell. If in doubt, test it.
496 Putting an invisible object under the floor always prevents it from being
497 shown.
498 </attribute>
499 <attribute arch="blocksview" editor="block view" type="bool">
500 If an item is set to block view, players (and monsters) cannot
501 see byond it unless they cross it or manage to stand ontop.
502 </attribute>
503 <attribute arch="identified" editor="identified" type="bool">
504 If an item is identified, the player has full knowledge about it.
505 </attribute>
506 <attribute arch="unpaid" editor="unpaid" type="bool">
507 An &lt;unpaid&gt; item cannot be used unless a player carried it over
508 a shop mat, paying the demanded price. Setting this flag makes sense
509 only for pickable items inside shops.
510 </attribute>
511 </default_type>
512
513 <!-- This ignorelist is for all system objects which are non pickable
514 and invisible. They don't interact with players at all. -->
515 <ignore_list name="system_object">
516 <attribute arch="value" />
517 <attribute arch="nrof" />
518 <attribute arch="weight" />
519 <attribute arch="name_pl" />
520 <attribute arch="material" />
521 <attribute arch="no_pick" />
522 <attribute arch="unpaid" />
523 <attribute arch="title" />
524 <attribute arch="glow_radius" />
525 <attribute arch="identified" />
526 <attribute arch="blocksview" />
527 <attribute arch="invisible" />
528 </ignore_list>
529
530 <!-- This ignorelist is for non-pickable objects. They can be seen by
531 the player, but don't have values like material or weight. -->
532 <ignore_list name="non_pickable">
533 <attribute arch="value" />
534 <attribute arch="nrof" />
535 <attribute arch="weight" />
536 <attribute arch="name_pl" />
537 <attribute arch="material" />
538 <attribute arch="no_pick" />
539 <attribute arch="unpaid" />
540 <attribute arch="title" />
541 <attribute arch="identified" />
542 </ignore_list>
543
544 <!--####################################################################-->
545 <type number="0" name="Misc">
546 <required>
547 <!-- this is a special case: The "misc" type with type number 0 is
548 the fallback for all types which don't match any other defined types.
549 The required attribute "misc x" prevents that it gets confused with
550 other types like "monster & npc" which also have type number 0. -->
551 <attribute arch="misc" value="x" />
552 </required>
553 &movement_types_terrain;
554 <attribute arch="cursed" editor="cursed" type="bool">
555 Curses can have various effects: On equipment and food,
556 they generally harm the player in some way.
557 </attribute>
558 <attribute arch="damned" editor="damned" type="bool">
559 A damned item/floor on the ground makes it impossible for players
560 to use prayers on that spot. It also prevents players from saving.
561 Damnation on equipment works similar to a curse.
562 </attribute>
563 <attribute arch="unique" editor="unique item" type="bool">
564 Unique items exist only one time on a server. If the item
565 is taken, lost or destroyed - it's gone for good.
566 </attribute>
567 <attribute arch="startequip" editor="godgiven item" type="bool">
568 A godgiven item vanishes as soon as the player
569 drops it to the ground.
570 </attribute>
571 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
572 This text may describe the object.
573 </attribute>
574 </type>
575
576 <!--####################################################################-->
577 <type number="110" name="Ability">
578 <ignore>
579 <ignore_list name="system_object" />
580 </ignore>
581 <description><![CDATA[
582 Abilities are to be put in a monster's inventory. They grant monsters the
583 knowledge to cast spells. Spells from abilities are usually magical in
584 nature, thus adding magic attacktype to the spell-damage they produce.
585 <br><br>
586 A particularly nice feature of abilities is that they can hold two
587 spells: One for short range- and one for long range use.
588 \n\n
589 You should know that spellcasting monsters receive abilities via
590 &lt;treasurelist&gt;. ]]>
591 </description>
592 <use><![CDATA[
593 If you want to create "customized" spellcasting monsters, you
594 should use abilities (rather than spellbooks/wands or something).
595 The long/short-range spell feature can make boss-monsters more
596 interesting and challenging.
597 <br><br>
598 You should keep in mind that magic abilities allow players
599 to get better resistance. You can turn off the magic part to
600 make the spells more dangerous. However, this really shouldn't
601 be neccessary unless you work on very high level maps.
602 And what fun is a magic resistance cloak when it has no effect? ]]>
603 </use>
604 <attribute arch="invisible" value="1" type="fixed" />
605 <attribute arch="no_drop" value="1" type="fixed" />
606 <attribute arch="sp" editor="short range spell" type="spell">
607 The monster will use the specified &lt;short range spell&gt;
608 when the player is within 6-square radius (of the
609 monster's head).
610 </attribute>
611 <attribute arch="hp" editor="long range spell" type="nz_spell">
612 The monster will use the specified &lt;long range spell&gt;
613 when the player is at least 6 squares away (from the
614 monster's head).
615
616 Setting a &lt;long range spell&gt; is optional. If unset, the
617 &lt;short range spell&gt; gets used all the time.
618 </attribute>
619 <attribute arch="maxsp" editor="importance" type="int">
620 Sometimes you'll want a monster to use one ability more than others.
621 To achieve this, set the &lt;importance&gt; to a value greater than
622 one. Abilities with this value zero/unset are counted to be of
623 &lt;importance&gt; one.
624
625 Example: A monster with "small fireball" of &lt;importance&gt; 3 and
626 "paralyze" of &lt;importance&gt; 1 will averagely cast three out of four
627 times the "small fireball".
628 </attribute>
629 <attribute arch="attacktype" editor="is magical" true="2" false="0" type="bool_special">
630 This flag specifies whether the ability &lt;is magical&gt; in nature.
631 If enabled, all spells produced by this ability will have magic
632 attacktype added to the usual attacktypes.
633
634 This should always be set for spell-like abilities. "Natural"
635 abilities like a dragon's firebreath are an exception.
636 Note that non-magical abilities are more dangerous because
637 magic resistance does not protect from those.</attribute>
638 </type>
639
640 <!--####################################################################-->
641 <type number="18" name="Altar">
642 <ignore>
643 <ignore_list name="non_pickable" />
644 </ignore>
645 <description><![CDATA[
646 When a player puts a defined number of certain items on the altar,
647 then either a spell is casted (on the player) or a connector is
648 triggered. If the latter is the case, the altar works only once.
649 Either way, the sacrificed item disappears. ]]>
650 </description>
651 <attribute arch="no_pick" value="1" type="fixed" />
652 &move_on;
653 <attribute arch="slaying" editor="match item name" type="string">
654 This string specifies the item that must be put on the altar to
655 activate it. It can either be the name of an archetype, or directly
656 the name of an object. Yet, titles are not recognized by altars.
657 Remember to put a note somewhere, telling the player what he is
658 expected to drop on the altar. (Often this is put in the altar's
659 name: E.g. "drop 100 platinums")
660 </attribute>
661 <attribute arch="food" editor="drop amount" type="int">
662 The drop amount specifies the amount of items (specified
663 in &lt;match item name&gt;) that must be dropped to activate the altar.
664
665 If &lt;match item name&gt; is set to "money", then the value of the
666 sacrificed money must be equal to &lt;drop amount&gt; (ie, if food=200, then
667 200 silver, 20 gold, or 4 platinum will all work.)
668
669 Note that the maximum possible for &lt;drop amount&gt; is 32767.
670 </attribute>
671 <attribute arch="connected" editor="connection" type="int">
672 If a connection value is set, the altar will trigger all objects
673 with the same value, when activated. This will only work once.
674 </attribute>
675 <attribute arch="sp" editor="spell" type="spell">
676 When activated, the selected &lt;spell&gt; will be casted (once, on the
677 player). This should work for any given spell. The altar will work
678 infinitely in this way. Don't set both &lt;spell&gt; and &lt;connection&gt; for
679 one altar.
680 </attribute>
681 <attribute arch_begin="msg" arch_end="endmsg" editor="message" type="text">
682 This text will be displayed to the player
683 in the exact moment when the altar is activated.
684 </attribute>
685 </type>
686
687 <!--####################################################################-->
688 <type number="31" name="Altar Trigger">
689 <ignore>
690 <ignore_list name="non_pickable" />
691 </ignore>
692 <description><![CDATA[
693 Altar_triggers work pretty much like normal altars
694 (drop sacrifice -> connection activated), except for the fact that
695 they reset after usage. Hence, altar_triggers can be used infinitely. ]]>
696 </description>
697 <use><![CDATA[
698 Altar_triggers are very useful if you want to charge a price for...
699 <UL>
700 <LI> ...an item. -> Connect the altar_trigger (set "last_sp 1") to a creator.
701 <LI> ...opening a gate. -> Connect the altar_trigger (set "last_sp 0") to the gate.
702 <LI> ...information. -> Connect the altar_trigger (set "last_sp 1") to a magic_mouth.
703 </UL>
704 The big advantage over normal altars is the infinite usability
705 of altar_triggers! If there are ten players on one server, they're
706 quite grateful if things work more than once. =) ]]>
707 </use>
708 <attribute arch="no_pick" value="1" type="fixed" />
709 <attribute arch="slaying" editor="match item name" type="string">
710 This string specifies the item that must be put on the altar to
711 activate it. It can either be the name of an archetype, or directly
712 the name of an object. Yet, titles are not recognized by altars.
713 Remember to put a note somewhere, telling the player what he is
714 expected to drop on the altar. (Often this is put in the altar's
715 name: E.g. "drop 100 platinums")
716 </attribute>
717 <attribute arch="food" editor="drop amount" type="int">
718 The drop amount specifies the amount of items (specified
719 in &lt;match item name&gt;) that must be dropped to activate the altar.
720
721 If &lt;match item name&gt; is set to "money", then the value of the
722 sacrificed money must be equal to &lt;drop amount&gt; (ie, if food=200, then
723 200 silver, 20 gold, or 4 platinum will all work.)
724
725 Note that the maximum possible for &lt;drop amount&gt; is 32767.
726 </attribute>
727 <attribute arch="connected" editor="connection" type="int">
728 If a connection value is set, the altar will trigger all objects
729 with the same value, when activated. This will only work once.
730 </attribute>
731 <attribute arch="sp" editor="spell" type="spell">
732 When activated, this &lt;spell&gt; will be casted (once, on the player).
733 This should work for any given spell. The altar will work infinitely
734 in this way. Don't set both &lt;spell&gt; and &lt;connection&gt; for one altar.
735 </attribute>
736 <attribute arch="exp" editor="reset time" type="int">
737 Being activated, the altar will reset after &lt;reset time&gt; ticks.
738 After reset, the altar is ready to be activated once again.
739 The default &lt;reset time&gt; is 30.
740 </attribute>
741 <attribute arch="last_sp" editor="ignore reset" type="bool">
742 If this attribute is enabled, the altar_trigger won't push the
743 connected value by altar reset. Only ONCE by dropping the sacrifice.
744 This is typically used when the altar is connected to a creator,
745 e.g. for selling tickets.
746
747 If this attribute is disabled (default), the altar_trigger
748 will push the connected value TWICE per sacrifice: First by
749 dropping sacrifice, second by reset. This mode is typically
750 used for altars being connected to gates, resulting in the
751 gate being opened and closed again.
752 </attribute>
753 &move_on;
754 <attribute arch_begin="msg" arch_end="endmsg" editor="message" type="text">
755 This text will be displayed to the player
756 in the exact moment when the altar is activated.
757 </attribute>
758 </type>
759
760 <!--####################################################################-->
761 <type number="39" name="Amulet">
762 <description><![CDATA[
763 Wearing an amulet, the object's stats will directly be inherited to
764 the player. Amulets are usually meant for protection and defense. ]]>
765 </description>
766 <use><![CDATA[
767 Feel free to create your own special artifacts. However, it is very
768 important that you keep your artifact in balance with existing maps. ]]>
769 </use>
770 <attribute arch="ac" editor="armour class" type="int">
771 This value defines the amount of armour-class bonus for wearing
772 this item. &lt;Armour class&gt; lessens the chance of being hit. Lower
773 values are better. It should usually be set only for armour-like equipment.
774 </attribute>
775 <attribute arch="wc" editor="weapon class" type="int">
776 The &lt;weapon class&gt; value adds to the overall weapon class of the wielder's
777 melee attacks. Weapon class improves the chance of hitting the opponent.
778 Weapon class is the "counterpiece" of &lt;armour class&gt;. It should usually
779 be set only for weapon-like items. Lower values are better.
780 </attribute>
781 <attribute arch="item_power" editor="item power" type="int">
782 The &lt;item power&gt; value measures how "powerful" an artifact is.
783 Players will only be able to wear equipment with a certain total
784 amount of &lt;item power&gt;, depending on their own level. This is the
785 only way to prevent low level players to wear "undeserved" equipment
786 (like gifts from other players or cheated items).
787
788 It is very important to adjust the &lt;item power&gt; value carefully
789 for every artifact you create! If zero/unset, the CF server will
790 calculate a provisional value at runtime, but this is never
791 going to be an accurate measurement of &lt;item power&gt;.
792 </attribute>
793 <attribute arch="damned" editor="damnation" type="bool">
794 A damned piece of equipment cannot be unwielded unless the curse
795 is removed. Removing damnations is a tick harder than removing curses.
796 </attribute>
797 <attribute arch="cursed" editor="curse" type="bool">
798 A cursed piece of equipment cannot be unwielded
799 unless the curse is removed.
800 </attribute>
801 <attribute arch="lifesave" editor="save life" type="bool">
802 An item with this flag enabled will save the players life
803 for one time: When the player is wearing this item and his
804 health points reach zero, the item disappears, replenishing
805 half of the player's health.
806
807 An item with &lt;save life&gt; should not have
808 any decent additional bonuses!
809 </attribute>
810 <attribute arch="unique" editor="unique item" type="bool">
811 Unique items exist only one time on a server. If the item
812 is taken, lost or destroyed - it's gone for good.
813 </attribute>
814 <attribute arch="startequip" editor="godgiven item" type="bool">
815 A godgiven item vanishes as soon as the player
816 drops it to the ground.
817 </attribute>
818 <attribute arch="applied" editor="is applied" type="bool">
819 If you put this item into the inventory of a monster, and
820 you want the monster to use/wear the item - you must set
821 &lt;is applied&gt;.
822 Enabling this flag doesn't make any sense if the item
823 is NOT in a monster's inventory.
824 </attribute>
825 <section name="resistance">
826 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
827 This adds physical resistance to the item (= armour value). The number is
828 a percent-value in the range 0-100. Treat this with CARE. Look at other maps
829 and what they require to do for getting this-and-that artifact.
830 </attribute>
831 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
832 This adds magic resistance to the item. The number is a percent-value in
833 the range 0-100. Treat this with CARE. Look at other maps and what they
834 require to do for getting this-and-that artifact.
835 </attribute>
836 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
837 This adds fire resistance to the item. The number is a percent-value in
838 the range 0-100. Treat this with CARE. Look at other maps and what they
839 require to do for getting this-and-that artifact.
840 </attribute>
841 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
842 This adds electricity resistance to the item. The number is a percent-value in
843 the range 0-100. Treat this with CARE. Look at other maps and what they
844 require to do for getting this-and-that artifact.
845 </attribute>
846 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
847 This adds fire resistance to the item. The number is a percent-value in
848 the range 0-100. Treat this with CARE. Look at other maps and what they
849 require to do for getting this-and-that artifact.
850 </attribute>
851 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
852 This adds confusion resistance to the item. The number is a percent-value in
853 the range 0-100. Confusion resistance is not very effective
854 unless the value comes close to 100 (= perfect immunity).
855 </attribute>
856 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
857 This adds acid resistance to the item. The number is a percent-value in
858 the range 0-100. Treat this with CARE. Look at other maps and what they
859 require to do for getting this-and-that artifact.
860 </attribute>
861 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
862 This adds draining resistance to the item. The number is a percent-value
863 in the range 0-100. Draining resistance is little effective
864 unless the value is 100 (= perfect immunity).
865 </attribute>
866 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
867 This adds weaponmagic resistance to the item. The number is a percent-value in
868 the range 0-100. Weaponmagic resistance generally should not exist on
869 equipment at all. Spells/Monsters doing weaponmagic damage (e.g. comet spell)
870 are not meant to be easily resisted.
871 </attribute>
872 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
873 This adds ghosthit resistance to the item. The number is a percent-value
874 in the range 0-100. Treat this with CARE. Look at other maps and what they
875 require to do for getting this-and-that artifact.
876 </attribute>
877 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
878 This adds poison resistance to the item. The number is a percent-value in
879 the range 0-100. Treat this with CARE. Look at other maps and what they
880 require to do for getting this-and-that artifact.
881 </attribute>
882 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
883 This adds fear resistance to the item. The number is a percent-value in
884 the range 0-100. Resistance to fear is pretty useless.
885 </attribute>
886 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
887 This adds paralyze resistance to the item. The number is a percent-value in
888 the range 0-100. Paralyze resistance is little effective
889 unless the value is 100 (= perfect immunity).
890 </attribute>
891 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
892 This adds fear resistance to the item. The number is a percent-value in
893 the range 0-100. Resistance to fear is pretty useless.
894 </attribute>
895 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
896 This adds depletion resistance to the item. The number is a percent-value
897 in the range 0-100. Depletion resistance is little effective
898 unless the value is 100 (= perfect immunity).
899 </attribute>
900 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
901 This adds death-attack resistance to the item. The number is a
902 percent-value in the range 0-100. Death-attack resistance is little
903 effective unless the value is 100 (= perfect immunity).
904 Generally, resistance to death-attack is not supposed to be
905 available to players!
906 </attribute>
907 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
908 This adds chaos resistance to the item. The number is a percent-value in
909 the range 0-100. Treat this with CARE. Look at other maps and what they
910 require to do for getting this-and-that artifact.
911 Note that chaos is not a stand-alone attacktype. Chaos "contains" a
912 combination of other attacktypes.
913 </attribute>
914 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
915 This adds blinding resistance to the item. The number is a percent-value
916 in the range 0-100. Treat this with CARE. Look at other maps and what they
917 require to do for getting this-and-that artifact.
918 </attribute>
919 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
920 This adds holy power resistance to the item. The number is a percent-value
921 in the range 0-100. Holy power is the attacktype that holyword-type spells
922 use to hurt undead creatures. This kind of resistance is only reasonable
923 for undead players (wraith or devourer cult).
924 Generally, resistance to holy word should not be available for players.
925 </attribute>
926 </section>
927 <section name="stats">
928 <attribute arch="Str" editor="strength" type="int">
929 The player's strentgh will rise/fall by the given value
930 while wearing this piece of equipment.
931 </attribute>
932 <attribute arch="Dex" editor="dexterity" type="int">
933 The player's dexterity will rise/fall by the given value
934 while wearing this piece of equipment.
935 </attribute>
936 <attribute arch="Con" editor="constitution" type="int">
937 The player's constitution will rise/fall by the given value
938 while wearing this piece of equipment.
939 </attribute>
940 <attribute arch="Int" editor="intelligence" type="int">
941 The player's intelligence will rise/fall by the given value
942 while wearing this piece of equipment.
943 </attribute>
944 <attribute arch="Pow" editor="power" type="int">
945 The player's power will rise/fall by the given value
946 while wearing this piece of equipment.
947 </attribute>
948 <attribute arch="Wis" editor="wisdom" type="int">
949 The player's wisdom will rise/fall by the given value while
950 wearing this piece of equipment.
951 </attribute>
952 <attribute arch="Cha" editor="charisma" type="int">
953 The player's charisma will rise/fall by the given value
954 while wearing this piece of equipment.
955 </attribute>
956 </section>
957 <section name="misc">
958 <attribute arch="luck" editor="luck bonus" type="int">
959 With positive luck bonus, the player is more likely to
960 succeed in all sorts of things (spellcasting, praying,...).
961 Unless the &lt;luck bonus&gt; is very high, the effect will be
962 barely visible in-game. Luck bonus on one piece of equipment
963 should never exceed 3, and such bonus should not be too
964 frequently available.
965 </attribute>
966 <attribute arch="hp" editor="health regen." type="int">
967 Positive &lt;health regen.&gt; bonus speeds up the
968 player's healing process. Negative values slow it down.
969 </attribute>
970 <attribute arch="sp" editor="mana regen." type="int">
971 Positive &lt;mana regen.&gt; bonus speeds up the
972 player's mana regeneration. Negative values slow it down.
973 </attribute>
974 <attribute arch="grace" editor="grace regen." type="int">
975 Positive &lt;grace regen.&gt; bonus speeds up the
976 player's grace regeneration. Negative values slow it down.
977 Since grace can be regenerated rather easy with praying,
978 additional &lt;grace regen.&gt; bonus should be VERY RARE!!
979 </attribute>
980 <attribute arch="food" editor="food bonus" type="int">
981 Positive &lt;food bonus&gt; slows down the player's digestion,
982 thus he consumes less food. Negative values speed it up.
983
984 Note that food is consumed not only for "being alive", but
985 also for healing and mana-regeneration.
986 &lt;food bonus&gt; only affects the amount of food consumed
987 for "being alive". Hence, even with high &lt;food bonus&gt;,
988 during a fight a player can run out of food quickly.
989 </attribute>
990 <attribute arch="xrays" editor="xray vision" type="bool">
991 Xray vision allows the player to see through obstacles
992 in a two-square-wide radius. This is extremely helpful and
993 desirable, so don't give it away for cheap on equipment.
994 </attribute>
995 <attribute arch="stealth" editor="stealth" type="bool">
996 Stealth allows the player to move silently.
997 This comes to effect if a player turns himself
998 invisible and tries to sneak around monsters.
999 (At least that was the idea behind it)
1000 </attribute>
1001 <attribute arch="reflect_spell" editor="reflect spells" type="bool">
1002 If a player is wearing any piece of equipment with
1003 the ability to &lt;reflect spells&gt;, all kinds of
1004 spell-bullets and -beams will bounce off him.
1005 This works only about 90% of all times, to
1006 avoid players being completely immune to certain
1007 types of attacks.
1008
1009 This is a very powerful ability and it
1010 shouldn't be handed out cheap!
1011 </attribute>
1012 <attribute arch="reflect_missile" editor="reflect missiles" type="bool">
1013 If a player is wearing any piece of equipment with
1014 the ability to &lt;reflect missiles&gt;, all kinds of
1015 projectiles (e.g. arrows, bolts, boulders) will
1016 bounce off him. This works only about 90% of all
1017 times, to avoid players being completely immune to
1018 certain types of attacks.
1019 </attribute>
1020 &move_type;
1021 <attribute arch="path_attuned" editor="attuned paths" type="bitmask_spellpath">
1022 Click on the &lt;attuned paths&gt; button to select spellpaths.
1023 The player will get attuned to the specified spellpaths
1024 while wearing this item.
1025 </attribute>
1026 <attribute arch="path_repelled" editor="repelled paths" type="bitmask_spellpath">
1027 Click on the &lt;repelled paths&gt; button to select spellpaths.
1028 The player will get repelled to the specified spellpaths
1029 while wearing this item.
1030 </attribute>
1031 <attribute arch="path_denied" editor="denied paths" type="bitmask_spellpath">
1032 Click on the &lt;denied paths&gt; button to select spellpaths.
1033 The specified spellpaths will be denied to the player
1034 while wearing this item.
1035 </attribute>
1036 </section>
1037 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
1038 This text describes the item's "story". Every decent artifact
1039 should have such a description.
1040 </attribute>
1041 </type>
1042
1043 <!--####################################################################-->
1044 <type number="58" name="Battleground">
1045 <ignore>
1046 <ignore_list name="non_pickable" />
1047 </ignore>
1048 <description><![CDATA[
1049 Battleground is very special: In short, players can die on battleground
1050 without any death penalties. They don't loose or gain experience
1051 while on battleground. Acid, draining and depletion effects don't
1052 work either.
1053 When a player dies on battleground, he gets teleported to an exit
1054 location which is defined in the battleground object. ]]>
1055 </description>
1056 <use><![CDATA[
1057 Battleground is only meant for player vs. player duels. You can
1058 design combat arenas similiar to the one in scorn.<br>
1059 What should NEVER be done is placing battleground tiles in
1060 open dungeons or other free kinds of land.
1061 It must not be possible to gain significant treasure for fighting
1062 on battleground, because it bears no risk.<br><br>
1063 (Battleground will cease to work when the image or name is changed,
1064 or when it is placed beneath another floor tile.
1065 This is not a bug, it is there to prevent any attempts of placing
1066 "hidden" battleground tiles anywhere.) ]]>
1067 </use>
1068 <attribute arch="no_pick" value="1" type="fixed" />
1069 <attribute arch="is_floor" value="1" type="fixed" />
1070 <attribute arch="hp" editor="destination X" type="int">
1071 The exit destinations define the (x, y)-coordinates where players
1072 get teleported after they died on this battleground.
1073 </attribute>
1074 <attribute arch="sp" editor="destination Y" type="int">
1075 The exit destinations define the (x, y)-coordinates where players
1076 get teleported after they died on this battleground.
1077 </attribute>
1078 </type>
1079
1080 <!--####################################################################-->
1081 <type number="165" name="Safe ground (CF+)">
1082 <ignore>
1083 <ignore_list name="non_pickable" />
1084 </ignore>
1085 <description><![CDATA[
1086 Safe ground is a special object that prevents any effects that might
1087 be harmful for the map, other players or items on the map.
1088 It blocks all magic and prayers, usage of alchemy, prevents potions
1089 from being used and blocks bombs from exploding. Note that altars that
1090 do cast spells still work.
1091 (This is a Crossfire+ feature, and might not work elsewhere)
1092 ]]>
1093 </description>
1094 <use><![CDATA[
1095 Safe ground can be used to prevents any means of burning
1096 or destroying the items in a shop. Put this object below all floor tiles
1097 in your map and your shop will be safe. It's generally useful for making
1098 areas where really no kind of spell should be invoked by a player.
1099 ]]>
1100 </use>
1101 <attribute arch="no_pick" value="1" type="fixed" />
1102 </type>
1103
1104 <!--####################################################################-->
1105 <type number="8" name="Book">
1106 <description><![CDATA[
1107 Applying a book, the containing message is displayed to the player. ]]>
1108 </description>
1109 <attribute arch="level" editor="literacy level" type="int">
1110 If this value is set to be greater than zero, the player needs a
1111 certain literacy level to succeed reading the book. The book can be
1112 read if: mental_level greater &lt;literacy level&gt; - 5. Adding level to a
1113 book can be a nice idea, personally I like it when a player needs
1114 more than his fighting skills to solve a quest. However, keep the
1115 booklevel at least below 15 because it is quite hard to gain high
1116 mental levels.
1117 </attribute>
1118 <attribute arch="startequip" editor="godgiven item" type="bool">
1119 A godgiven item vanishes as soon as the player
1120 drops it to the ground.
1121 </attribute>
1122 <attribute arch="unique" editor="unique item" type="bool">
1123 Unique items exist only one time on a server. If the item
1124 is taken, lost or destroyed - it's gone for good.
1125 </attribute>
1126 <attribute arch_begin="msg" arch_end="endmsg" editor="book content" type="text">
1127 This is the text that appears "written" in the book.
1128 </attribute>
1129 <attribute arch="slaying" editor="key string" type="string">
1130 This is the key string of the book. The key string is checked by an inventory checker.
1131 (This is used eg. for the gate/port passes in scorn)
1132 </attribute>
1133 </type>
1134
1135 <!--####################################################################-->
1136 <type number="99" name="Boots">
1137 <import_type name="Amulet" />
1138 <description><![CDATA[
1139 Wearing boots, the object's stats will directly be inherited to
1140 the player. Usually enhancing his speed, or granting some minor
1141 protection bonus. ]]>
1142 </description>
1143 <use><![CDATA[
1144 Feel free to create your own special artifacts. However, it is very
1145 important that you keep your artifact in balance with existing maps. ]]>
1146 </use>
1147 <attribute arch="exp" editor="speed bonus" type="int">
1148 Boots with &lt;speed bonus&gt; will increase the player's walking speed
1149 while worn. This kind of bonus is quite desirable for players of low-
1150 and medium level. High level players usually have fastest possible
1151 walking speed and thus don't need &lt;speed bonus&gt; anymore.
1152 Still, this bonus is good for nice artifacts - not everything has
1153 to be for highest level.
1154 </attribute>
1155 <attribute arch="magic" editor="magic bonus" type="int">
1156 &lt;magic bonus&gt; works just like ac, except that it can be improved by
1157 "scrolls of Enchant Armour" or reduced by acid. It is less useful
1158 than direct armour-class bonus on the boots.
1159
1160 Important: &lt;magic bonus&gt; on boots has no effect if there is no
1161 &lt;armour class&gt; set. It only works in combination with &lt;armour class&gt;.
1162 </attribute>
1163 </type>
1164
1165 <!--####################################################################-->
1166 <type number="104" name="Bracers">
1167 <import_type name="Amulet" />
1168 <description><![CDATA[
1169 Bracers are armour-plates worn around the wrists.
1170 Wearing bracer, the object's stats will directly be inherited to
1171 the player. Usually enhancing his defense. ]]>
1172 </description>
1173 <use><![CDATA[
1174 Feel free to create your own special artifacts. However, it is very
1175 important that you keep your artifact in balance with existing maps. ]]>
1176 </use>
1177 <attribute arch="magic" editor="magic bonus" type="int">
1178 &lt;magic bonus&gt; works just like ac, except that it can be improved by
1179 "scrolls of Enchant Armour" or reduced by acid. It is less useful
1180 than direct armour-class bonus on the bracers.
1181 </attribute>
1182 </type>
1183
1184 <!--####################################################################-->
1185 <type number="16" name="Brestplate Armour">
1186 <import_type name="Amulet" />
1187 <description><![CDATA[
1188 Wearing an armour, the object's stats will directly be inherited to
1189 the player. Usually enhancing his defense. ]]>
1190 </description>
1191 <use><![CDATA[
1192 Feel free to create your own special artifacts. However, it is very
1193 important that you keep your artifact in balance with existing maps. ]]>
1194 </use>
1195 <attribute arch="last_heal" editor="spellpoint penalty" type="int">
1196 This poses a penalty to spell regeneration speed, for wearing the armour.
1197 The bigger the spellpoint penalty, the worse.
1198 </attribute>
1199 <attribute arch="last_sp" editor="slowdown penalty" type="int">
1200 Slowdown penalty reduces the player's walking speed when wearing the
1201 armour. Bigger values are worse - zero is best.
1202 </attribute>
1203 <attribute arch="magic" editor="magic bonus" type="int">
1204 &lt;magic bonus&gt; works just like ac, except that it can be improved by
1205 "scrolls of Enchant Armour" or reduced by acid. It is less useful
1206 than direct armour-class bonus on the armour.
1207 </attribute>
1208 </type>
1209
1210 <!--####################################################################-->
1211 <type number="92" name="Button">
1212 <ignore>
1213 <ignore_list name="non_pickable" />
1214 </ignore>
1215 <description><![CDATA[
1216 When a predefined amount of weigh is placed on a button, the
1217 &lt;connection&gt; value is triggered. In most cases this happens when a
1218 player or monster steps on it. When the button is "released", the
1219 &lt;connection&gt; value get's triggered a second time. ]]>
1220 </description>
1221 &move_on;
1222 &move_off;
1223 <attribute arch="no_pick" value="1" type="fixed" />
1224 <attribute arch="weight" editor="press weight" type="int">
1225 The button is pressed (triggered), as soon as
1226 &lt;press weigh&gt; gram are placed ontop of it.
1227 </attribute>
1228 <attribute arch="connected" editor="connection" type="int">
1229 Every time the button is pressed or released, all objects
1230 with the same &lt;connection&gt; value are activated.
1231 </attribute>
1232 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
1233 This text may describe the item. You can use this
1234 message to explain the button's purpose to the player.
1235 </attribute>
1236 </type>
1237
1238 <!--####################################################################-->
1239 <type number="30" name="Button Trigger">
1240 <import_type name="Button" />
1241 <ignore>
1242 <ignore_list name="non_pickable" />
1243 </ignore>
1244 <description><![CDATA[
1245 Handle buttons are buttons which reset after a short period
1246 of time. Every time it is either applied or reset, the
1247 &lt;connection&gt; value is triggered. ]]>
1248 </description>
1249 </type>
1250
1251 <!--####################################################################-->
1252 <type number="37" name="Class Changer">
1253 <ignore>
1254 <ignore_list name="non_pickable" />
1255 </ignore>
1256 <description><![CDATA[
1257 Class changer are used while creating a character. ]]>
1258 </description>
1259 <attribute arch="randomitems" editor="class items" type="treasurelist">
1260 This entry determines which initial items the character receives.
1261 </attribute>
1262 <section name="stats">
1263 <attribute arch="Str" editor="strength" type="int">
1264 The player's strength will rise by the given value if he chooses this
1265 class. (Negative values make strength fall)
1266 </attribute>
1267 <attribute arch="Dex" editor="dexterity" type="int">
1268 The player's dexterity will rise by the given value if he chooses this
1269 class. (Negative values make dexterity fall)
1270 </attribute>
1271 <attribute arch="Con" editor="constitution" type="int">
1272 The player's constitution will rise by the given value if he chooses this
1273 class. (Negative values make constitution fall)
1274 </attribute>
1275 <attribute arch="Int" editor="intelligence" type="int">
1276 The player's intelligence will rise by the given value if he chooses this
1277 class. (Negative values make intelligence fall)
1278 </attribute>
1279 <attribute arch="Pow" editor="power" type="int">
1280 The player's power will rise by the given value if he chooses this
1281 class. (Negative values make power fall)
1282 </attribute>
1283 <attribute arch="Wis" editor="wisdom" type="int">
1284 The player's wisdom will rise by the given value if he chooses this
1285 class. (Negative values make wisdom fall)
1286 </attribute>
1287 <attribute arch="Cha" editor="charisma" type="int">
1288 The player's charisma will rise by the given value if he chooses this
1289 class. (Negative values make charisma fall)
1290 </attribute>
1291 </section>
1292 </type>
1293
1294 <!--####################################################################-->
1295 <type number="87" name="Cloak">
1296 <import_type name="Amulet" />
1297 <description><![CDATA[
1298 Wearing a cloak, the object's stats will directly be inherited to
1299 the player. Cloaks usually add minor &lt;armour class&gt; and
1300 sometimes a bit of resistance. ]]>
1301 </description>
1302 <use><![CDATA[
1303 Feel free to create your own special artifacts. However, it is very
1304 important that you keep your artifact in balance with existing maps. ]]>
1305 </use>
1306 <attribute arch="magic" editor="magic bonus" type="int">
1307 &lt;magic bonus&gt; works just like ac, except that it can be improved by
1308 "scrolls of Enchant Armour" or reduced by acid. It is less useful
1309 than direct armour-class bonus on the cloak.
1310
1311 Important: &lt;magic bonus&gt; on cloaks has no effect if there is no
1312 &lt;armour class&gt; set. It only works in combination with &lt;armour class&gt;.
1313 </attribute>
1314 </type>
1315
1316 <!--####################################################################-->
1317 <type number="9" name="Clock">
1318 <description><![CDATA[
1319 Applying a clock, the time is displayed to the player. ]]>
1320 </description>
1321 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
1322 This text may describe the item
1323 </attribute>
1324 </type>
1325
1326 <!--####################################################################-->
1327 <type number="122" name="Container">
1328 <description><![CDATA[
1329 A player can put (certain kinds of) items in the container.
1330 The overall weight of items is reduced when put inside a
1331 container, depending on the settings.
1332 <br><br>
1333 A special feature of containers is the "cauldron",
1334 capable of mixing alchemical receipes. ]]>
1335 </description>
1336 <use><![CDATA[
1337 Note on chests - There are two types of chests:
1338 <UL>
1339 <LI> First the random treasure chests - Those are NOT containers
1340 (but object type Treasure), they create random treasures when
1341 applied. Archetype name is "chest".
1342 <LI> Second there are the permanent chests - Those are containers,
1343 they can be opened and closed again. Archetype name is "chest_2".
1344 </UL> ]]>
1345 </use>
1346 <attribute arch="race" editor="container class" type="string">
1347 If set, the container will hold only certain types of objects.
1348 Possible choices for &lt;container class&gt; are: "gold and jewels",
1349 "arrows" and "keys".
1350
1351 Unfortunately it is not easy to create new container
1352 classes, because items need a matching counterpiece-attribute
1353 to the &lt;container class&gt; before they can be put inside a
1354 container. This attribute ("race") is set only for the existing
1355 container classes.
1356 </attribute>
1357 <attribute arch="slaying" editor="key string" type="string">
1358 If &lt;key string&gt; is set, only players with a special key
1359 of matching &lt;key string&gt; are able to open the container.
1360 </attribute>
1361 <attribute arch="container" editor="maximum weight" type="int">
1362 The container can hold a maximum total weight of the given value
1363 in gram. Note that this weight limit is calculated *after* the
1364 weight reduction (&lt;reduce weight&gt;) has been applied.
1365 </attribute>
1366 <attribute arch="Str" editor="reduce weight %" type="int">
1367 This value determines how much the weight of items is reduced in
1368 percent, when put inside the container. &lt;reduce weight %&gt; 0 means no
1369 reduction, &lt;reduce weight %&gt; 100 means items are weightless inside.
1370 Most default values are in the range of ten.
1371 </attribute>
1372 <attribute arch="is_cauldron" editor="alchemy cauldron" type="bool">
1373 If set, the container can be used as alchemy-cauldron.
1374 The player can put ingredients inside, close it, cast alchemy
1375 and if his formulae is true, he'll get what he longed for.
1376 </attribute>
1377 <attribute arch="unique" editor="unique item" type="bool">
1378 Unique items exist only one time on a server. If the item
1379 is taken, lost or destroyed - it's gone for good.
1380 All contents of a unique container are unique as well.
1381 </attribute>
1382 <attribute arch="startequip" editor="godgiven item" type="bool">
1383 A godgiven item vanishes as soon as the player
1384 drops it to the ground.
1385 </attribute>
1386 <attribute arch="other_arch" editor="animation arch" type="string">
1387 This is used for a certain kind of... "animation" when
1388 opening the container. Stick to the default arches here
1389 and you won't get into trouble.
1390 </attribute>
1391 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
1392 This text may contain a description of the container.
1393 </attribute>
1394 </type>
1395
1396 <!--####################################################################-->
1397 <type number="103" name="Converter">
1398 <ignore>
1399 <attribute arch="value" />
1400 <attribute arch="nrof" />
1401 <attribute arch="name_pl" />
1402 <attribute arch="no_pick" />
1403 <attribute arch="unpaid" />
1404 <attribute arch="title" />
1405 </ignore>
1406 <description><![CDATA[
1407 Converters are like "exchange tables". When the player drops a
1408 specific type of items, they get converted into other items, at a
1409 predefined exchange-ratio. ]]>
1410 </description>
1411 <use><![CDATA[
1412 Converters are better than shopping with doormats, because the
1413 converters never get sold out. For some items like food or jewels
1414 those "exchange tables" are really nice, while for the more important
1415 stuff like potions converters should not exist.
1416 <br><br>
1417 VERY IMPORTANT: Be careful with the exchange-ratio! When you drop
1418 items on a converter, the stuff you get must be of equal or lesser
1419 value than before! (Except if you are using "rare" items like
1420 dragonscales for payment). The code will not check if your ratio is
1421 sane, so the player could gain infinite wealth by using your converter. ]]>
1422 </use>
1423 <attribute arch="no_pick" value="1" type="fixed" />
1424 <attribute arch="slaying" editor="cost arch" type="string">
1425 &lt;cost arch&gt; is the name of the archetype the player has to
1426 put on the converter, as payment.
1427 </attribute>
1428 <attribute arch="food" editor="cost number" type="int">
1429 The player has to put &lt;cost number&gt; items of &lt;cost arch&gt;
1430 on the converter, in order to get &lt;receive number&gt; items
1431 of &lt;receive arch&gt;.
1432 </attribute>
1433 <attribute arch="other_arch" editor="receive arch" type="string">
1434 &lt;receive arch&gt; is the name of the archetype to convert into.
1435 This field is ignored if the converter has items in inventory. In this
1436 case one of the inventory items is duplicated. The duplicated item is
1437 randomly chosen from all items present.
1438 </attribute>
1439 <attribute arch="sp" editor="receive number" type="int">
1440 The player has to put &lt;cost number&gt; items of &lt;cost arch&gt;
1441 on the converter, in order to get &lt;receive number&gt; items
1442 of &lt;receive arch&gt;.
1443 </attribute>
1444 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
1445 This text may contain a description of the converter.
1446 </attribute>
1447 </type>
1448
1449 <!--####################################################################-->
1450 <type number="42" name="Creator">
1451 <ignore>
1452 <ignore_list name="system_object" />
1453 </ignore>
1454 <description><![CDATA[
1455 A creator is an object which creates another object when it
1456 is triggered. The child object can be anything. Creators are
1457 VERY useful for all kinds of map-mechanisms. They can even
1458 periodically create things. ]]>
1459 </description>
1460 <use><![CDATA[
1461 Don't hesitate to hide your creators under the floor.
1462 The created items will still always appear ontop of the floor. ]]>
1463 </use>
1464 <attribute arch="no_pick" value="1" type="fixed" />
1465 <attribute arch="other_arch" editor="create arch" type="string">
1466 This string defines the object that will be created.
1467 You can choose any of the existing arches.
1468 This field is ignored if the creator has items in inventory. In this case
1469 one of the inventory items is duplicated. The duplicated item is randomly
1470 chosen from all items present.
1471 </attribute>
1472 <attribute arch="connected" editor="connection" type="int">
1473 Whenever the connection value is activated,
1474 the creator gets triggered.
1475 </attribute>
1476 &activate_on;
1477 <attribute arch="lifesave" editor="infinit uses" type="bool">
1478 If &lt;infinit uses&gt; is set, the creator will work
1479 infinitely, regardless of the value in &lt;number of uses&gt;.
1480 </attribute>
1481 <attribute arch="speed" editor="speed" type="float">
1482 When this field is set the creator will periodically create stuff
1483 (and will still do so when the connection is triggered).
1484 A value of 1 means roughly 8 times a second.
1485 </attribute>
1486 <attribute arch="hp" editor="number of uses" type="int">
1487 The creator can be triggered &lt;number of uses&gt; times, thus
1488 creating that many objects, before it dissappears.
1489 Default is &lt;number of uses&gt; 1 (-&gt; one-time usage).
1490 </attribute>
1491 <attribute arch="slaying" editor="name of creation" type="string">
1492 The created object will bear the name and title specified in &lt;name of
1493 creation&gt;. If nothing is set, the standard name and title of the
1494 archetype is used.
1495 </attribute>
1496 <attribute arch="level" editor="level of creation" type="int">
1497 The created object will be of that level. If zero/unset,
1498 the standard level of the archetype is used.
1499 </attribute>
1500 </type>
1501
1502 <!--####################################################################-->
1503 <type number="51" name="Detector">
1504 <ignore>
1505 <ignore_list name="system_object" />
1506 </ignore>
1507 <description><![CDATA[
1508 Detectors work quite much like inv. checkers/pedestals: If the detector
1509 finds a specific object, it toggles its connected value.
1510 <br><br>
1511 What is "unique" about them, compared to inv. checkers/ pedestals?
1512 - First, detectors check their square for a match periodically, not
1513 instantly. Second, detectors check directly for object names. Third,
1514 detectors do not check the inventory of players/monsters. ]]>
1515 </description>
1516 <use><![CDATA[
1517 There is one major speciality about detectors: You can detect spells
1518 blown over a detector! To detect a lighting bolt for example, set
1519 "slaying ligthing" and "speed 1.0". In combination with spellcasting
1520 walls, this can be very useful for map-mechanisms. ]]>
1521 </use>
1522 <attribute arch="no_pick" value="1" type="fixed" />
1523 <attribute arch="slaying" editor="match name" type="string">
1524 &lt;match name&gt; specifies the name of the object we are looking for.
1525 Actually it does also check for the &lt;key string&gt; in key-objects,
1526 but for this case inventory checkers are often more powerful to use.
1527 </attribute>
1528 <attribute arch="connected" editor="connection" type="int">
1529 When the detector is triggered, all objects with the same
1530 connection value get activated.
1531 </attribute>
1532 <attribute arch="speed" editor="detection speed" type="float">
1533 This value defines the time between two detector-checks.
1534 If you want the detector to behave almost like pedestals/buttons,
1535 set speed rather high, like &lt;detection speed&gt; 1.0.
1536 </attribute>
1537 &speed_left;
1538 <attribute arch="speed_left" editor="speed left" type="float">
1539 The speed left. This value is incremented by &lt;speed&gt; on every tick.
1540 If it is larger than 0, the detector checks, and the speed is decremented
1541 by 1.
1542 </attribute>
1543 </type>
1544
1545 <!--####################################################################-->
1546 <type number="112" name="Director">
1547 <ignore>
1548 <ignore_list name="non_pickable" />
1549 </ignore>
1550 <description><![CDATA[
1551 Directors change the direction of spell objects and other projectiles
1552 that fly past. Unlike spinners, directors always move objects in the
1553 same direction. It does not make a difference from what angle you
1554 shoot into it.<br>
1555 Directors are visible per default. ]]>
1556 </description>
1557 <use><![CDATA[
1558 Directors are rarely used in maps. Sometimes they are placed to
1559 change the direction of spells coming out of magic walls,
1560 "channeling" spell-projectiles in some direction. When doing this,
1561 <B>never place directors facing each other with magic walls fireing
1562 into them!</B> The spell-projectiles bouncing between the directors
1563 would accumulate to huge numbers and at some point slow down the
1564 server by eating memory- and CPU-time.
1565 <br><br>
1566 You'd better not place directors in monster vs. player combat
1567 areas too much, because that freaks out wizard-type players. ]]>
1568 </use>
1569 <attribute arch="sp" editor="direction" type="list_direction">
1570 Projectiles will leave the director flying in the selected &lt;direction&gt;.
1571 A director with direction &lt;none&gt; simply stops projectiles.
1572 (The latter works out a bit strange for some spells).
1573 </attribute>
1574 &move_on;
1575 </type>
1576
1577 <!--####################################################################-->
1578 <type number="158" name="Disease">
1579 <ignore>
1580 <ignore_list name="system_object" />
1581 </ignore>
1582 <description><![CDATA[
1583 Diseases are an intersting form of spellcraft in Crossfire.
1584 Once casted, they can spread out and infect creatures in a large
1585 area. Being infected can have various effects, from amusing farts
1586 to horrible damage - almost everything is possible. ]]>
1587 </description>
1588 <use><![CDATA[
1589 Diseases are extremely flexible and usable in a many ways.
1590 So far they are mostly used for causing bad, unwanted effects.
1591 You could just as well create a disease which helps the player
1592 (recharging mana for example).
1593 Infection with a "positive disease" could even be a quest reward. ]]>
1594 </use>
1595 <attribute arch="invisible" value="1" type="fixed" />
1596 <attribute arch="level" editor="plaque level" type="int">
1597 The &lt;plaque level&gt; is proportional to the disease's deadliness.
1598 This mainly reflects in the &lt;damage&gt;. It has no effect on
1599 most other symptoms. Neverthless, it is a very important value for
1600 all damage-inflicting diseases.
1601 </attribute>
1602 <attribute arch="race" editor="infect race" type="string">
1603 The disease will only infect creatures of the specified &lt;race&gt;.
1604 "&lt;race&gt; *" means every creature can be infected.
1605 </attribute>
1606 <attribute arch="ac" editor="progressiveness" type="int">
1607 Every time the disease "moves" the severity of the symptoms are increased
1608 by &lt;progressiveness&gt;/100. (severity = 1 + (accumlated progression)/100)
1609 </attribute>
1610 <section name="spreading">
1611 <attribute arch="wc" editor="infectiosness" type="int">
1612 The &lt;infectiosness&gt; defines the chance of new creatures getting
1613 infected. If you set this too high, the disease is very likely to
1614 be too effective.
1615
1616 &lt;infectiosness&gt;/127 is the chance of someone in range catching it.
1617 </attribute>
1618 <attribute arch="last_grace" editor="attenuation" type="int">
1619 The &lt;attenuation&gt; value reduces the diseases' &lt;infectiosness&gt;
1620 everytime it infects someone new. This limits how many generations
1621 a disease can propagate.
1622 </attribute>
1623 <attribute arch="magic" editor="infection range" type="int">
1624 &lt;infection range&gt; sets the range at which infection may occur.
1625 If positive, the &lt;infection range&gt; is level dependant - If negative,
1626 it is not:
1627 E.g. "&lt;infection range&gt; -6" means creatures can be infected in
1628 six square range, and &lt;plaque level&gt; doesn't modify that.
1629 </attribute>
1630 <attribute arch="maxhp" editor="persistence" type="int">
1631 &lt;persistence&gt; defines how long the disease can persist OUTSIDE a host.
1632 The disease can "move" &lt;persistence&gt; times outside a host before it
1633 vanishes. A negative value means the disease lasts for permanent
1634 (which is only recommended to use in maps without monsters).
1635 </attribute>
1636 <attribute arch="maxgrace" editor="curing duration" type="int">
1637 The disease will last in the host for &lt;curing duration&gt; "disease moves"
1638 (Assuming the host survives and doesn't use a curing spell).
1639 After this period the disease is naturally cured, which provides the
1640 host with immunity from this particular disease of lower or equal level.
1641
1642 A negative value means the disease can never be cured naturally.
1643
1644 Note that this value can be further modulated by spell-parameters,
1645 if the disease is registered as spell in the code. Due to that,
1646 most default diseases take a lot longer to cure than it seems.
1647 </attribute>
1648 <attribute arch="speed" editor="moving speed" type="float">
1649 The &lt;speed&gt; of the disease determines how fast the disease will
1650 "move", thus how fast the symptoms strike the host.
1651 </attribute>
1652 &speed_left;
1653 </section>
1654 <section name="symptoms">
1655 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
1656 The disease will attack the host with the given &lt;attacktype&gt;.
1657 Godpower attacktype is commonly used for "unresistable" diseases.
1658 </attribute>
1659 <attribute arch="dam" editor="damage" type="int">
1660 A disease with a positive &lt;damage&gt; value will strike the player for that
1661 amount of damage every time the symptoms occur.
1662 A negative &lt;damage&gt; value produces %-based damage: "&lt;damage&gt; -10" means
1663 the player's health is reduced by 10% every time the symptoms strike.
1664
1665 Diseases with %-based damage can be dangerous - but not deadly -
1666 for players of all levels.
1667 </attribute>
1668 <attribute arch="other_arch" editor="create arch" type="string">
1669 If set, the specified arch is created and dropped every time the
1670 symptoms strike.
1671
1672 This can be various things: farts, body pieces, eggs ...
1673 Even monsters can be created that way. You could also make a
1674 disease where some exotic stuff like money/gems is created.
1675 </attribute>
1676 <attribute arch="last_sp" editor="slowdown penalty" type="int">
1677 If set, the disease imposes a &lt;slowdown penalty&gt; while being infected.
1678 The player's speed is reduced by &lt;slowdown penalty&gt; % of normal value.
1679 </attribute>
1680 <attribute arch="exp" editor="exp. for curing" type="int">
1681 When the player manages to cure this disease (with a curing spell),
1682 he is awarded with &lt;exp. for curing&gt; experience.
1683 </attribute>
1684 <attribute arch="maxsp" editor="mana depletion" type="int">
1685 Every time the disease "moves", the player's mana is
1686 reduced by the value of &lt;mana depletion&gt;.
1687 For negative values, a %-based amount is taken.
1688 </attribute>
1689 <attribute arch="last_eat" editor="food depletion" type="int">
1690 Every time the disease "moves", the player's food is
1691 reduced by the value of &lt;food depletion&gt;.
1692 For negative values, a %-based amount is taken.
1693 </attribute>
1694 <attribute arch="hp" editor="health regen." type="int">
1695 This value increases the player's healing rate.
1696 Negative values decrease it.
1697 </attribute>
1698 <attribute arch="sp" editor="mana regen." type="int">
1699 This value increases the player's rate of mana regeneration.
1700 Negative values decrease it.
1701 </attribute>
1702 </section>
1703 <section name="disability">
1704 <attribute arch="Str" editor="strength" type="int">
1705 The player's strength will rise by the given value
1706 while being infected. (Negative values make strength fall)
1707 </attribute>
1708 <attribute arch="Dex" editor="dexterity" type="int">
1709 The player's dexterity will rise by the given value
1710 while being infected. (Negative values make dexterity fall)
1711 </attribute>
1712 <attribute arch="Con" editor="constitution" type="int">
1713 The player's constitution will rise by the given value
1714 while being infected. (Negative values make constitution fall)
1715 </attribute>
1716 <attribute arch="Int" editor="intelligence" type="int">
1717 The player's intelligence will rise by the given value
1718 while being infected. (Negative values make intelligence fall)
1719 </attribute>
1720 <attribute arch="Pow" editor="power" type="int">
1721 The player's power will rise by the given value
1722 while being infected. (Negative values make power fall)
1723 </attribute>
1724 <attribute arch="Wis" editor="wisdom" type="int">
1725 The player's wisdom will rise by the given value
1726 while being infected. (Negative values make wisdom fall)
1727 </attribute>
1728 <attribute arch="Cha" editor="charisma" type="int">
1729 The player's charisma will rise by the given value
1730 while being infected. (Negative values make charisma fall)
1731 </attribute>
1732 </section>
1733 <attribute arch_begin="msg" arch_end="endmsg" editor="message" type="text">
1734 This text is displayed to the player every time the
1735 symptoms strike.
1736 </attribute>
1737 </type>
1738
1739 <!--####################################################################-->
1740 <type number="23" name="Door">
1741 <ignore>
1742 <ignore_list name="non_pickable" />
1743 </ignore>
1744 <description><![CDATA[
1745 A door can be opened with a normal key. It also can be broken by attacking
1746 it, and it can be defeated with the lockpicking skill. If a door is
1747 defeated, horizontally and vertically adjacent doors are automatically
1748 removed. ]]>
1749 </description>
1750 <attribute arch="no_pick" value="1" type="fixed" />
1751 <attribute arch="alive" value="1" type="fixed" />
1752 &movement_types_terrain;
1753 <attribute arch="hp" editor="hitpoints" type="int">
1754 The more &lt;hitpoints&gt; the door has, the longer it takes to be broken.
1755 </attribute>
1756 <attribute arch="ac" editor="armour class" type="int">
1757 Doors of high &lt;armour class&gt; are less likely to get hit.
1758 &lt;armour class&gt; can be considered the "counterpiece" to
1759 &lt;weapon class&gt;.
1760 </attribute>
1761 <attribute arch="other_arch" editor="drop arch" type="string">
1762 This string defines the object that will be created when the door was
1763 defeated.
1764 </attribute>
1765 <attribute arch="randomitems" editor="treasurelist" type="treasurelist">
1766 This entry determines what kind of traps will appear in the door.
1767 </attribute>
1768 </type>
1769
1770 <!--####################################################################-->
1771 <type number="83" name="Duplicator">
1772 <ignore>
1773 <ignore_list name="system_object" />
1774 </ignore>
1775 <description><![CDATA[
1776 When activated, a duplicator can duplicate, multiply or destroy a pile of
1777 objects which lies somewhere on top of the duplicator.
1778 The duplicator has one arch name specified as &lt;target arch&gt;,
1779 and only objects of this archetype can be affected.<br>
1780 It will multiply the number of items in the pile, by the &lt;multiply factor&gt;.
1781 If the latter is set to zero, it will destroy objects. ]]>
1782 </description>
1783 <use><![CDATA[
1784 I hope it is clear that one must be very cautious when inserting a duplicator
1785 anywhere with &lt;multiply factor&gt; greater than one.
1786 It is designed to be used for betting mechanisms only (bet -&gt; win/loose).
1787 It is <b>not acceptable</b> to allow duplication of anything other than
1788 coins, gold and jewels. Besides, it is very important that the chance to
1789 loose the input matches the chance to earn winnings.<br>
1790 A duplicator with &lt;multiply factor&gt; 3 for example should have a
1791 loosing rate of 2/3 = 67%. ]]>
1792 </use>
1793 <attribute arch="other_arch" editor="target arch" type="string">
1794 Only objects of matching archtype, lying ontop of the duplicator will be
1795 duplicated, multiplied or removed. All other objects will be ignored.
1796 </attribute>
1797 <attribute arch="level" editor="multiply factor" type="int">
1798 The number of items in the target pile will be multiplied by the
1799 &lt;multiply factor&gt;. If it is set to zero, all target objects
1800 will be destroyed.
1801 </attribute>
1802 <attribute arch="connected" editor="connection" type="int">
1803 An activator (lever, altar, button, etc) with matching connection value
1804 is able to trigger this duplicator. Be very careful that players cannot
1805 abuse it to create endless amounts of money or other valuable stuff!
1806 </attribute>
1807 &activate_on;
1808 </type>
1809
1810 <!--####################################################################-->
1811 <type number="66" name="Exit">
1812 <ignore>
1813 <ignore_list name="non_pickable" />
1814 </ignore>
1815 <description><![CDATA[
1816 When the player applies an exit, he is transferred to a different location.
1817 (Monsters cannot use exits.) Depending on how it is set, the player applies
1818 the exit just by walking into it, or by pressing &lt;a&gt;pply when standing on
1819 the exit. ]]>
1820 </description>
1821 <use><![CDATA[
1822 If you want to have an invisible exit, set &lt;invisible&gt; (, of course
1823 &lt;apply by walking&gt;), and put it *under* the floor. Otherwise it could be
1824 detected with the show_invisible spell.
1825 <br><br>
1826 You can be quite creative with the outlook of secret exits (their "face").
1827 Don't forget to give the player relyable hints about them though. ]]>
1828 </use>
1829 <attribute arch="slaying" editor="exit path" type="string">
1830 The exit path defines the map that the player is transferred to.
1831 You can enter an absolute path, beginning with '/' (for example
1832 "/peterm/FireTemple/fire1"). It can also be a relative path, not beginning
1833 with '/' (On the map "/peterm/FireTemple/Fire2" for example I could use the
1834 relative path "Fire1"). Use relative paths whenever possible! Note that
1835 upper/lower case must always be set correctly. However, please use lower
1836 case only.
1837 It is well possible to have an exit pointing to the same map that the exit
1838 is on. If slaying is not set in an exit, the player will see a message like
1839 "the exit is closed".
1840 </attribute>
1841 <attribute arch="hp" editor="destination X" type="int">
1842 The exit destinations define the (x, y)-coordinates where the exit
1843 leads to.
1844 If both are set to zero, the player will be transferred to the "default
1845 enter location" of the destined map. The latter can be set in the map-
1846 properties as "Enter X/Y". Though, please DO NOT use that.
1847 It turned out to be a source for numerous map-bugs.
1848 </attribute>
1849 <attribute arch="sp" editor="destination Y" type="int">
1850 The exit destinations define the (x, y)-coordinates where the exit
1851 leads to.
1852 If both are set to zero, the player will be transferred to the "default
1853 enter location" of the destined map. The latter can be set in the map-
1854 properties as "Enter X/Y". Though, please DO NOT use that.
1855 It turned out to be a source for numerous map-bugs.
1856 </attribute>
1857 &move_on;
1858 <attribute arch_begin="msg" arch_end="endmsg" editor="exit message" type="text">
1859 If set, this message will be displayed to the player when he applies the exit.
1860 This is quite useful to throw in some "role-play feeling": "As you enter the
1861 dark cave you hear the sound of rustling dragonscales...". Well, my english
1862 is poor, but you get the point. =)
1863 </attribute>
1864 <attribute arch="unique" editor="unique destination" type="bool">
1865 This flag defines the destined map as "personal unique map". If set,
1866 there will be a seperate version of that map for every player out there.
1867 This feature is used for the permanent apartments
1868 (in Scorn/Nuernberg/Caterham...). It should not be used for anything else
1869 than apartments, since Crossfire is a *multi*player game. In such a permanent
1870 apartment don't forget to set the unique-flag for all floor tiles too
1871 (see floors).
1872 An exit pointing outside of a personal unique map must have the
1873 "unique destination"-flag unset.
1874 </attribute>
1875 </type>
1876
1877 <!--####################################################################-->
1878 <type number="72" name="Flesh">
1879 <description><![CDATA[
1880 Just like with food, the player can fill his stomache and gain a
1881 little health by eating flesh-objects. <br>
1882 For dragon players, flesh plays a very special role though: If the
1883 flesh has resistances set, a dragon player has a chance to gain resistance in
1884 those categories. The only constraint to this process is the &lt;flesh level&gt;.
1885 Don't forget that flesh items with resistances have to be balanced
1886 according to map/monster difficulty. ]]>
1887 </description>
1888 <use><![CDATA[
1889 For dragon players, flesh items can be highly valuable. Note that many
1890 standard monsters carry flesh items from their &lt;treasurelist&gt;.
1891 These flesh items "inherit" resistances and level from the monster they belong to.
1892 When you add special flesh items to the inventory of a monster, this is
1893 not the case - so you have to set it manually.
1894 <br><br>
1895 Generally adding special flesh-treaties for dragon players is a great thing
1896 to do. Always consider that dragon players might really not be interested
1897 in that special piece of weapon or armour, so don't let the dragon-fellows miss
1898 out on the reward completely. ]]>
1899 </use>
1900 <attribute arch="food" editor="foodpoints" type="int">
1901 The player's stomache will get filled with this amount of foodpoints.
1902 The player's health will increase by &lt;foodpoints&gt;/50 hp.
1903 </attribute>
1904 <attribute arch="level" editor="flesh level" type="int">
1905 The &lt;flesh level&gt; is not visible to the players and it affects only
1906 dragon players. Normally this value reflects the level of the monster
1907 from which the flesh item originates.
1908 Dragon players always search for flesh of highest level possible,
1909 because it bears the best chance to gain high resistances.
1910 </attribute>
1911 <attribute arch="startequip" editor="godgiven item" type="bool">
1912 A godgiven item vanishes as soon as the player
1913 drops it to the ground.
1914 </attribute>
1915 <section name="resistance">
1916 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
1917 Resistances on flesh items make them more durable against spellcraft
1918 of the appropriate kind. It also allows dragon players to eventually gain
1919 resistance by eating it. Usually resistance should only be set for flesh
1920 items in a monster's inventory.
1921 </attribute>
1922 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
1923 Resistances on flesh items make them more durable against spellcraft
1924 of the appropriate kind. It also allows dragon players to eventually gain
1925 resistance by eating it. Usually resistance should only be set for flesh
1926 items in a monster's inventory.
1927 </attribute>
1928 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
1929 Resistances on flesh items make them more durable against spellcraft
1930 of the appropriate kind. It also allows dragon players to eventually gain
1931 resistance by eating it. Usually resistance should only be set for flesh
1932 items in a monster's inventory.
1933 </attribute>
1934 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
1935 Resistances on flesh items make them more durable against spellcraft
1936 of the appropriate kind. It also allows dragon players to eventually gain
1937 resistance by eating it. Usually resistance should only be set for flesh
1938 items in a monster's inventory.
1939 </attribute>
1940 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
1941 Resistances on flesh items make them more durable against spellcraft
1942 of the appropriate kind. It also allows dragon players to eventually gain
1943 resistance by eating it. Usually resistance should only be set for flesh
1944 items in a monster's inventory.
1945 </attribute>
1946 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
1947 Resistances on flesh items make them more durable against spellcraft
1948 of the appropriate kind. It also allows dragon players to eventually gain
1949 resistance by eating it. Usually resistance should only be set for flesh
1950 items in a monster's inventory.
1951 </attribute>
1952 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
1953 Resistances on flesh items make them more durable against spellcraft
1954 of the appropriate kind. It also allows dragon players to eventually gain
1955 resistance by eating it. Usually resistance should only be set for flesh
1956 items in a monster's inventory.
1957 </attribute>
1958 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
1959 Resistances on flesh items make them more durable against spellcraft
1960 of the appropriate kind. It also allows dragon players to eventually gain
1961 resistance by eating it. Usually resistance should only be set for flesh
1962 items in a monster's inventory.
1963 </attribute>
1964 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
1965 Resistances on flesh items make them more durable against spellcraft
1966 of the appropriate kind. It also allows dragon players to eventually gain
1967 resistance by eating it. Usually resistance should only be set for flesh
1968 items in a monster's inventory.
1969 </attribute>
1970 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
1971 Resistances on flesh items make them more durable against spellcraft
1972 of the appropriate kind. It also allows dragon players to eventually gain
1973 resistance by eating it. Usually resistance should only be set for flesh
1974 items in a monster's inventory.
1975 </attribute>
1976 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
1977 Resistances on flesh items make them more durable against spellcraft
1978 of the appropriate kind. It also allows dragon players to eventually gain
1979 resistance by eating it. Usually resistance should only be set for flesh
1980 items in a monster's inventory.
1981 </attribute>
1982 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
1983 Resistances on flesh items make them more durable against spellcraft
1984 of the appropriate kind. It also allows dragon players to eventually gain
1985 resistance by eating it. Usually resistance should only be set for flesh
1986 items in a monster's inventory.
1987 </attribute>
1988 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
1989 Resistances on flesh items make them more durable against spellcraft
1990 of the appropriate kind. It also allows dragon players to eventually gain
1991 resistance by eating it. Usually resistance should only be set for flesh
1992 items in a monster's inventory.
1993 </attribute>
1994 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
1995 Resistances on flesh items make them more durable against spellcraft
1996 of the appropriate kind. It also allows dragon players to eventually gain
1997 resistance by eating it. Usually resistance should only be set for flesh
1998 items in a monster's inventory.
1999 </attribute>
2000 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
2001 Resistances on flesh items make them more durable against spellcraft
2002 of the appropriate kind. It also allows dragon players to eventually gain
2003 resistance by eating it. Usually resistance should only be set for flesh
2004 items in a monster's inventory.
2005 </attribute>
2006 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
2007 RResistances on flesh items make them more durable against spellcraft
2008 of the appropriate kind. It also allows dragon players to eventually gain
2009 resistance by eating it. Usually resistance should only be set for flesh
2010 items in a monster's inventory.
2011 </attribute>
2012 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
2013 Resistances on flesh items make them more durable against spellcraft
2014 of the appropriate kind. It also allows dragon players to eventually gain
2015 resistance by eating it. Usually resistance should only be set for flesh
2016 items in a monster's inventory.
2017 </attribute>
2018 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
2019 Resistances on flesh items make them more durable against spellcraft
2020 of the appropriate kind. It also allows dragon players to eventually gain
2021 resistance by eating it. Usually resistance should only be set for flesh
2022 items in a monster's inventory.
2023 </attribute>
2024 </section>
2025 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2026 This text may describe the item.
2027 </attribute>
2028 </type>
2029
2030 <!--####################################################################-->
2031 <type number="0" name="Floor">
2032 <required>
2033 <attribute arch="is_floor" value="1" />
2034 <attribute arch="alive" value="0" />
2035 </required>
2036 <ignore>
2037 <ignore_list name="non_pickable" />
2038 </ignore>
2039 <description><![CDATA[
2040 Floor is a very basic thing whithout too much
2041 functionality. It's a floor - you stand on it. ]]>
2042 </description>
2043 <attribute arch="is_floor" value="1" type="fixed" />
2044 <attribute arch="no_pick" value="1" type="fixed" />
2045 <section name="terrain">
2046 &movement_types_terrain;
2047 <attribute arch="is_wooded" editor="wooded terrain" type="bool">
2048 This flag indicates this spot contains wood or high grass.
2049 Players with activated woodsman skill can move faster here.
2050 </attribute>
2051 <attribute arch="is_hilly" editor="hilly terrain" type="bool">
2052 This flag indicates this spot contains hills or large rocks.
2053 Players with activated mountaineer skill can move faster here.
2054 </attribute>
2055 </section>
2056 <attribute arch="no_magic" editor="no spells" type="bool">
2057 If enabled, it is impossible for players to use (wizard-)
2058 spells on that spot.
2059 </attribute>
2060 <attribute arch="damned" editor="no prayers" type="bool">
2061 If enabled, it is impossible for players to use prayers
2062 on that spot. It also prevents players from saving.
2063 </attribute>
2064 <attribute arch="unique" editor="unique map" type="bool">
2065 Unique floor means that any items dropped on that spot
2066 will be saved byond map reset. For permanent apartments,
2067 all floor tiles must be set &lt;unique map&gt;.
2068 </attribute>
2069 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2070 This text may describe the object.
2071 </attribute>
2072 </type>
2073
2074 <!--####################################################################-->
2075 <type number="67" name="Floor (Encounter)">
2076 <ignore>
2077 <ignore_list name="non_pickable" />
2078 </ignore>
2079 <description><![CDATA[
2080 Encounter-Floor is pretty much the same as normal floor.
2081 Most outdoor floor/ground-arches are set to be "encounters".
2082 That is kind of a relict from former code: When walking over
2083 encounter-floor, players sometimes got beamed to little maps
2084 with monsters on them. Nowadays this feature is disabled -
2085 Hence encounter floor is not different from normal floor. ]]>
2086 </description>
2087 <attribute arch="is_floor" value="1" type="fixed" />
2088 <attribute arch="no_pick" value="1" type="fixed" />
2089 <section name="terrain">
2090 &movement_types_terrain;
2091 <attribute arch="is_wooded" editor="wooded terrain" type="bool">
2092 This flag indicates this spot contains wood or high grass.
2093 Players with activated woodsman skill can move faster here.
2094 </attribute>
2095 <attribute arch="is_hilly" editor="hilly terrain" type="bool">
2096 This flag indicates this spot contains hills or large rocks.
2097 Players with activated mountaineer skill can move faster here.
2098 </attribute>
2099 </section>
2100 <attribute arch="no_magic" editor="no spells" type="bool">
2101 If enabled, it is impossible for players to use (wizard-)
2102 spells on that spot.
2103 </attribute>
2104 <attribute arch="damned" editor="no prayers" type="bool">
2105 If enabled, it is impossible for players to use prayers
2106 on that spot. It also prevents players from saving.
2107 </attribute>
2108 <attribute arch="unique" editor="unique map" type="bool">
2109 Unique floor means that any items dropped on that spot
2110 will be saved byond map reset. For permanent apartments,
2111 all floor tiles must be set &lt;unique map&gt;.
2112 </attribute>
2113 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2114 This text may describe the object.
2115 </attribute>
2116 </type>
2117
2118 <!--####################################################################-->
2119 <type number="6" name="Food">
2120 <description><![CDATA[
2121 By eating/drinking food-objects, the player can fill his
2122 stomache and gain a little health. ]]>
2123 </description>
2124 <attribute arch="food" editor="foodpoints" type="int">
2125 The player's stomache will get filled with this amount of foodpoints.
2126 The player's health will increase by &lt;foodpoints&gt;/50 hp.
2127 </attribute>
2128 <attribute arch="startequip" editor="godgiven item" type="bool">
2129 A godgiven item vanishes as soon as the player
2130 drops it to the ground.
2131 </attribute>
2132 </type>
2133
2134 <!--####################################################################-->
2135 <type number="91" name="Gate">
2136 <ignore>
2137 <ignore_list name="non_pickable" />
2138 </ignore>
2139 <description><![CDATA[
2140 Gates play an important role in Crossfire. Gates can be opened
2141 by activating a button/trigger, by speaking passwords (-> magic_ear)
2142 or carrying special key-objects (-> inventory checker).
2143 Unlike locked doors, gates can get shut again after a player has
2144 passed, which makes them more practical in many cases. ]]>
2145 </description>
2146 <use><![CDATA[
2147 Use gates to divide your maps into seperated areas. After solving
2148 area A, the player gains access to area B, and so on. Make your
2149 maps more complex than "one-way". ]]>
2150 </use>
2151 <attribute arch="no_pick" value="1" type="fixed" />
2152 <attribute arch="speed" value="1" type="float">
2153 The speed of the gate affects how fast it is closing/opening.
2154 </attribute>
2155 <attribute arch="connected" editor="connection" type="int">
2156 Whenever the inventory checker is triggered, all objects with identical
2157 &lt;connection&gt; value get activated. This only makes sense together with
2158 &lt;blocking passage&gt; disabled.
2159 </attribute>
2160 <attribute arch="wc" editor="position state" type="int">
2161 The &lt;position state&gt; defines the position of the gate:
2162 Zero means completely open/down, the "number of animation-steps" (usually
2163 about 6 or 7) means completely closed/up state. I suggest you don't
2164 mess with this value - Leave the default in place.
2165 </attribute>
2166 &movement_types_terrain;
2167 <attribute arch="no_magic" editor="restrict spells" type="bool">
2168 Restricting the use of spells to pass this gate. This has
2169 an effect only if &lt;block view&gt; is disabled.
2170 </attribute>
2171 <attribute arch="damned" editor="restrict prayers" type="bool">
2172 Restricting the use of prayers to pass this door. This has
2173 an effect only if &lt;block view&gt; is disabled.
2174 </attribute>
2175 </type>
2176
2177 <!--####################################################################-->
2178 <type number="113" name="Girdle">
2179 <import_type name="Amulet" />
2180 <description><![CDATA[
2181 Wearing a girdle, the object's stats will directly be inherited to
2182 the player. Girdles usually provide stats- or damage bonuses and no
2183 defense. ]]>
2184 </description>
2185 <use><![CDATA[
2186 Feel free to create your own special artifacts. However, it is very
2187 important that you keep your artifact in balance with existing maps. ]]>
2188 </use>
2189 <attribute arch="magic" editor="magic bonus" type="int">
2190 &lt;magic bonus&gt; works just like ac, except that it can be improved by
2191 "scrolls of Enchant Armour" or reduced by acid. It is less useful
2192 than direct armour-class bonus on the helmet.
2193
2194 Important: &lt;magic bonus&gt; on girdles has no effect if there is no
2195 &lt;armour class&gt; set. Girdles shouldn't have &lt;armour class&gt;, thus
2196 &lt;magic bonus&gt; is pointless here.
2197 </attribute>
2198 </type>
2199
2200 <!--####################################################################-->
2201 <type number="100" name="Gloves">
2202 <import_type name="Amulet" />
2203 <description><![CDATA[
2204 Wearing gloves, the object's stats will directly be inherited to
2205 the player. Gloves can add defense or damage bonuses. ]]>
2206 </description>
2207 <use><![CDATA[
2208 Feel free to create your own special artifacts. However, it is very
2209 important that you keep your artifact in balance with existing maps. ]]>
2210 </use>
2211 <attribute arch="magic" editor="magic bonus" type="int">
2212 If the gloves provide &lt;armour class&gt;, &lt;magic bonus&gt; will increase it.
2213 If the gloves have &lt;weapon class&gt; instead, then &lt;magic bonus&gt;
2214 will increase that.
2215 </attribute>
2216 </type>
2217
2218 <!--####################################################################-->
2219 <type number="93" name="Handle">
2220 <ignore>
2221 <ignore_list name="non_pickable" />
2222 </ignore>
2223 <description><![CDATA[
2224 A handle can be applied by players and (certain) monsters.
2225 Every time it is applied, the &lt;connection&gt; value is triggered. ]]>
2226 </description>
2227 <use><![CDATA[
2228 Handles are commonly used to move gates. When placing your lever,
2229 don't forget that some monsters are able to apply it.
2230 The ability to apply levers is rare among monsters -
2231 but vampires can do it for example. ]]>
2232 </use>
2233 <attribute arch="no_pick" value="1" type="fixed" />
2234 <attribute arch="connected" editor="connection" type="int">
2235 Every time the handle is applied, all objects
2236 with the same &lt;connection&gt; value are activated.
2237 </attribute>
2238 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2239 This text may describe the item. You can use this
2240 message to explain the handle's purpose to the player.
2241 </attribute>
2242 </type>
2243
2244 <!--####################################################################-->
2245 <type number="27" name="Handle Trigger">
2246 <import_type name="Handle" />
2247 <ignore>
2248 <ignore_list name="non_pickable" />
2249 </ignore>
2250 <description><![CDATA[
2251 Handle triggers are handles which reset after a short period
2252 of time. Every time it is either applied or reset, the
2253 &lt;connection&gt; value is triggered. ]]>
2254 </description>
2255 <use><![CDATA[
2256 When you connect an ordinary handle to a gate, the gate normally remains
2257 opened after the first player passed. If you want to keep the gate shut,
2258 connecting it to a handle trigger is an easy solution. ]]>
2259 </use>
2260 </type>
2261
2262 <!--####################################################################-->
2263 <type number="88" name="Hazard Floor">
2264 <required>
2265 <attribute arch="is_floor" value="1" />
2266 </required>
2267 <ignore>
2268 <ignore_list name="non_pickable" />
2269 </ignore>
2270 <description><![CDATA[
2271 The best example for Hazard Floor is lava. It works like standard
2272 floor, but damages all creatures standing on it.
2273 Damage is taken in regular time intervals. ]]>
2274 </description>
2275 <use><![CDATA[
2276 The default lava for example does minor damage. But you can turn
2277 it up so that your hazard floor poses a real threat.<br>
2278 Like magic walls, such floors add a permanent thrill to your map.
2279 You can use that to safely chase off too-weak players, or just
2280 to have something different. ]]>
2281 </use>
2282 <attribute arch="is_floor" value="1" type="fixed" />
2283 <attribute arch="lifesave" value="1" type="fixed" />
2284 &move_on;
2285 <attribute arch="no_pick" value="1" type="fixed" />
2286 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
2287 This attribute specifys the attacktypes that this floor uses to
2288 damage it's victims. Attacktypes are: physical, fire, cold.. etc.
2289 If you want a real tough hazard floor, add more than just one attacktype.
2290 </attribute>
2291 <attribute arch="dam" editor="base damage" type="int">
2292 The &lt;base damage&gt; defines how much damage is inflicted to the
2293 victim per hit. The final damage is influenced by several other
2294 factors like the victim's resistance and level.
2295 </attribute>
2296 <attribute arch="wc" editor="weaponclass" type="int">
2297 &lt;weapon class&gt; improves the chance of hitting the victim.
2298 Lower values are better.
2299 Usually, hazard floors like lava are supposed to hit the
2300 victim all the time. Therefore, &lt;weaponclass&gt; should be set
2301 to something like -30.
2302 </attribute>
2303 <attribute arch="level" editor="attack level" type="int">
2304 I guess this value is supposed to work similar to monster levels.
2305 But in fact, it does not seem to have an effect. Set any non-zero
2306 value to be on the safe side.
2307 </attribute>
2308 <section name="terrain">
2309 &movement_types_terrain;
2310 <attribute arch="is_wooded" editor="wooded terrain" type="bool">
2311 This flag indicates this spot contains wood or high grass.
2312 Players with activated woodsman skill can move faster here.
2313 </attribute>
2314 <attribute arch="is_hilly" editor="hilly terrain" type="bool">
2315 This flag indicates this spot contains hills or large rocks.
2316 Players with activated mountaineer skill can move faster here.
2317 </attribute>
2318 </section>
2319 <attribute arch="no_magic" editor="no spells" type="bool">
2320 If enabled, it is impossible for players to use (wizard-)
2321 spells on that spot.
2322 </attribute>
2323 <attribute arch="damned" editor="no prayers" type="bool">
2324 If enabled, it is impossible for players to use prayers
2325 on that spot. It also prevents players from saving.
2326 </attribute>
2327 <attribute arch="unique" editor="unique map" type="bool">
2328 Unique floor means that any items dropped on that spot
2329 will be saved byond map reset. For permanent apartments,
2330 all floor tiles must be set &lt;unique map&gt;.
2331 </attribute>
2332 </type>
2333
2334 <!--####################################################################-->
2335 <type number="34" name="Helmet">
2336 <import_type name="Amulet" />
2337 <description><![CDATA[
2338 Wearing a helmet, the object's stats will directly be inherited to
2339 the player. Normal helmets usually increase defense, while crowns
2340 add more special bonuses like stats/resistances paired with
2341 low defense. ]]>
2342 </description>
2343 <use><![CDATA[
2344 Feel free to create your own special artifacts. However, it is very
2345 important that you keep your artifact in balance with existing maps. ]]>
2346 </use>
2347 <attribute arch="magic" editor="magic bonus" type="int">
2348 &lt;magic bonus&gt; works just like ac, except that it can be improved by
2349 "scrolls of Enchant Armour" or reduced by acid. It is less useful
2350 than direct armour-class bonus on the helmet.
2351
2352 Important: &lt;magic bonus&gt; on helmets has no effect if there is no
2353 &lt;armour class&gt; set. It only works in combination with &lt;armour class&gt;.
2354 Crowns for instance typically provide no &lt;amour class&gt;.
2355 </attribute>
2356 </type>
2357
2358 <!--####################################################################-->
2359 <type number="56" name="Holy Altar">
2360 <ignore>
2361 <ignore_list name="non_pickable" />
2362 </ignore>
2363 <description><![CDATA[
2364 Holy_altars are altars for the various religions. Praying
2365 at a Holy_altar will make you a follower of that god, and
2366 if you already follow that god, you may get some extra bonus. ]]>
2367 </description>
2368 <attribute arch="no_pick" value="1" type="fixed" />
2369 <attribute arch="other_arch" editor="god name" type="string">
2370 The altar belongs to the god of the given name. Possible options for
2371 &lt;god name&gt; are: Devourers, Lythander, Mostrai, Gaea, Ruggilli, Gnarg,
2372 Gorokh, Valriel and Sorig.
2373
2374 If you want to have an unconsecrated altar, set
2375 &lt;god name&gt; 0 and eventually &lt;reconsecrate level&gt; 0.
2376 </attribute>
2377 <attribute arch="level" editor="reconsecrate level" type="int">
2378 To re-consecrate an altar, the player's wisdom level must be as
2379 high or higher than this value. In that way, some altars can not
2380 be re-consecrated, while other altars, like those in dungeons, could be.
2381
2382 Altars located in temples should have at least &lt;reconsecrate level&gt; 120.
2383 Some characters might need those altars, they would be very unhappy to
2384 see them re-consecrated to another cult.
2385 </attribute>
2386 </type>
2387
2388 <!--####################################################################-->
2389 <type number="35" name="Horn">
2390 <ignore>
2391 <attribute arch="title" />
2392 </ignore>
2393 <description><![CDATA[
2394 Horns are very similar to rods. The difference is that horns regenerate
2395 spellpoints faster and thus are more valuable than rods.
2396 <br><br>
2397 A horn contains a spell. The player can use this spell by applying and
2398 "fireing" (blowing) the horn. Unlike wands/scrolls, horns can be
2399 used endlessly. ]]>
2400 </description>
2401 <use><![CDATA[
2402 Horns are powerful due to their fast recharge rate. They should
2403 never contain high level attacking spells. Even curing/healing spells
2404 are almost too good on a horn. ]]>
2405 </use>
2406 <attribute arch="sp" editor="spell" type="spell">
2407 Sets the &lt;spell&gt; of the horn. Consider twice before handing out any
2408 horns to players, since they can be used endlessly without any mana cost!
2409 Horns with heal/ restoration/ protection spells, IF available, MUST be
2410 very very VERY hard to get!
2411 </attribute>
2412 <attribute arch="level" editor="casting level" type="int">
2413 The casting level of the &lt;spell&gt; determines it's power.
2414 For attack spells, level should not be set too high.
2415 </attribute>
2416 <attribute arch="hp" editor="initial spellpoints" type="int">
2417 This value represents the initial amount of spellpoints in the horn.
2418 Naturally, this is quite unimportant.
2419 </attribute>
2420 <attribute arch="maxhp" editor="max. spellpoints" type="int">
2421 When the horn is fully charged up, it will hold this maximum amount of
2422 spellpoints. Make sure it is enough to cast the contained spell at least
2423 once. But don't set the value too high, as that might make the horn way
2424 too effective.
2425 </attribute>
2426 <attribute arch="startequip" editor="godgiven item" type="bool">
2427 A godgiven item vanishes as soon as the player
2428 drops it to the ground.
2429 </attribute>
2430 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2431 This text may contain a description of the horn.
2432 </attribute>
2433 </type>
2434
2435 <!--####################################################################-->
2436 <type number="73" name="Inorganic">
2437 <description><![CDATA[
2438 Inorganic materials are generally used as ingredients for
2439 alchemical receipes. By themselves, they have no special
2440 functionalities. ]]>
2441 </description>
2442 <attribute arch="is_dust" editor="is dust" type="bool">
2443 </attribute>
2444 <section name="resistance">
2445 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
2446 </attribute>
2447 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
2448 </attribute>
2449 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
2450 </attribute>
2451 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
2452 </attribute>
2453 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
2454 </attribute>
2455 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
2456 </attribute>
2457 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
2458 </attribute>
2459 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
2460 </attribute>
2461 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
2462 </attribute>
2463 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
2464 </attribute>
2465 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
2466 </attribute>
2467 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
2468 </attribute>
2469 </section>
2470 </type>
2471
2472 <!--####################################################################-->
2473 <type number="64" name="Inventory Checker">
2474 <ignore>
2475 <ignore_list name="system_object" />
2476 </ignore>
2477 <description><![CDATA[
2478 Inventory checkers passively check the players inventory for a
2479 specific object. You can set a connected value that is triggered
2480 either if that object is present or missing (-&gt; "last_sp") when a
2481 player walks over the inv. checker. A valid option is to remove the
2482 matching object (usually not recommended, see "last_heal").
2483 <br><br>
2484 Alternatively, you can set your inv. checker to block all players
2485 that do/don't carry the matching object.
2486 <br><br>
2487 As you can see, inv. checkers are quite powerful, holding a
2488 great variety of possibilities. ]]>
2489 </description>
2490 <use><![CDATA[
2491 Putting a check_inventory space in front of a gate (one below) and
2492 one on the opposite side works reasonably well as a control mechanism.
2493 Unlike the key/door-combo, this one works infinite since it is
2494 independant from map reset. Use it to put a "structure" into your
2495 maps: Player must solve area A to gain access to area B. This concept
2496 can be found in nearly every RPG - simple but effective. ]]>
2497 </use>
2498 <attribute arch="no_pick" value="1" type="fixed" />
2499 <attribute arch="slaying" editor="match key string" type="string">
2500 This string specifies the object we are looking for: We have a match
2501 if the player does/don't carry a key object or a mark with identical
2502 &lt;key string&gt;. Note that key objects usually appear as "passports" in
2503 this context. A typical example is the city gate mechanism of scorn.
2504 </attribute>
2505 <attribute arch="race" editor="match arch name" type="string">
2506 This string specifies the object we are looking for: We have a match
2507 if the player does/don't carry an object of archtype &lt;match arch name&gt;.
2508 </attribute>
2509 <attribute arch="hp" editor="match type" type="int">
2510 This value specifies the object we are looking for: We have a match
2511 if the player does/don't carry an object that is of type &lt;match type&gt;.
2512
2513 Example: Set &lt;match type&gt; 15 (type 15 =&gt; weapon) and &lt;blocking passage&gt;
2514 enabled. Now you have an inv. checker blocking all players that carry any
2515 kind of melee weapon. To pass, a player is forced to leave behind all
2516 his weaponry... bad news for a warrior. ;)
2517 </attribute>
2518 <attribute arch="last_sp" editor="match = having" type="bool">
2519 Enabled means having that object is a match.
2520 Disabled means not having that object is a match.
2521 </attribute>
2522 <attribute arch="connected" editor="connection" type="int">
2523 Whenever the inventory checker is triggered, all objects with identical
2524 &lt;connection&gt; value get activated. This only makes sense together with
2525 &lt;blocking passage&gt; disabled.
2526 </attribute>
2527 &movement_types_terrain;
2528 <attribute arch="last_heal" editor="remove match" type="bool">
2529 &lt;remove match&gt; means remove object if found. Setting this is usually not
2530 recommended because inv. checkers are in general invisible. So, unlike
2531 for altars/ locked doors, the player won't expect to lose an object when
2532 walking over that square. And he doesn't even get a message either.
2533
2534 So, *if* you enable &lt;remove match&gt;, make sure
2535 to inform the player what's going on!
2536 </attribute>
2537 </type>
2538
2539 <!--####################################################################-->
2540 <type number="163" name="Item Transformer">
2541 <description><![CDATA[
2542 An item transformer is simply applied, after having marked a 'victim'
2543 item. If the victim is suitable, it will be transformed into something
2544 else.]]>
2545 </description>
2546 <use><![CDATA[
2547 To make an item transformable, you just have to fill the 'slaying' field.
2548 The syntax is:
2549 <br>
2550 <pre>slaying slayer:[yield ]new_item[;slayer:[yield ]new_item]*</pre>
2551 <br>
2552 with [] denoting optional part, and * any number of preceding [].
2553 'new_item' must be the name of an existing archetype.
2554 <br><br>
2555 Example, for object apple: slaying knife:2 half_apple
2556 <br><br>
2557 This means that, when applying a knife (should be an Item Transformer),
2558 one 'apple' will be transformed into 2 'half_apple'.]]>
2559 </use>
2560 <attribute arch="food" editor="number of uses" type="int">
2561 &lt;number of uses&gt; controls how many times the item transformer can
2562 be used. The value 0 means "unlimited"
2563 </attribute>
2564 <attribute arch="slaying" editor="verb" type="string">
2565 Contains the verb that is used to construct a message to the player
2566 applying the item transformer.
2567 </attribute>
2568 <attribute arch="startequip" editor="godgiven item" type="bool">
2569 A godgiven item vanishes as soon as the player
2570 drops it to the ground.
2571 </attribute>
2572 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2573 This text may contain a description of the item transformer.
2574 </attribute>
2575 </type>
2576
2577 <!--####################################################################-->
2578 <type number="60" name="Jewel">
2579 <description><![CDATA[
2580 Items of the type Gold &amp; Jewels are handled like a currency.
2581 Unlike for any other type of item, in shops, the buy- and selling
2582 prices differ only marginally. ]]>
2583 </description>
2584 <attribute arch="race" value="gold and jewels" type="fixed" />
2585 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
2586 This text may describe the object.
2587 </attribute>
2588 </type>
2589
2590 <!--####################################################################-->
2591 <type number="24" name="Key">
2592 <description><![CDATA[
2593 When carrying a key, a normal door can be opened. The key will
2594 disappear. ]]>
2595 </description>
2596 <attribute arch="startequip" editor="godgiven item" type="bool">
2597 A godgiven item vanishes as soon as the player
2598 drops it to the ground.
2599 </attribute>
2600 </type>
2601
2602 <!--####################################################################-->
2603 <type number="20" name="Locked Door">
2604 <ignore>
2605 <ignore_list name="non_pickable" />
2606 </ignore>
2607 <description><![CDATA[
2608 A locked door can be opened only when carrying
2609 the appropriate special key. ]]>
2610 </description>
2611 <use><![CDATA[
2612 If you want to create a locked door that cannot be opened (no key),
2613 set a &lt;key string&gt; like "no_key_available". This will clearify things
2614 and only a fool would create a key matching that string.
2615
2616 Door-objects can not only be used for "doors". In many maps these
2617 are used with all kinds of faces/names, especially often as
2618 "magic force". A good example is the map "Lake_Country/ebony/masterlev".
2619 There you have magic forces (door objects) put under certain artifact
2620 items. To get your hands on the artifacts, you need to bring up the
2621 appropriate quest items (key objects). ]]>
2622 </use>
2623 <attribute arch="move_type" value="0" type="fixed" />
2624 <attribute arch="no_pick" value="1" type="fixed" />
2625 <attribute arch="slaying" editor="key string" type="string">
2626 The &lt;key string&gt; in the door must be identical with the
2627 &lt;key string&gt; in the special key, then the door is unlocked.
2628 It is VERY important to set the &lt;key string&gt; to something that
2629 is unique among the CF mapset.
2630
2631 DONT EVER USE the default string "set_individual_value".
2632 </attribute>
2633 <attribute arch="no_magic" editor="restrict spells" type="bool">
2634 Restricting the use of spells to pass this door.
2635 This should be set in most cases.
2636 (Don't forget that the spell "dimension door" is easily
2637 available at about wisdom level 10).
2638 </attribute>
2639 <attribute arch="damned" editor="restrict prayers" type="bool">
2640 Restricting the use of prayers to pass this door.
2641 This should be set in most cases.
2642 </attribute>
2643 <attribute arch_begin="msg" arch_end="endmsg" editor="lock message" type="text">
2644 When a player is trying to open the door without carrying the
2645 appropriate key, this text is displayed to the player. This is
2646 a good opportunity to place hints about the special key needed
2647 to unlock the door.
2648 </attribute>
2649 </type>
2650
2651 <!--####################################################################-->
2652 <type number="29" name="Magic Ear">
2653 <ignore>
2654 <ignore_list name="system_object" />
2655 </ignore>
2656 <description><![CDATA[
2657 Magic_ears trigger a connected value
2658 when the player speaks a specific keyword. ]]>
2659 </description>
2660 <use><![CDATA[
2661 Whenever you put magic_ears on your maps, make sure there are
2662 CLEAR and RELYABLE hints about the keywords somewhere. Don't make
2663 something like a gate that is opened by speaking "open" or
2664 "sesame", expecting the player to figure this out all by himself.
2665 <br><br>
2666 Magic_ears are typically used for interaction with NPCs. You
2667 can create the impression that the NPC actually *does* something
2668 according to his conversation with a player. Mostly this means
2669 opening a gate or handing out some item, but you could be quite
2670 creative here. ]]>
2671 </use>
2672 <attribute arch="no_pick" value="1" type="fixed" />
2673 <attribute arch="connected" editor="connection" type="int">
2674 The Magic_ear will trigger all objects with the
2675 same connection value, every time it is activated.
2676 </attribute>
2677 <attribute arch_begin="msg" arch_end="endmsg" editor="keyword-matching" type="text">
2678 This textfield contains the keyword-matching-syntax. The text should
2679 have the following format: "@match &lt;keyword1&gt;|&lt;keyword2&gt;|... ".
2680 Any number of keywords from one to infinite is allowed. Make sure
2681 they are seperated by a '|'.
2682
2683 Examples: "@match yes", "@match gold|treasure". The connected
2684 value will be triggerd when the player speaks any of the given
2685 keywords within a two-square radius. IMPORTANT: Upper/lower case
2686 does not make a difference!
2687 </attribute>
2688 </type>
2689
2690 <!--####################################################################-->
2691 <type number="62" name="Magic Wall">
2692 <ignore>
2693 <ignore_list name="non_pickable" />
2694 </ignore>
2695 <description><![CDATA[
2696 Magic walls fire spells in a given direction, in regular intervals.
2697 Magic walls can contain any spell. However, some spells do not
2698 operate very successfully in them. The only way to know is to test
2699 the spell you want to use with a wall.
2700 <br><br>
2701 Several types of magical walls are predefined for you in the
2702 archetypes, and can be found on the "connected" Pickmap. ]]>
2703 </description>
2704 <use><![CDATA[
2705 Spellcasting walls pose an interesting alternative to monsters.
2706 Usually they are set to be undestroyable. Thus, while monsters
2707 in a map can be cleared out, the magic walls remain. Low level
2708 characters for example will not be able to pass through their
2709 spell-area, hence they cannot loot a map that a high level character
2710 might have cleared out.
2711 <br><br>
2712 Another point of magic walls is that if the player dies, he has to face
2713 them all again. Magic walls can add a kind of "permanent thrill" to
2714 your maps.
2715 <br><br>
2716 Be careful that your magic walls don't kill the monsters on a map. If
2717 placing monsters, eventually take ones that are immune to the
2718 walls' spell(s).
2719 <br><br>
2720 It is possible to make walls rotate when triggered. But that is so
2721 confusing (and useless IMHO) that I did not mention it above. You
2722 can find a working example on the map
2723 "/pup_land/castle_eureca/castle_eureca8". ]]>
2724 </use>
2725 <attribute arch="dam" editor="spell" type="spell">
2726 The magic wall will cast this &lt;spell&gt;.
2727 </attribute>
2728 <attribute arch="level" editor="spell level" type="int">
2729 The wall will cast it's spells at level &lt;spell level&gt;. "level 1"
2730 walls cast spells at minimal strength. "level 100" walls cast deadly
2731 spells. Arch default is level 1 - you should always set this value
2732 to meet the overall difficulty of your map.
2733 </attribute>
2734 <attribute arch="connected" editor="connection" type="int">
2735 Every time the &lt;connection&gt; value is triggered, the wall will cast
2736 it's spell. You should set &lt;casting speed&gt; to zero, or this won't
2737 have much visible effect.
2738 </attribute>
2739 &activate_on;
2740 <attribute arch="speed" editor="casting speed" type="float">
2741 The &lt;casting speed&gt; defines the spellcasting speed of the wall.
2742 You can fine-tune how long the duration between two casts shall
2743 be. If you want to create a wall that can be activated (cast per
2744 trigger) via connected lever/button/etc, you must set "speed 0".
2745 </attribute>
2746 &speed_left;
2747 <attribute arch="sp" editor="direction" type="list_direction">
2748 The magic wall will cast it's spells always in the specified
2749 &lt;direction&gt;. A magic wall with direction set to &lt;none&gt; will
2750 always fire in a random direction.
2751 </attribute>
2752 &movement_types_terrain;
2753 <section name="destroyable">
2754 <attribute arch="alive" editor="is destroyable" type="bool">
2755 Walls with &lt;is destroyable&gt; enabled can be attacked and (eventually)
2756 destroyed by the player. If disabled, all other attributes on
2757 this tab, as well as resistances, are meaningless.
2758 </attribute>
2759 <attribute arch="hp" editor="hitpoints" type="int">
2760 The more &lt;hitpoints&gt; the wall has, the longer
2761 it takes to be destroyed.
2762 </attribute>
2763 <attribute arch="maxhp" editor="max hitpoints" type="int">
2764 &lt;max hitpoints&gt; are the maximum amount of hitpoints the wall
2765 can have. This only makes sense if the wall can regain health.
2766 </attribute>
2767 <attribute arch="ac" editor="armour class" type="int">
2768 A magic wall of high &lt;armour class&gt; is less likely to get hit from
2769 an opponent. &lt;armour class&gt; can be considered the "counterpiece"
2770 to &lt;weapon class&gt;.
2771 </attribute>
2772 </section>
2773 <section name="resistance">
2774 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
2775 </attribute>
2776 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
2777 </attribute>
2778 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
2779 </attribute>
2780 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
2781 </attribute>
2782 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
2783 </attribute>
2784 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
2785 </attribute>
2786 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
2787 </attribute>
2788 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
2789 </attribute>
2790 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
2791 </attribute>
2792 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
2793 </attribute>
2794 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
2795 </attribute>
2796 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
2797 </attribute>
2798 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
2799 </attribute>
2800 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
2801 </attribute>
2802 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
2803 </attribute>
2804 <attribute arch="resist_turn_undead" editor="resist turn undead %" length="15" type="int">
2805 </attribute>
2806 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
2807 </attribute>
2808 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
2809 </attribute>
2810 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
2811 </attribute>
2812 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
2813 </attribute>
2814 <attribute arch="resist_godpower" editor="resist godpower %" length="15" type="int">
2815 </attribute>
2816 </section>
2817 </type>
2818
2819 <!--####################################################################-->
2820 <type number="55" name="Marker">
2821 <ignore>
2822 <ignore_list name="system_object" />
2823 </ignore>
2824 <description><![CDATA[
2825 A marker is an object that inserts an invisible force (a mark) into a
2826 player stepping on it. This force does nothing except containing a
2827 &lt;key string&gt; which can be discovered by detectors or inventory
2828 checkers. It is also possible to use markers for removing marks again.
2829 <br><br>
2830 Note that the player has no possibility to "see" his own marks,
2831 except by the effect that they cause on the maps. ]]>
2832 </description>
2833 <use><![CDATA[
2834 Markers hold real cool possibilities for map-making. I encourage
2835 you to use them frequently. However there is one negative point
2836 about markers: Players don't "see" what's going on with them. It is
2837 your task, as map-creator, to make sure the player is always well
2838 informed and never confused.
2839 <br><br>
2840 Please avoid infinite markers when they aren't needed. They're
2841 using a little space in the player file after all, so if there
2842 is no real purpose, set an expire time. ]]>
2843 </use>
2844 <attribute arch="no_pick" value="1" type="fixed" />
2845 <attribute arch="slaying" editor="key string" type="string">
2846 The &lt;key string&gt; can be detected by inv. checkers/detectors.
2847 If the player already has a force with that &lt;key string&gt;,
2848 there won't be inserted a second one.
2849 </attribute>
2850 <attribute arch="connected" editor="connection" type="int">
2851 When the detector is triggered, all objects with the same
2852 connection value get activated.
2853 </attribute>
2854 <attribute arch="speed" editor="marking speed" type="float">
2855 The &lt;marking speed&gt; defines how quickly it will mark something
2856 standing on the marker. Set this value rather high to make
2857 sure the player really gets his mark. I think &lt;marking speed&gt; 1.0
2858 should do fine.
2859 </attribute>
2860 &speed_left;
2861 <attribute arch="food" editor="mark duration" type="int">
2862 This value defines the duration of the force it inserts.
2863 If nonzero, the duration of the player's mark is finite:
2864 about 1 food per 10 seconds. &lt;mark duration&gt; zero/unset
2865 means the mark will stay on the player forever.
2866 </attribute>
2867 <attribute arch="name" editor="delete mark" type="string">
2868 When the player steps onto the marker, all existing forces in
2869 the players inventory with a &lt;key string&gt; matching &lt;delete mark&gt;
2870 will be removed. If you don't want to remove any marks, leave
2871 this textfield empty.
2872
2873 Note that the string &lt;delete mark&gt; is set as the name of
2874 this marker. So don't be confused, and remember changing the
2875 name will take effect on the marker's functionality.
2876 </attribute>
2877 <attribute arch_begin="msg" arch_end="endmsg" editor="marking message" type="text">
2878 In the moment when the player gets marked, this text is displayed
2879 to him. You should really set a message in any marker you create,
2880 because it's the only way for the player to notice what's going on.
2881 </attribute>
2882 </type>
2883
2884 <!--####################################################################-->
2885 <type number="36" name="Money">
2886 <ignore>
2887 <attribute arch="unpaid" />
2888 </ignore>
2889 <description><![CDATA[
2890 Items of the type Money are handled as currency.
2891 Money cannot be sold/bought in shops. When money is dropped
2892 in a shop, it stays the same.<br>
2893 When a player picks an item from a shop and attempts to
2894 walk over the shop mat, the item's selling-price is automatically
2895 subtracted from the player's money.
2896 <br><br>
2897 For money, always use the default arches.
2898 Don't modify them. ]]>
2899 </description>
2900 <attribute arch="race" value="gold and jewels" type="fixed" />
2901 </type>
2902
2903 <!--####################################################################-->
2904 <type number="0" name="Monster &amp; NPC">
2905 <required>
2906 <attribute arch="is_floor" value="0" />
2907 <attribute arch="alive" value="1" />
2908 <attribute arch="tear_down" value="0" />
2909 </required>
2910 <ignore>
2911 <attribute arch="material" />
2912 <attribute arch="name_pl" />
2913 <attribute arch="nrof" />
2914 <attribute arch="value" />
2915 <attribute arch="unpaid" />
2916 </ignore>
2917 <description><![CDATA[
2918 Monsters can behave in various kinds of ways.
2919 They can be aggressive, attacking the player. Or peaceful,
2920 helping the player - maybe joining him as pet.
2921 The unagressive creatures who communicate with players are
2922 usually called "NPCs" (Non Player Character), a well-known
2923 term in role-play environments. ]]>
2924 </description>
2925 <use><![CDATA[
2926 Monsters play a central role in most maps. Choosing the right
2927 combination of monsters for your map is vital:
2928 <UL>
2929 <LI> Place only monsters of slightly varying (increasing) strength.
2930 It's no fun to play for two hours just to find out the last
2931 monster is unbeatable. Similar, it's not exciting to fight orcs
2932 after passing a room of dragons.<br>
2933 This rule applies only for linear maps (one room after the other),
2934 with treasure at the end. You can sprinkle the treasure around,
2935 or make non-linear maps - That is often more entertaining.
2936 <LI> Places with high level monsters must not be easy to reach.
2937 Balrogs, Dragonmen and the likes should be at the end of a quest,
2938 not at the beginning.
2939 <LI> Don't stick monsters together that tend to kill each other.
2940 Fire- and cold dragons in one room for example is a bad idea.
2941 By weakening and killing each other they are easy prey for players,
2942 not worth the experience they hold.
2943 <LI> Create your own monsters, especially for "boss"-type monsters.
2944 Having stage-bosses guarding treasure is a lot of fun when done right.
2945 Avoid to create monsters with completely non-intuitive abilities:
2946 Don't give ice-spells to firedragons or vice versa. Don't add
2947 draining attack to trolls, etc. Additionally, you should inform the
2948 player before he bumps right into some very special/unusual monster.
2949 <LI> Last but not least: Always keep an eye on the experience your monsters
2950 hold. Design your maps in a way that high experience
2951 is always well-defended. Don't make large rooms full with only one kind
2952 of monster. Keep in mind the different abilities/techniques players
2953 can use.
2954 </UL>
2955 I know it's impossible to make the perfectly balanced map. There's always
2956 some part which is found too easy or too hard for a certain kind of player.
2957 Just give it your best shot. And listen to feedback from players if you
2958 receive some. :-) ]]>
2959 </use>
2960 <attribute arch="alive" value="1" type="fixed" />
2961 <attribute arch="randomitems" editor="treasurelist" type="treasurelist">
2962 When the monster is killed, items from the treasurelist will
2963 drop to the ground. This is a common way to reward players
2964 for killing (masses of) monsters.
2965
2966 Note that you can always put items into the monster's
2967 inventory. Those will drop-at-kill just like the stuff
2968 from the &lt;treasurelist&gt;.
2969 </attribute>
2970 <attribute arch="level" editor="level" type="int">
2971 A monster's &lt;level&gt; is the most important attribute.
2972 &lt;level&gt; affects the power of a monster in various ways.
2973 </attribute>
2974 <attribute arch="race" editor="race" type="string">
2975 Every monster should have a race set to categorize it.
2976 The monster's &lt;race&gt; can have different effects:
2977 Slaying weapons inflict tripple damage against enemy races
2978 and holy word kills only enemy races of the god.
2979 </attribute>
2980 <attribute arch="exp" editor="experience" type="int">
2981 When a player kills this monster, he will get exactly this
2982 amount of &lt;experience&gt;. The experience will flow into
2983 the skill-category the player used for the kill.
2984
2985 If you create special monsters of tweaked strenght/abilities,
2986 always make sure that the &lt;experience&gt; is set to a
2987 reasonable value. Compare with existing arches to get a feeling
2988 what reasonable means. Keep in mind that spellcasting monsters
2989 are a lot harder to kill than non-spellcasters!
2990 </attribute>
2991 <attribute arch="speed" editor="speed" type="float">
2992 The &lt;speed&gt; determines how fast a monster will both move
2993 and fight. High &lt;speed&gt; makes a monster considerably stronger.
2994 </attribute>
2995 &speed_left;
2996 <attribute arch="other_arch" editor="breed monster" type="string">
2997 This only takes effect if &lt;multiply&gt; is enabled. The monster will
2998 create a &lt;breed monster&gt; every once in a while. &lt;breed monster&gt;
2999 can be set to any valid arch-name of a monster. Multipart monster
3000 should not be used.
3001 </attribute>
3002 <attribute arch="generator" editor="multiply" type="bool">
3003 Monsters with &lt;generator&gt; enabled will create a &lt;breed monster&gt;
3004 every once in a while. Mice are a good example for this effect.
3005 If enabled, you must also set &lt;breed monster&gt; or check
3006 &lt;template generation&gt; and put other monsters in the inventory.
3007 </attribute>
3008 <attribute arch="use_content_on_gen" editor="template generation" type="bool">
3009 This only takes effect if &lt;multiply&gt; is enabled. The monster
3010 will create a new monster every once in a while by duplicating it's inventory.
3011 In this case, the &lt;breed monster&gt; value is never used and can be forgotten.
3012 Each time the monster need to generate an object, it will be
3013 a randomly chosen item from the inventory. When generator is destroyed,
3014 inventory is destroyed.
3015 </attribute>
3016 &move_type;
3017 <attribute arch="undead" editor="undead" type="bool">
3018 Several spells only affect undead monsters:
3019 turn undead, banish undead, holy word, etc.
3020 </attribute>
3021 <attribute arch="carrying" editor="carries weight" type="int">
3022 If a monster has something in the inventory, this
3023 value can be set to reflect the slowdown due to
3024 the carried weight.
3025 </attribute>
3026
3027 <section name="melee">
3028 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
3029 This number is a bitmask, specifying the monster's attacktypes
3030 for melee damage. Attacktypes are: physical, magical, fire, cold.. etc.
3031 Strong monsters often have more than just physical attacktype.
3032
3033 When a monster with multiple attacktypes hits aan oponent, it will do
3034 as much damage as the "best" of it's attacktypes does. So, the more
3035 attacktypes, the more dangerous. Attacktypes "magic" and "chaos" are
3036 somehow exceptions.
3037 </attribute>
3038 <attribute arch="dam" editor="damage" type="int">
3039 Among other parameters, &lt;damage&gt; affects how much melee damage
3040 a monster inflicts. &lt;damage&gt; is used as base value for damage per
3041 hit. &lt;level&gt;, &lt;speed&gt;, &lt;weapon class&gt; and resistances also
3042 take effect on the melee damage of a monster.
3043 </attribute>
3044 <attribute arch="wc" editor="weapon class" type="int">
3045 Monsters of high &lt;weapon class&gt; are more likely to really hit
3046 their opponent. &lt;weapon class&gt; can be considered the "counterpiece"
3047 to &lt;armour class&gt;.
3048 </attribute>
3049 <attribute arch="hp" editor="health points" type="int">
3050 The &lt;health points&gt; of a monster define how long it takes to
3051 kill it. With every successful hit from an opponent, &lt;health points&gt;
3052 get drained - The monster dies by zero &lt;health points&gt;.
3053 </attribute>
3054 <attribute arch="maxhp" editor="max health" type="int">
3055 &lt;max health&gt; is the maximum amount of &lt;health points&gt; this
3056 monster can have.
3057 </attribute>
3058 <attribute arch="ac" editor="armour class" type="int">
3059 Monsters of low &lt;armour class&gt; are less likely to get hit from
3060 their opponent. &lt;armour class&gt; can be considered the "counterpiece"
3061 to &lt;weapon class&gt;.
3062 Values typically range between +20 (very bad) to -20 (quite good).
3063 </attribute>
3064 <attribute arch="Con" editor="healing rate" type="int">
3065 Monsters regenerate this many health points each 4 ticks. Hence, the
3066 healing rate is independent of &lt;speed&gt;.
3067 </attribute>
3068 <attribute arch="reflect_missile" editor="reflect missiles" type="bool">
3069 A monster with this flag has the ability to &lt;reflect missiles&gt;,
3070 all kinds of projectiles (e.g. arrows, bolts, boulders) will
3071 bounce off.
3072 </attribute>
3073 <attribute arch="hitback" editor="hitback" type="bool">
3074 Monsters with &lt;hitback&gt; enabled hurt the attacker in proportion
3075 to the amount of damage the *attacker* inflicted. This damage
3076 is additional to the regular melee damage of the monster.
3077 As far as I know, hitback uses acid attacktype, and it only takes
3078 effect if the monster actually has acid attacktype at it's disposal.
3079 Acid spheres for example use this feature.
3080 </attribute>
3081 <attribute arch="one_hit" editor="one hit only" type="bool">
3082 Monsters with &lt;one hit only&gt; dissapear after one successful hit
3083 to a player.
3084 </attribute>
3085 </section>
3086
3087 <section name="spellcraft">
3088 <attribute arch="can_cast_spell" editor="can cast spell" type="bool">
3089 If &lt;can cast spell&gt; is disabled, the monster cannot cast any spell.
3090 Only wands/rods/etc can be used, given the appropriate abilities.
3091 </attribute>
3092 <attribute arch="reflect_spell" editor="reflect spells" type="bool">
3093 A monster with this flag has the ability to &lt;reflect spells&gt;,
3094 all kinds of spell-bullets and -beams will bounce off.
3095
3096 Generally this flag should not be set because it puts
3097 wizard-type players at an unfair disadvantage.
3098 </attribute>
3099 <attribute arch="sp" editor="spellpoints" type="int">
3100 Like players, monsters need &lt;spellpoints&gt; to do magic. Monsters use
3101 them for both wizard- and prayer-spells. However, this value defines
3102 only the amount of *initial* spellpoints the monster starts with.
3103 When creating a spellcasting monster, remember that &lt;max spellpoints&gt;
3104 and &lt;spellpoint regen.&gt; are more important than just initial
3105 &lt;spellpoints&gt;.
3106 </attribute>
3107 <attribute arch="maxsp" editor="max spellpoints" type="int">
3108 &lt;max spellpoints&gt; is the maximum number of spellpoints a monster
3109 can hold. Setting this to high values has little effect unless
3110 the monster has a decent &lt;spellpoint regen.&gt;, or the spell
3111 "regenerate mana" at it's disposal.
3112 </attribute>
3113 <attribute arch="Pow" editor="spellpoint regen." type="int">
3114 Monsters regenerate this many spellpoints each 16 ticks. Hence, the
3115 spellpoint regeneration rate is independent of &lt;speed&gt;.
3116
3117 To make a real tough spellcasting monster, the rate of spellpoint
3118 regeneration is most important. If your monster is still not casting
3119 fast enough, give it the spell-ability of "regenerate mana".
3120 That, paired with high &lt;max spellpoints&gt;, is the ultimate thing.
3121 </attribute>
3122 <attribute arch="path_attuned" editor="attuned paths" type="bitmask_spellpath">
3123 Click on the &lt;attuned paths&gt; button to select spellpaths.
3124 The creature will get attuned to the specified spellpaths.
3125 </attribute>
3126 <attribute arch="path_repelled" editor="repelled paths" type="bitmask_spellpath">
3127 Click on the &lt;repelled paths&gt; button to select spellpaths.
3128 The creature will get repelled to the specified spellpaths.
3129 </attribute>
3130 <attribute arch="path_denied" editor="denied paths" type="bitmask_spellpath">
3131 Click on the &lt;denied paths&gt; button to select spellpaths.
3132 The creature won't be able to cast spells of the specified paths.
3133 </attribute>
3134 </section>
3135
3136 <section name="ability">
3137 <attribute arch="Int" editor="detect hidden" type="int">
3138 The &lt;detect hidden&gt; value gives monsters the ablitity to find
3139 hidden/invisible creatures. Higher values make for better
3140 detection-skills. Enabling &lt;see invisible&gt; makes this value
3141 obsolete.
3142 </attribute>
3143 <attribute arch="see_invisible" editor="see invisible" type="bool">
3144 A monster with the ability to &lt;see invisible&gt; cannot be fooled
3145 with by invisible or hiding players. This flag is a must-have
3146 for high-level monsters. When a monster is unable to detect
3147 invisible players, it can be killed without fighting back.
3148 </attribute>
3149 <attribute arch="can_see_in_dark" editor="see in darkness" type="bool">
3150 A monster with the ability to &lt;see in darkness&gt; cannot be fooled
3151 by spells of darkness or dark maps. This flag is a "should-have"
3152 for high-level monsters. When a monster is unable to see in
3153 darkness, players can cast darkness and sneak around it safely.
3154 </attribute>
3155 <attribute arch="can_use_weapon" editor="can use weapons" type="bool">
3156 Monster is able to wield weapon type objects.
3157 </attribute>
3158 <attribute arch="can_use_bow" editor="can use bows" type="bool">
3159 Monster is able to use missile-weapon type objects.
3160 </attribute>
3161 <attribute arch="can_use_armour" editor="can use armour" type="bool">
3162 Monster is able to wear protective equipment like brestplate
3163 armour, shields, helmets etc.
3164 </attribute>
3165 <attribute arch="can_use_ring" editor="can use rings" type="bool">
3166 Monster is able to wear rings.
3167 </attribute>
3168 <attribute arch="can_use_wand" editor="can use wands" type="bool">
3169 Monster is able to use wands and staves.
3170 </attribute>
3171 <attribute arch="can_use_rod" editor="can use rods" type="bool">
3172 Monster is able to use rods.
3173 </attribute>
3174 <attribute arch="can_use_scroll" editor="can use scrolls" type="bool">
3175 Monster is able to read scrolls.
3176 </attribute>
3177 <attribute arch="can_use_skill" editor="can use skills" type="bool">
3178 Monster is able to use skills from it's inventory.
3179 For example, you can put a throwing skill object and some
3180 boulders into the monster's object and set &lt;can use skills&gt;.
3181 </attribute>
3182 </section>
3183
3184 <section name="behave">
3185 <attribute arch="monster" editor="monster behaviour" type="bool">
3186 When &lt;monster behaviour&gt; is enabled, this object will behave
3187 like a monster: It can move and attack enemies (which are
3188 typically players).
3189 This flag should be set for all monsters as-such.
3190 Monsters which don't move, like guards, should also have
3191 &lt;monster behaviour&gt;, but in combination with &lt;stand still&gt;.
3192 It should *not* be set for things like immobile generators.
3193 </attribute>
3194 <attribute arch="unaggressive" editor="unaggressive" type="bool">
3195 &lt;unaggressive&gt; monsters do not attack players unless attacked first.
3196 </attribute>
3197 <attribute arch="friendly" editor="friendly" type="bool">
3198 &lt;friendly&gt; monsters help the player, attacking any
3199 non-friendly monsters in range.
3200 </attribute>
3201 <attribute arch="stand_still" editor="stand still" type="bool">
3202 Monsters which &lt;stand still&gt; won't move to leave their position.
3203 When agressive, they will attack all enemies who get close to
3204 them. This behaviour is commonly known from castle guards.
3205
3206 In older versions of Crossfire it was possible to eventually
3207 push a &lt;stand still&gt;-monster out of position by force.
3208 I believe this is no longer possible. Neverthless, you should
3209 still be cautious when lining up &lt;stand still&gt;-monster in order
3210 to "defend" something: Such monsters are rather easy to kill.
3211 It's good for low level maps, but not much more.
3212 </attribute>
3213 <attribute arch="sleep" editor="asleep" type="bool">
3214 Being &lt;asleep&gt;, a monster won't move unless a player enters the
3215 &lt;sensing range&gt; of the monster. Usually the sensing range is
3216 larger than the players line of sight. Due to that, in most cases
3217 the player won't ever notice weither a monster was asleep or not.
3218 </attribute>
3219 <attribute arch="will_apply" editor="misc. actions" type="bitmask_will_apply">
3220 This entry defines which kinds of environment actions the
3221 creature is able to perform.
3222 </attribute>
3223 <attribute arch="pick_up" editor="pick up" type="bitmask_pick_up">
3224 Click on the &lt;pick up&gt; button and select which types of objects
3225 the creature should try to pick up.
3226
3227 Note also that if &lt;can use armor&gt;, &lt;can use weapon&gt;, &lt;can use ring&gt;...
3228 etc are set, then the creature will pick up the matching items even
3229 if this is not set here.
3230 </attribute>
3231 <attribute arch="Wis" editor="sensing range" type="int">
3232 &lt;sensing range&gt; determines how close a player needs to be before
3233 the creature wakes up. This is done as a square, for reasons of speed.
3234 Thus, if the &lt;sensing range&gt; is 11, any player that moves within the
3235 11x11 square of the monster will wake the monster up. If the player
3236 has stealth, the size of this square is reduced in half plus 1.
3237 </attribute>
3238 <attribute arch="attack_movement_bits_0_3" editor="attack movement" type="list_attack_movement_bits_0_3">
3239 If this is set to default, the standard mode of movement will be used.
3240 </attribute>
3241 <attribute arch="attack_movement_bits_4_7" editor="normal movement" type="list_attack_movement_bits_4_7">
3242 This movement is not in effect when the monster has an enemy and should
3243 only be used for non agressive monsters.
3244 </attribute>
3245 <attribute arch="run_away" editor="run at % health" type="int">
3246 This is a percentage value in the range 0-100.
3247 When the monster's health points drop below this percentage
3248 (relative to max health), it attempts to run away from the
3249 attacker.
3250 </attribute>
3251 </section>
3252
3253 <section name="resistance">
3254 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
3255 </attribute>
3256 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
3257 </attribute>
3258 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
3259 </attribute>
3260 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
3261 </attribute>
3262 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
3263 </attribute>
3264 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
3265 </attribute>
3266 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
3267 </attribute>
3268 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
3269 </attribute>
3270 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
3271 </attribute>
3272 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
3273 </attribute>
3274 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
3275 </attribute>
3276 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
3277 </attribute>
3278 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
3279 </attribute>
3280 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
3281 </attribute>
3282 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
3283 </attribute>
3284 <attribute arch="resist_turn_undead" editor="resist turn undead %" length="15" type="int">
3285 </attribute>
3286 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
3287 </attribute>
3288 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
3289 </attribute>
3290 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
3291 </attribute>
3292 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
3293 </attribute>
3294 <attribute arch="resist_godpower" editor="resist godpower %" length="15" type="int">
3295 </attribute>
3296 </section>
3297 <attribute arch_begin="msg" arch_end="endmsg" editor="npc message" type="text">
3298 </attribute>
3299 </type>
3300
3301 <!--####################################################################-->
3302 <type number="28" name="Monster (Grimreaper)">
3303 <import_type name="Monster &amp; NPC" />
3304 <ignore>
3305 <attribute arch="material" />
3306 <attribute arch="name_pl" />
3307 <attribute arch="nrof" />
3308 <attribute arch="value" />
3309 <attribute arch="unpaid" />
3310 </ignore>
3311 <description><![CDATA[
3312 A grimreaper is a monster that vanishes after it did some number of
3313 draining attacks. ]]> <!-- XXX: is this ok? -->
3314 </description>
3315 <section name="grimreaper">
3316 <attribute arch="value" editor="attacks" type="int">
3317 The object vanishes after this number of draining attacks.
3318 </attribute>
3319 </section>
3320 </type>
3321
3322 <!--####################################################################-->
3323 <type number="65" name="Mood Floor">
3324 <ignore>
3325 <ignore_list name="system_object" />
3326 </ignore>
3327 <description><![CDATA[
3328 As the name implies, mood floors can change the "mood" of
3329 a monsters/NPC. For example, an unagressive monster could be
3330 turned mad to start attacking. Similar, an agressive monster
3331 could be calmed. ]]>
3332 </description>
3333 <use><![CDATA[
3334 Mood floors are absolutely cool for NPC interaction. To make an
3335 unaggressive monster/NPC attack, put a creator with "other_arch
3336 furious_floor" under it. Connect the creator to a magic_ear, so the
3337 player speaks a keyword like "stupid sucker" - and the monster attacks.
3338 <br><br>
3339 To turn an NPC into a pet, put a charm_floor under it and connect
3340 it directly to a magic_ear. Then the player speaks a keyword like
3341 "help me" - and the NPC joins him as pet.
3342 <br><br>
3343 (Of course you must always give clear hints about keywords!
3344 And there is no reason why you couldn't use a button/lever/pedestal
3345 etc. instead of a magic_ear.) ]]>
3346 </use>
3347 <attribute arch="no_pick" value="1" type="fixed" />
3348 <attribute arch="last_sp" editor="mood" type="list_mood">
3349 &lt;mood&gt; is used to determine what will happen to the
3350 monster when affected by the mood floor:
3351
3352 &lt;mood&gt; 'furious': Makes all monsters aggressive
3353
3354 &lt;mood&gt; 'angry': As above but pets are unaffected
3355
3356 &lt;mood&gt; 'calm': Makes all monsters unaggressive
3357
3358 &lt;mood&gt; 'sleep': Puts all monsters to sleep
3359
3360 &lt;mood&gt; 'charm': Turns monster into a pet of person
3361 who triggers the square. This setting is not
3362 enabled for continous operation, you need to
3363 insert a &lt;connection&gt; value!
3364 </attribute>
3365 <attribute arch="connected" editor="connection" type="int">
3366 This should only be set in combination with &lt;mood number&gt; 4.
3367 Normally, monsters are affected by the mood floor as soon as they
3368 step on it. But charming (monster -&gt; pet) is too powerful,
3369 so it needs to be activated.
3370
3371 Typically it is connected to an altar, for buying a "hireling".
3372 But a powerful pet could as well be the reward for solving a
3373 quest. Or even better: It could be *part* of a quest!
3374 </attribute>
3375 <attribute arch="no_magic" editor="no spells" type="bool">
3376 If enabled, it is impossible for players to use (wizard-)
3377 spells on that spot.
3378 </attribute>
3379 <attribute arch="damned" editor="no prayers" type="bool">
3380 If enabled, it is impossible for players to use prayers
3381 on that spot. It also prevents players from saving.
3382 </attribute>
3383 </type>
3384
3385 <!--####################################################################-->
3386 <type number="40" name="Mover">
3387 <ignore>
3388 <ignore_list name="non_pickable" />
3389 </ignore>
3390 <description><![CDATA[
3391 Movers move the objects above them. However, only living objects
3392 are affected (monsters/NPCs always, players optional). Movers have
3393 a direction, so players can be made to move in a pattern, and so
3394 can monsters. Motion is involuntary. Additionally, players or
3395 monsters can be "frozen" while ontop of movers so that they MUST
3396 move along a chain of them.
3397 <br><br>
3398 Multisquare monsters can be moved as well, given
3399 enough space. Movers are usually invisible. ]]>
3400 </description>
3401 <use><![CDATA[
3402 NEVER EVER consider a mover being unpassable in the backwards
3403 direction. Setting "forced movement" makes it seemingly impossible
3404 but there is still a trick: One player can push a second player
3405 past the mover, in opposite to the mover's direction! The more
3406 movers, the more players needed. Hence, don't make a treasure
3407 room that is surrounded by movers instead of solid walls/gates.
3408 <br><br>
3409 Btw, it does not make a difference putting movers above or
3410 below the floor. Moreover, movers that are set to be invisible
3411 cannot be discovered with the show_invisible spell.
3412 <br><br>
3413 Note that Movers and Directors are seperate objects, even though
3414 they look and act similar. Directors only do spells/missiles,
3415 while movers only do living creatures (depending on how it
3416 is set: monsters and players). ]]>
3417 </use>
3418 <attribute arch="attacktype" editor="forced movement" type="bool">
3419 If forced movement is enabled, the mover "freezes" anyone it
3420 moves (so they are forced to move along a chain).
3421 For players there is no way to escape this forced movement,
3422 except being pushed by a second player.
3423 </attribute>
3424 <attribute arch="maxsp" editor="freeze duration" type="int">
3425 The player will be "frozen" for that many moves.
3426 If &lt;freeze duration&gt; is zero, with &lt;forced movement&gt;
3427 enabled, then &lt;freeze duration&gt; gets assigned the
3428 "default value" 2 automatically.
3429 </attribute>
3430 <attribute arch="speed" editor="movement speed" type="float">
3431 The movement speed value determines how fast a chain of
3432 these movers will push a player along (default is -0.2).
3433 </attribute>
3434 &speed_left;
3435 <attribute arch="sp" editor="direction" type="list_direction">
3436 The mover will push creatures in the specified &lt;direction&gt;.
3437 A mover with direction set to &lt;none&gt; will spin clockwise,
3438 thus pushing creatures in unpredictable directions.
3439 </attribute>
3440 <attribute arch="lifesave" editor="gets used up" type="bool">
3441 If enabled, the mover gets "used up" after a certain number of moves
3442 (specified by &lt;number of uses&gt;). If disabled, the mover works infinitely.
3443 </attribute>
3444 <attribute arch="hp" editor="number of uses" type="int">
3445 This value has only a meaning if &lt;gets used up&gt; is set:
3446 &lt;number of uses&gt; is the number of times minus one, that it
3447 will move a creature before disappearing. (It will move
3448 someone &lt;number of uses&gt;+1 times, then vanish).
3449 </attribute>
3450 <section name="targets">
3451 <attribute arch="level" editor="move players" type="bool">
3452 If &lt;move players&gt; is enabled, both players and monsters will be
3453 moved. In the arches' default it is disabled - thus ONLY monsters
3454 get moved. Remember that "monsters" includes NPCs!
3455
3456 This feature provides you with the possibility to make NPCs
3457 literally "come to life". Example: The player is talking with an
3458 NPC, speaking a certain keyword. This triggers a magic_ear and
3459 activates creators, creating (per default: monster-only) movers
3460 under the NPC's feet. The NPC starts "walking" on a predefined
3461 route! Note that it's useful to set this NPC immune to everything,
3462 preventing the player to push the NPC off his trace.
3463 </attribute>
3464 <attribute arch="move_on" editor="movement type" type="movement_type">
3465 Which movement types activate the mover.
3466 </attribute>
3467 </section>
3468 </type>
3469
3470 <!--####################################################################-->
3471 <type number="17" name="Pedestal">
3472 <ignore>
3473 <ignore_list name="non_pickable" />
3474 </ignore>
3475 <description><![CDATA[
3476 Pedestals are designed to detect certain types of living objects.
3477 When a predefined type of living creature steps on the pedestal, the
3478 connected value is triggered. ]]>
3479 </description>
3480 <use><![CDATA[
3481 If you want to create a place where only players of a certain race
3482 can enter, put a teleporter over your pedestal. So the teleporter is
3483 only activated for players of the matching race. Do not use gates,
3484 because many other players could sneak in. If you put powerful
3485 artifacts into such places, generally set "startequip 1", so that
3486 they are preserved for that one race and can't be traded to others. ]]>
3487 </use>
3488 <attribute arch="no_pick" value="1" type="fixed" />
3489 <attribute arch="slaying" editor="match race" type="string">
3490 the &lt;match race&gt; defines the object we're looking for. If &lt;match race&gt;
3491 matches the monster's or the player's race, we have a match.
3492 Yes, pedestals can detect a player's race! E.g. you could create a
3493 place where only fireborns can enter, by setting "slaying unnatural".
3494
3495 If it is set to "player", any player stepping on the pedestal
3496 is a match. Very useful if you want to open a gate for players
3497 but not for monsters.
3498 </attribute>
3499 <attribute arch="connected" editor="connection" type="int">
3500 When the pedestal is triggered, all objects with the same
3501 connection value get activated.
3502 </attribute>
3503 &move_on;
3504 </type>
3505
3506 <!--####################################################################-->
3507 <type number="94" name="Pit">
3508 <ignore>
3509 <ignore_list name="non_pickable" />
3510 </ignore>
3511 <description><![CDATA[
3512 Pits are holes, transporting the player when he walks (and falls) into them.
3513 A speciality about pits is that they don't transport the player to
3514 the exact destination, but within a two-square radius of the destination
3515 (never on blocked squares).<br>
3516 Optionally, pits can get closed and opened, similar to gates.<br><br>
3517 Monsters and items are affected by pits just as well as players.
3518 Even multipart monsters can fall through them, given enough space. ]]>
3519 </description>
3520 <use><![CDATA[
3521 Pits can add interesting effects to your map. When using them, make
3522 sure to use them in a "logical way": Pits should always drop the
3523 player to some kind of lower level. They should not be used to
3524 randomly interconnect maps like teleporters do. ]]>
3525 </use>
3526 <attribute arch="no_pick" value="1" type="fixed" />
3527 <attribute arch="connected" editor="connection" type="int">
3528 When a &lt;connection&gt; value is set, the pit can be opened/closed
3529 by activating the connection.
3530 </attribute>
3531 &activate_on;
3532 <attribute arch="hp" editor="destination X" type="int">
3533 The pit will transport creatures (and items) randomly into a two-square
3534 radius of the destination coordinates.
3535 If the destination square becomes blocked, the pit will act like
3536 being filled up and not work anymore!
3537 </attribute>
3538 <attribute arch="sp" editor="destination Y" type="int">
3539 The pit will transport creatures (and items) randomly into a two-square
3540 radius of the destination coordinates.
3541 If the destination square becomes blocked, the pit will act like
3542 being filled up and not work anymore!
3543 </attribute>
3544 <attribute arch="wc" editor="position state" type="int">
3545 The &lt;position state&gt; defines the position of the gate:
3546 Zero means completely open/down, the "number of animation-steps" (usually
3547 about 6 or 7) means completely closed/up state. I suggest you don't
3548 mess with this value - Leave the default in place.
3549 </attribute>
3550 &move_on;
3551 </type>
3552
3553 <!--####################################################################-->
3554 <type number="7" name="Poison Food">
3555 <description><![CDATA[
3556 When eating, the player's stomache is drained by 1/4 of food.
3557 If his food drops to zero, the player might even die. ]]>
3558 </description>
3559 </type>
3560
3561 <!--####################################################################-->
3562 <type number="5" name="Potion">
3563 <description><![CDATA[
3564 The player can drink these and gain various kinds of benefits
3565 (/penalties) by doing so. ]]>
3566 </description>
3567 <use><![CDATA[
3568 One potion should never give multiple benefits at once. ]]>
3569 </use>
3570 <attribute arch="level" editor="potion level" type="int">
3571 If the potion contains a spell, the spell is cast at this level.
3572 For other potions it should be set at least to 1.
3573 </attribute>
3574 <attribute arch="sp" editor="spell" type="spell">
3575 When a player drinks this potion, the selected spell
3576 will be casted (once). This should work for any given spell.
3577 E.g. heal is "sp 35", magic power is "sp 67".
3578 </attribute>
3579 <attribute arch="attacktype" editor="special effect" type="list_potion_effect">
3580 There are two types of special effects for potions:
3581 'life restoration' - restore the player's stats lost by death or draining
3582 (this has nothing in common with the restoration spell!)
3583 'improvement' - increase the player's maximum health/mana/grace
3584 by a very small amount.
3585 </attribute>
3586 <attribute arch="cursed" editor="cursed" type="bool">
3587 If a potion is cursed, benefits generally turn into penalties.
3588 Note that potions can be "uncursed" by praying over an altar,
3589 with relative ease. *But* the potion must be identified to notice
3590 that it is cursed &gt;:)
3591 </attribute>
3592 <attribute arch="startequip" editor="godgiven item" type="bool">
3593 A godgiven item vanishes as soon as the player
3594 drops it to the ground.
3595 </attribute>
3596 <section name="stats">
3597 <attribute arch="Str" editor="strength" type="int">
3598 The player's strentgh will rise/fall by the given value for permanent
3599 (of course there is an upper limit). Generally there shouldn't be stat
3600 potions granting more than one stat. Cursed potions will subtract the
3601 stats if positive.
3602 </attribute>
3603 <attribute arch="Dex" editor="dexterity" type="int">
3604 The player's dexterity will rise/fall by the given value for permanent
3605 (of course there is an upper limit). Generally there shouldn't be stat
3606 potions granting more than one stat. Cursed potions will subtract the
3607 stats if positive.
3608 </attribute>
3609 <attribute arch="Con" editor="constitution" type="int">
3610 The player's constitution will rise/fall by the given value for permanent
3611 (of course there is an upper limit). Generally there shouldn't be stat
3612 potions granting more than one stat. Cursed potions will subtract the
3613 stats if positive.
3614 </attribute>
3615 <attribute arch="Int" editor="intelligence" type="int">
3616 The player's intelligence will rise/fall by the given value for permanent
3617 (of course there is an upper limit). Generally there shouldn't be stat
3618 potions granting more than one stat. Cursed potions will subtract the
3619 stats if positive.
3620 </attribute>
3621 <attribute arch="Pow" editor="power" type="int">
3622 The player's power will rise/fall by the given value for permanent
3623 (of course there is an upper limit). Generally there shouldn't be stat
3624 potions granting more than one stat. Cursed potions will subtract the
3625 stats if positive.
3626 </attribute>
3627 <attribute arch="Wis" editor="wisdom" type="int">
3628 The player's wisdom will rise/fall by the given value for permanent
3629 (of course there is an upper limit). Generally there shouldn't be stat
3630 potions granting more than one stat. Cursed potions will subtract the
3631 stats if positive.
3632 </attribute>
3633 <attribute arch="Cha" editor="charisma" type="int">
3634 The player's charisma will rise/fall by the given value for permanent
3635 (of course there is an upper limit). Generally there shouldn't be stat
3636 potions granting more than one stat. Cursed potions will subtract the
3637 stats if positive.
3638 </attribute>
3639 </section>
3640 <section name="resistance">
3641 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
3642 The player's resistance to physical will rise by this value in percent
3643 (range -100 till +100). The effect is only temporare, and it does NOT
3644 add on the values from the player's equipment.
3645 Cursed potions will make negative resistance.. very nasty in combat!
3646 </attribute>
3647 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
3648 The player's resistance to magic will rise by this value in percent
3649 (range -100 till +100). The effect is only temporare, and it does NOT
3650 add on the values from the player's equipment.
3651 Cursed potions will make negative resistance.. very nasty in combat!
3652 </attribute>
3653 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
3654 The player's resistance to fire will rise by this value in percent
3655 (range -100 till +100). The effect is only temporare, and it does NOT
3656 add on the values from the player's equipment.
3657 Cursed potions will make negative resistance.. very nasty in combat!
3658 </attribute>
3659 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
3660 The player's resistance to electricity will rise by this value in percent
3661 (range -100 till +100). The effect is only temporare, and it does NOT
3662 add on the values from the player's equipment.
3663 Cursed potions will make negative resistance.. very nasty in combat!
3664 </attribute>
3665 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
3666 The player's resistance to cold will rise by this value in percent
3667 (range -100 till +100). The effect is only temporare, and it does NOT
3668 add on the values from the player's equipment.
3669 Cursed potions will make negative resistance.. very nasty in combat!
3670 </attribute>
3671 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
3672 The player's resistance to acid will rise by this value in percent
3673 (range -100 till +100). The effect is only temporare, and it does NOT
3674 add on the values from the player's equipment.
3675 Cursed potions will make negative resistance.. very nasty in combat!
3676 </attribute>
3677 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
3678 The player's resistance to confusion will rise by this value in percent
3679 (range -100 till +100). The effect is only temporare, and it does NOT
3680 add on the values from the player's equipment.
3681 Cursed potions will make negative resistance.. very nasty in combat!
3682 </attribute>
3683 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
3684 The player's resistance to weaponmagic will rise by this value in percent
3685 (range -100 till +100). The effect is only temporare, and it does NOT
3686 add on the values from the player's equipment.
3687 Cursed potions will make negative resistance.. very nasty in combat!
3688 </attribute>
3689 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
3690 The player's resistance to paralyze will rise by this value in percent
3691 (range -100 till +100). The effect is only temporare, and it does NOT
3692 add on the values from the player's equipment.
3693 Cursed potions will make negative resistance.. very nasty in combat!
3694 </attribute>
3695 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
3696 The player's resistance to draining will rise by this value in percent
3697 (range -100 till +100). The effect is only temporare, and it does NOT
3698 add on the values from the player's equipment.
3699 Cursed potions will make negative resistance.. very nasty in combat!
3700 </attribute>
3701 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
3702 The player's resistance to depletion will rise by this value in percent
3703 (range -100 till +100). The effect is only temporare, and it does NOT
3704 add on the values from the player's equipment.
3705 Cursed potions will make negative resistance.. very nasty in combat!
3706 </attribute>
3707 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
3708 The player's resistance to poison will rise by this value in percent
3709 (range -100 till +100). The effect is only temporare, and it does NOT
3710 add on the values from the player's equipment.
3711 Cursed potions will make negative resistance.. very nasty in combat!
3712 </attribute>
3713 </section>
3714 </type>
3715
3716 <!--####################################################################-->
3717 <type number="156" name="Power Crystal">
3718 <description><![CDATA[
3719 Power crystals can store a player's mana:
3720 When the player applies the crystal with full mana, half of
3721 it flows into the crystal. When the player applies it with
3722 lacking mana, the crystal replenishes the player's mana. ]]>
3723 </description>
3724 <attribute arch="sp" editor="initial mana" type="int">
3725 &lt;initial mana&gt; is the amount of spellpoints that the
3726 crystal holds when the map is loaded.
3727 </attribute>
3728 <attribute arch="maxsp" editor="mana capacity" type="int">
3729 The &lt;mana capacity&gt; defines how much mana can be stored
3730 in the crystal. This is what makes the crystal interesting.
3731 Wizard-players will always seek for crystals with large
3732 capacities.
3733 </attribute>
3734 </type>
3735
3736 <!--####################################################################-->
3737 <type number="13" name="Projectile">
3738 <description><![CDATA[
3739 Projectiles like arrows/crossbow bolts are used as ammunition
3740 for shooting weapons.
3741 <br><br>
3742 It's very easy to add new pairs of weapons &amp; projectiles.
3743 Just set matching &lt;ammunition class&gt; both for shooting
3744 weapon and projectile. ]]>
3745 </description>
3746 <use><![CDATA[
3747 If you want to create new kinds of projectiles, you could
3748 add an alchemical receipe to create these.
3749
3750 Don't create new pairs of weapons &amp; projectiles unless
3751 they really fullfill a useful purpose. In fact, even bows
3752 and crossbows are rarely ever used. ]]>
3753 </use>
3754 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
3755 This number is a bitmask, specifying the projectile's attacktypes.
3756 Attacktypes are: physical, magical, fire, cold.. etc.
3757 This works identical to melee weapons. Note that shooting
3758 weapons cannot have attacktypes.
3759 </attribute>
3760 <attribute arch="race" editor="ammunition class" type="string">
3761 Only shooting weapons with matching &lt;ammunition class&gt; can fire
3762 these projectiles. For arrows set "arrows", for crossbow bolts
3763 set "crossbow bolts" (big surprise).
3764
3765 In certain cases, the ammunition class is displayed in the game.
3766 Hence, when you create a new ammunition class, choose an
3767 intuitive name like "missiles", "spirit bolts" - whatever.
3768
3769 You can also make special containers holding these projectiles
3770 by setting the &lt;container class&gt; to match your &lt;ammunition class&gt;.
3771 </attribute>
3772 <attribute arch="slaying" editor="slaying race" type="string">
3773 Slaying means the weapon does tripple (3x) damage to monsters
3774 of the specified race. If &lt;slaying race&gt; matches an arch name,
3775 only monsters of that archtype receive tripple damage.
3776 Tripple damage is very effective.
3777 </attribute>
3778 <attribute arch="dam" editor="damage" type="int">
3779 The projectile &lt;damage&gt; significantly affects the damage
3780 done. Damage can be further increased by the shooting
3781 weapon's attributes.
3782 </attribute>
3783 <attribute arch="wc" editor="weaponclass" type="int">
3784 This value is supposed to be the base &lt;weaponclass&gt;,
3785 but it seems to have rather little effect.
3786 High values are good here, low values bad.
3787 </attribute>
3788 <attribute arch="food" editor="chance to break" type="int">
3789 The &lt;chance to break&gt; defines the breaking probability when this
3790 projectile hits an obstacle, e.g. wall or monster.
3791 The value is the %-chance to break, ranging from 0 (never breaking)
3792 to 100 (breaking at first shot).
3793 </attribute>
3794 <attribute arch="magic" editor="magic bonus" type="int">
3795 Magic bonus increases chance to hit and damage a little bit.
3796 </attribute>
3797 <attribute arch="unique" editor="unique item" type="bool">
3798 Unique items exist only one time on a server. If the item
3799 is taken, lost or destroyed - it's gone for good.
3800 </attribute>
3801 <attribute arch="startequip" editor="godgiven item" type="bool">
3802 A godgiven item vanishes as soon as the player
3803 drops it to the ground.
3804 </attribute>
3805 <attribute arch="no_drop" editor="don't drop" type="bool">
3806 When a monster carries a projectile with &lt;don't drop&gt;,
3807 this item will never drop to the ground but
3808 vanish instead. If this object is shot, it can still drop
3809 after hitting an obstacle. You can prevent this by
3810 setting &lt;chance to break&gt; 100.
3811 </attribute>
3812 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
3813 This text may describe the projectile. This
3814 could be nice for very special ones.
3815 </attribute>
3816 </type>
3817
3818 <!--####################################################################-->
3819 <type number="70" name="Ring">
3820 <import_type name="Amulet" />
3821 <description><![CDATA[
3822 Rings are worn on the hands - one ring each.
3823 Wearing rings, the object's stats will directly be inherited to
3824 the player. Usually enhancing his spellcasting potential. ]]>
3825 </description>
3826 <use><![CDATA[
3827 When you create an artifact ring, never forget that players can
3828 wear <B>two</B> rings! Due to that it is extremely important to
3829 keep rings in balance with the game.
3830 <br><br>
3831 Also keep in mind that rings are generally the wizard's tools.
3832 They should primarily grant bonuses to spellcasting abilities
3833 and non-physical resistances. ]]>
3834 </use>
3835 </type>
3836
3837 <!--####################################################################-->
3838 <type number="3" name="Rod">
3839 <ignore>
3840 <attribute arch="title" />
3841 </ignore>
3842 <description><![CDATA[
3843 A rod contains a spell. The player can use this spell by applying and
3844 fireing the rod. Rods need time to regenerate their "internal" spellpoints,
3845 lowering the effectiveness in combat. But unlike wands/scrolls, rods can be
3846 used endlessly. ]]>
3847 </description>
3848 <use><![CDATA[
3849 Rods with healing/curing spells are extremely powerful. Usually, potions have
3850 to be used for that purpose. Though, potions are expensive and only good for
3851 one-time-use.<br> ]]>
3852 </use>
3853 <attribute arch="sp" editor="spell" type="spell">
3854 Sets the &lt;spell&gt; of the rod. Consider twice before handing out special
3855 rods to players, since they can be used endlessly without any mana cost!
3856 Rods with heal/ restoration/ protection spells, IF available, MUST be
3857 very very VERY hard to get!
3858 </attribute>
3859 <attribute arch="level" editor="casting level" type="int">
3860 The casting level of the &lt;spell&gt; determines it's power.
3861 For attack spells, level should be set to something reasonable.
3862 </attribute>
3863 <attribute arch="hp" editor="initial spellpoints" type="int">
3864 This value represents the initial amount of spellpoints in the rod.
3865 Naturally, this is quite unimportant.
3866 </attribute>
3867 <attribute arch="maxhp" editor="max. spellpoints" type="int">
3868 When the rod is fully charged up, it will hold this maximum amount of
3869 spellpoints. Make sure it is enough to cast the contained spell at least
3870 once. But don't set the value too high, as that might make the rod
3871 too effective.
3872 </attribute>
3873 <attribute arch="startequip" editor="godgiven item" type="bool">
3874 A godgiven item vanishes as soon as the player
3875 drops it to the ground.
3876 </attribute>
3877 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
3878 This text may contain a description of the rod.
3879 </attribute>
3880 </type>
3881
3882 <!--####################################################################-->
3883 <type number="154" name="Rune">
3884 <ignore>
3885 <attribute arch="no_pick" />
3886 <attribute arch="title" />
3887 <attribute arch="name_pl" />
3888 <attribute arch="weight" />
3889 <attribute arch="value" />
3890 <attribute arch="material" />
3891 <attribute arch="unpaid" />
3892 </ignore>
3893 <description><![CDATA[
3894 A rune is a magical enscription on the dungeon floor.
3895 <br><br>
3896 Runes hit any monster or person who steps on them for 'dam' damage in
3897 'attacktype' attacktype. Alternatively, the rune could contain any spell,
3898 and will cast this spell when it detonates. Yet another kind is the
3899 "summoning rune", summoning predefined monsters of any kind, at detonation.
3900 <br><br>
3901 Many runes are already defined in the archetypes. ]]>
3902 </description>
3903 <use><![CDATA[
3904 Avoid monsters stepping on your runes. For example, summoning runes
3905 together with spellcasting- and attack-runes is usually a bad idea. ]]>
3906 </use>
3907 <attribute arch="no_pick" value="1" type="fixed" />
3908 &move_on;
3909 <attribute arch="level" editor="rune level" type="int">
3910 This value sets the level the rune will cast the spell it contains at,
3911 if applicable. A level 99 rune casts a very, very mean spell of whatever.
3912 (&lt;rune level&gt; 0 runes won't detonate at all!)
3913
3914 Level Also effects how easily a rune may be found and disarmed, and
3915 how much experience the player gets for doing so. Beware: High level
3916 runes can be quite a cheap source of experience! So either make them
3917 tough, or keep the level low.
3918 </attribute>
3919 <attribute arch="Cha" editor="visibility" type="int">
3920 This value determines what fraction of the time the rune is visible:
3921 It'll be randomly visible 1/&lt;visibility&gt; of the time. Also effects
3922 how easily the rune may be found.
3923 </attribute>
3924 <attribute arch="hp" editor="number of charges" type="int">
3925 The rune will detonate &lt;number of charges&gt; times before disappearing.
3926 </attribute>
3927 <attribute arch="dam" editor="direct damage" type="int">
3928 &lt;direct damage&gt; specifies how much damage is done by the rune,
3929 if it doesn't contain a spell. This should be set in reasonable
3930 relation to the rune's level.
3931 </attribute>
3932 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
3933 If there isn't any spell (and &lt;summon monster&gt; is unset), this
3934 attribute defines what attacktype to use for direct damage when
3935 the rune detonates.
3936 </attribute>
3937 <section name="spellcraft">
3938 <attribute arch="sp" editor="spell" type="spell">
3939 The selected &lt;spell&gt; defines the spell in the rune, if any.
3940 (Many runes do direct damage).
3941 </attribute>
3942 <attribute arch="slaying" editor="spell name" type="string">
3943 Name of the spell in the rune, if any. &lt;spell name&gt; is optional,
3944 but if present, overrides the &lt;spell&gt; setting.
3945 </attribute>
3946 <attribute arch="other_arch" editor="spell arch" type="string">
3947 This string defines the spell in the rune, if any. &lt;spell arch&gt;
3948 is optional, but if present, overrides the &lt;spell&gt; setting.
3949 You can choose any of the existing arches.
3950 </attribute>
3951 <attribute arch="maxsp" editor="direction" type="list_direction">
3952 If set, the rune will cast it's containing spell (if any) in
3953 this &lt;direction&gt;.In most cases this appears useless because
3954 the spell directly hits the player.
3955 </attribute>
3956 <attribute arch="race" editor="summon monster" type="string">
3957 If this is set to the arch name of any monster, together with
3958 &lt;spell name&gt; "summon evil monster", the rune will summon a bunch
3959 of those on detonation. (dam and attacktype will still be ignored
3960 in this case). Runes are even capable of summoning multi-square
3961 monsters, given enough space. You'd better test it though.
3962 </attribute>
3963 <attribute arch="maxhp" editor="summon amount" type="int">
3964 This should only be set to a summoning rune. It will then summon
3965 that many creatures of the kind &lt;summon monster&gt;.
3966 </attribute>
3967 </section>
3968 <attribute arch_begin="msg" arch_end="endmsg" editor="detonation text" type="text">
3969 When the rune detonates, this text is displayed to the
3970 victim. For especially powerful runes, create an appropriate
3971 thrilling description. ;)
3972 </attribute>
3973 </type>
3974
3975 <!--####################################################################-->
3976 <type number="106" name="Savebed">
3977 <ignore>
3978 <ignore_list name="non_pickable" />
3979 </ignore>
3980 <description><![CDATA[
3981 When the player applies a savebed, he is not only saved. Both his
3982 respawn-after-death and his word-of-recall positions are pointing
3983 to the last-applied savebed. ]]>
3984 </description>
3985 <use><![CDATA[
3986 Put savebed locations in towns, do not put them into dungeons.
3987 It is absolutely neccessary that a place with savebeds is 100% secure.
3988 That means:
3989 <UL>
3990 <LI> Monsters must not be able to reach the savebeds under any circumstances!
3991 <LI> If there are NPCs around, make sure they have the friendly-flag set.
3992 <LI> Insert a relyable exit! Make sure there is no possibility that
3993 players get trapped in a savebed location.
3994 <LI> If possible, mark the whole site as no-spell area (Insert this
3995 arch called "dungeon_magic" everywhere). This is not required,
3996 but it makes the place much more safe.
3997 </UL> ]]>
3998 </use>
3999 <attribute arch="no_pick" value="1" type="fixed" />
4000 <attribute arch="no_magic" value="1" type="fixed" />
4001 <attribute arch="damned" value="1" type="fixed" />
4002 </type>
4003
4004 <!--####################################################################-->
4005 <type number="111" name="Scroll">
4006 <ignore>
4007 <attribute arch="title" />
4008 </ignore>
4009 <description><![CDATA[
4010 Scrolls contain spells (similar to spell-potions). Unlike potions,
4011 scrolls require a certain literacy skill to read successfully.
4012 Accordingly, for a successful reading, a small amount of
4013 experience is gained. Scrolls allow only one time usage, but
4014 usually they are sold in bulks. ]]>
4015 </description>
4016 <use><![CDATA[
4017 For low level quests, scrolls of healing/curing-spells
4018 can be a nice reward. At higher levels, scrolls become less
4019 and less useful. ]]>
4020 </use>
4021 <attribute arch="level" editor="casting level" type="int">
4022 The spell of the scroll will be casted at this level.
4023 This value should always be set, at least to 1.
4024 </attribute>
4025 <attribute arch="sp" editor="spell" type="spell">
4026 When a player/monster applies this scroll, the selected &lt;spell&gt;
4027 will be casted (once). This should work for any given spell.
4028 </attribute>
4029 <attribute arch="startequip" editor="godgiven item" type="bool">
4030 A godgiven item vanishes as soon as the player
4031 drops it to the ground.
4032 </attribute>
4033 </type>
4034
4035 <!--####################################################################-->
4036 <type number="33" name="Shield">
4037 <import_type name="Amulet" />
4038 <description><![CDATA[
4039 Wearing a shield, the object's stats will directly be inherited to
4040 the player. Shields usually provide good defense, only surpassed
4041 by brestplate armour. Resistances on shields aren't uncommon either. ]]>
4042 </description>
4043 <use><![CDATA[
4044 Feel free to create your own special artifacts. However, it is very
4045 important that you keep your artifact in balance with existing maps. ]]>
4046 </use>
4047 <attribute arch="magic" editor="magic bonus" type="int">
4048 &lt;magic bonus&gt; works just like ac, except that it can be improved by
4049 "scrolls of Enchant Armour" or reduced by acid. It is less useful
4050 than direct armour-class bonus on the shield.
4051 </attribute>
4052 </type>
4053
4054 <!--####################################################################-->
4055 <type number="14" name="Shooting Weapon">
4056 <description><![CDATA[
4057 Shooting weapons like bows/crossbows are used to shoot projectiles
4058 (arrows/bolts). Shooting weapons and normal (melee) weapons can be
4059 wielded both at the same time. Like with any other equipment,
4060 stats/bonuses from shooting weapons are directly inherited to the player.
4061 <br><br>
4062 It's very easy to add new pairs of weapons &amp; projectiles.
4063 Just set matching &lt;ammunition class&gt; both for shooting
4064 weapon and projectile. ]]>
4065 </description>
4066 <use><![CDATA[
4067 Shooting weapons should not add bonuses in general. There's already
4068 enough "equipment-slots" doing that: swords, rings, amulets, girdles etc.
4069 Shooting weapons should especially not add bonuses to the player
4070 that have nothing to do with schooting. A Wisdom bonus on a bow
4071 is crap for example! A name like "Longbow of great Wisdom" doesn't help
4072 - still crap. ]]>
4073 </use>
4074 <attribute arch="race" editor="ammunition class" type="string">
4075 Only projectiles with matching &lt;ammunition class&gt; can be fired
4076 with this weapon. For normal bows set "arrows", for normal
4077 crossbows set "crossbow bolts".
4078
4079 In certain cases, the ammunition class is displayed in the game.
4080 Hence, when you create a new ammunition class, choose an
4081 intuitive name like "missiles", "spirit bolts" - whatever.
4082 </attribute>
4083 <attribute arch="sp" editor="shooting speed" type="int">
4084 After shooting a projectile, the player is frozen for a short
4085 period of time (to prevent shooting arrows machine-gun-like).
4086 The greater &lt;shooting speed&gt;, the shorter this period of time.
4087 1 is minimum (=worst) and 100 is maximum (=best) value.
4088
4089 You shouldn't set &lt;shooting speed&gt; lower than 10. YOU MUST NOT
4090 SET IT TO ZERO! (That would freeze the player for eternety).
4091 </attribute>
4092 <attribute arch="dam" editor="base damage" type="int">
4093 The &lt;base damage&gt; significantly affects the damage done
4094 by using this weapon. This damage is added to the projectile
4095 damage and then (if &lt;ignore strength&gt; disabled) a bonus
4096 according to the player's strength is added.
4097 </attribute>
4098 <attribute arch="wc" editor="weaponclass" type="int">
4099 This value is supposed to be the base &lt;weaponclass&gt;,
4100 but it seems to have rather little effect.
4101 High values are good here, low values bad.
4102 </attribute>
4103 <attribute arch="item_power" editor="item power" type="int">
4104 The &lt;item power&gt; value measures how "powerful" an artifact is.
4105 Players will only be able to wear equipment with a certain total
4106 amount of &lt;item power&gt;, depending on their own level. This is the
4107 only way to prevent low level players to wear "undeserved" equipment
4108 (like gifts from other players or cheated items).
4109
4110 It is very important to adjust the &lt;item power&gt; value carefully
4111 for every artifact you create! If zero/unset, the CF server will
4112 calculate a provisional value at runtime, but this is never
4113 going to be an accurate measurement of &lt;item power&gt;.
4114 </attribute>
4115 <attribute arch="no_strength" editor="ignore strength" type="bool">
4116 Usually the player's strentgh takes effect on the damage
4117 done by the shooting weapon. If &lt;ignore strength&gt; is set,
4118 the player's strength is ignored.
4119 </attribute>
4120 <attribute arch="damned" editor="damnation" type="bool">
4121 A damned shooting weapon cannot be unwielded unless
4122 the curse is removed. Removing damnations is
4123 a tick harder than removing curses.
4124 </attribute>
4125 <attribute arch="cursed" editor="curse" type="bool">
4126 A cursed shooting weapon cannot be unwielded unless
4127 the curse is removed.
4128 </attribute>
4129 <attribute arch="unique" editor="unique item" type="bool">
4130 Unique items exist only one time on a server. If the item
4131 is taken, lost or destroyed - it's gone for good.
4132 </attribute>
4133 <attribute arch="startequip" editor="godgiven item" type="bool">
4134 A godgiven item vanishes as soon as the player
4135 drops it to the ground.
4136 </attribute>
4137 <section name="stats">
4138 <attribute arch="Str" editor="strength" type="int">
4139 The player's strentgh will rise/fall by the given value
4140 while wearing this shooting weapon.
4141 </attribute>
4142 <attribute arch="Dex" editor="dexterity" type="int">
4143 The player's dexterity will rise/fall by the given value
4144 while wearing this shooting weapon.
4145 </attribute>
4146 <attribute arch="Con" editor="constitution" type="int">
4147 The player's constitution will rise/fall by the given value
4148 while wearing this shooting weapon.
4149 </attribute>
4150 <attribute arch="Int" editor="intelligence" type="int">
4151 The player's intelligence will rise/fall by the given value
4152 while wearing this shooting weapon.
4153 </attribute>
4154 <attribute arch="Pow" editor="power" type="int">
4155 The player's power will rise/fall by the given value
4156 while wearing this shooting weapon.
4157 </attribute>
4158 <attribute arch="Wis" editor="wisdom" type="int">
4159 The player's wisdom will rise/fall by the given value while
4160 wearing this shooting weapon.
4161 </attribute>
4162 <attribute arch="Cha" editor="charisma" type="int">
4163 The player's charisma will rise/fall by the given value
4164 while wearing this shooting weapon.
4165 </attribute>
4166 </section>
4167 <section name="bonus">
4168 <attribute arch="luck" editor="luck bonus" type="int">
4169 With positive luck bonus, the player is more likely to
4170 succeed in all sorts of things (spellcasting, praying,...).
4171 Unless the &lt;luck bonus&gt; is very high, the effect will be
4172 barely visible in-game. Luck bonus on one piece of equipment
4173 should never exceed 3, and such bonus should not be too
4174 frequently available.
4175 </attribute>
4176 <attribute arch="magic" editor="magic bonus" type="int">
4177 &lt;Magic bonus&gt; improves the quality of the shooting weapon.
4178 I'm not sure what exactly is increased - maybe weaponclass?
4179 However, &lt;magic bonus&gt; seems to have a little bit of positive
4180 influence on your chance to hit.
4181 </attribute>
4182 </section>
4183 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
4184 This text describes the weapons's "story". Every decent artifact weapon
4185 should have such a description.
4186 </attribute>
4187 </type>
4188
4189 <!--####################################################################-->
4190 <type number="68" name="Shop Floor">
4191 <ignore>
4192 <ignore_list name="non_pickable" />
4193 </ignore>
4194 <description><![CDATA[
4195 Shop floor is used for shops. It acts like a combination of the
4196 common floor- and the treasure type: When the map is loaded,
4197 randomitems (depending on the setings) are generated on it.
4198 These items are all flagged as unpaid.
4199 When a player drops an item onto shop floor, the item becomes
4200 unpaid and the player receives payment according to the item's
4201 selling-value.
4202 Shopfloor always prevents magic (To hinder players from burning
4203 or freezing the goods). ]]>
4204 </description>
4205 <use><![CDATA[
4206 Tile your whole shop-interior space which shop floor.
4207 (That assures players receive payment for dropping items).
4208 Place shop mats to enter/leave the shop, and make sure
4209 there is no other exit than the shop mat. ]]>
4210 </use>
4211 <attribute arch="is_floor" value="1" type="fixed" />
4212 <attribute arch="no_pick" value="1" type="fixed" />
4213 <attribute arch="no_magic" value="1" type="fixed" />
4214 <attribute arch="auto_apply" editor="generate goods" type="bool">
4215 If enabled, items will appear on this square when the map is loaded.
4216 You need to specify a &lt;treasurelist&gt; to define what kinds of items
4217 are generated. The items will be unpaid.
4218 </attribute>
4219 <attribute arch="randomitems" editor="treasurelist" type="treasurelist">
4220 This entry determines what kind of treasure will appear, when
4221 &lt;generate goods&gt; is enabled. Look into /crossfire/share/crossfire/treasures
4222 for details about existing treasurelists.
4223 </attribute>
4224 <attribute arch="exp" editor="quality level" type="int">
4225 The &lt;quality level&gt; will be used for the quality of the generated
4226 goods. If zero/unset, &lt;quality level&gt; 5 is used. Usually this value
4227 doesn't need to be set, unless you want extraordinarily good/bad
4228 quality. If you want to make a shop with very high quality, meaybe
4229 charge an entrance fee, or make the shop hard-to-come-by.
4230 Note that &lt;quality level&gt; mainly affects chance of magic bonus
4231 and appearance of artifact-items.
4232 </attribute>
4233 <attribute arch="damned" editor="no prayers" type="bool">
4234 If enabled, it is impossible for players to use prayers
4235 on that spot. It also prevents players from saving.
4236 (Remember that &lt;no magic&gt; is always set for shop floors.)
4237 </attribute>
4238 </type>
4239
4240 <!--####################################################################-->
4241 <type number="69" name="Shop Mat">
4242 <ignore>
4243 <ignore_list name="non_pickable" />
4244 </ignore>
4245 <description><![CDATA[
4246 Shop mats are used for entering/leaving shops. You should always
4247 have exactly TWO shop mats on your shop-map: One inside the
4248 "shopping-area" and one outside. Shop mats don't use exit paths/
4249 or -destinations. When stepping onto a shopmat the player gets beamed
4250 to the nearest other mat. If the player has unpaid items in his
4251 inventory, the price gets charged from his coins automatically.
4252 If the player has insufficient coins to buy his unpaid items, he
4253 is unable to pass any shopmat (So he has to drop unpaid items). ]]>
4254 </description>
4255 <use><![CDATA[
4256 As stated above, always place TWO shop mats into your shop.
4257 Not more and not less than that. ]]>
4258 </use>
4259 <attribute arch="no_pick" value="1" type="fixed" />
4260 &move_on;
4261 </type>
4262
4263 <!--####################################################################-->
4264 <type number="98" name="Sign &amp; MagicMouth">
4265 <ignore>
4266 <ignore_list name="non_pickable" />
4267 </ignore>
4268 <description><![CDATA[
4269 The purpose of a sign or magic_mouth is to display a certain message to
4270 the player. There are three ways to have the player get this message:
4271 The player walking onto it (-&gt; magic_mouth), the player pressing &lt;a&gt;pply
4272 (-&gt; sign) or the player triggering a button/handle/etc (-&gt; magic_mouth). ]]>
4273 </description>
4274 <use><![CDATA[
4275 Use signs and magic_mouths, plenty of them! Place magic_mouths to add
4276 some true roleplay feeling to your maps, support your storyline or give
4277 hints about hidden secrets/dangers. Place signs to provide the player
4278 with all kinds of useful information for getting along in your maps. ]]>
4279 </use>
4280 <attribute arch="connected" editor="connection" type="int">
4281 When a connection value is set, the message will be printed whenever
4282 the connection is triggered. This should be used in combination with
4283 &lt;invisible&gt; enabled and &lt;activate by walking/flying&gt; disabled.
4284 If activating your magic_mouth this way, the message will not only be
4285 printed to one player, but all players on the current map.
4286 </attribute>
4287 &activate_on;
4288 &move_on;
4289 <attribute arch="food" editor="counter" type="int">
4290 If a counter-value is set (greater zero), the sign/magic_mouth can be applied
4291 (printing the message) only that many times. For signs this really shouldn't
4292 be used, while for magic_mouths it is extremely helpful.
4293 Monsters walking over the magic_mouth do not decrease the counter.
4294
4295 Often, you might want to have a message displayed only one time. For example:
4296 The player enters your map and you put a magic_mouth to tell him about the
4297 monsters and how dangerous they look and all. Later, when all the monsters
4298 are killed and the player leaves the map, displaying the same message a
4299 second time would be silly. &lt;counter&gt; 1 does a perfect job in such cases.
4300 Otherwise set &lt;counter&gt; zero/unset for infinite use (that is the default).
4301 </attribute>
4302 <attribute arch_begin="msg" arch_end="endmsg" editor="message" type="text">
4303 This text will be displayed to the player.
4304 </attribute>
4305 </type>
4306
4307 <!--####################################################################-->
4308 <type number="43" name="Skill">
4309 <ignore>
4310 <ignore_list name="system_object" />
4311 </ignore>
4312 <description><![CDATA[
4313 Skills are objects which exist in the player/monster inventory.
4314 Both NPC/monsters and players use the same skill archetypes. Not all skills
4315 are enabled for monster use however. ]]>
4316 </description>
4317 <use><![CDATA[
4318 For mapmaking, Skill objects serve two purposes:
4319 <p>First, the predefined skill archtypes (in the 'skills' directory)
4320 can be seen as the global skill definitions. A skill which doesn't
4321 exists as an archtype cannot be learned or used by players. When you
4322 want to use skills in your maps, you may need to look up the &lt;skill name&gt;s
4323 of defined skill archtypes, because those strings are used as a reference in
4324 many skill-related objects.
4325 </p><p>
4326 Secondly, in order to enable monsters to use skills, you will need to
4327 copy default skill archtypes into the monsters' inventories.
4328 You can even customize the skills by changing stats. It is not
4329 recommended however, to use skills in your maps which are totally
4330 unrelated to any predefined skill archtype.</p> ]]>
4331 </use>
4332 <attribute arch="invisible" value="1" type="fixed" />
4333 <attribute arch="no_drop" value="1" type="fixed" />
4334 <attribute arch="skill" editor="skill name" type="string">
4335 The &lt;skill name&gt; is used for matchings. When a usable
4336 object has an identical &lt;skill name&gt;, players
4337 (or monsters) will need this skill to apply/use the object.
4338 </attribute>
4339 <attribute arch="expmul" editor="exp multiplier" type="float">
4340 This is the ratio of experience the players total should increase by
4341 when this skill is used. If this is zero, then experience only goes to
4342 to the skill. Values higher than 1 are allowed. Note that experience
4343 rewarded to the players total is in addition to that given to the
4344 skill. Eg, if player should get 500 exp for using a skill, and
4345 expmul is 1, the player will get 500 added to that skill as well as
4346 500 to their total.
4347 </attribute>
4348 <attribute arch="subtype" editor="skill type" type="list_skill_type">
4349 The &lt;skill type&gt; defines the base functionality of the skill.
4350 Skill types are hardcoded in the Crossfire server. It isn't hard to
4351 create new skill types, but it requires a bit of server-coding.
4352 </attribute>
4353 <attribute arch="level" editor="level" type="int">
4354 </attribute>
4355 <attribute arch="exp" editor="experience" type="int">
4356 </attribute>
4357 <attribute arch="can_use_skill" editor="is native skill" type="bool">
4358 The &lt;is native skill&gt; flag has an effect only when this
4359 skill object is placed in the inventory of a monster (or player).
4360 If it is set, the monster or player knows the skill natively, which
4361 means he does not need a skill tool to use it.
4362 </attribute>
4363 </type>
4364
4365 <!--####################################################################-->
4366 <type number="130" name="Skill Scroll">
4367 <description><![CDATA[
4368 By reading a skill scroll, a player has a chance to learn the
4369 contained skill. ]]>
4370 </description>
4371 <use><![CDATA[
4372 Skill scrolls are very much sought for by players. Currently,
4373 all skill scrolls are sold in shops randomly, which is in fact not
4374 a good system. It would be nice to have some cool quests with
4375 skill scrolls rewarded at the end. ]]>
4376 </use>
4377 <attribute arch="race" value="scrolls" type="fixed" />
4378 <attribute arch="skill" editor="skill name" type="string">
4379 The &lt;skill name&gt; matches the skill object that can
4380 be learned from this scroll.
4381 </attribute>
4382 </type>
4383
4384 <!--####################################################################-->
4385 <type number="21" name="Special Key">
4386 <ignore>
4387 <attribute arch="material" />
4388 </ignore>
4389 <description><![CDATA[
4390 When carrying the appropriate special key, a locked door can
4391 be opened. The key will dissapear.
4392 <br><br>
4393 This object-type can also be used for "passport"-like items:
4394 When walking onto an invetory checker, a gate for example might
4395 get opened. The "passport" will stay in the player's inventory. ]]>
4396 </description>
4397 <use><![CDATA[
4398 How to make a "passport": You take the special key arch
4399 (archetype name is "key2"), set the face to something like
4400 card.111 and the name to "passport" - that's all. The &lt;key string&gt;
4401 certainly must match with the appropiate inventory checker.
4402 <br><br>
4403 Of course you can be creative with names and faces of
4404 key-objects. A "mysterious crystal" or a "big dragon claw"
4405 (with appropriate faces) appear more interesting than just
4406 a "strange key", or "passport". ]]>
4407 </use>
4408 <attribute arch="slaying" editor="key string" type="string">
4409 This string must be identical with the &lt;key string&gt; in the
4410 locked door, then it can be unlocked. It can also be used
4411 to trigger inventory checkers.
4412 </attribute>
4413 <attribute arch="material" editor="material" type="bitmask_material">
4414 For Special Keys, material should always be unset or set
4415 to Adamantite. This prevents the key from getting
4416 burned or otherwise destroyed.
4417 </attribute>
4418 <attribute arch="unique" editor="unique item" type="bool">
4419 Unique items exist only one time on a server. If the item
4420 is taken, lost or destroyed - it's gone for good.
4421
4422 This can be used if you want to sell apartments on your
4423 map: Simply sell a unique passport/key, and place
4424 an inventory checker at the entrance of your apartment.
4425 </attribute>
4426 <attribute arch="startequip" editor="godgiven item" type="bool">
4427 A godgiven item vanishes as soon as the player
4428 drops it to the ground.
4429 </attribute>
4430 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
4431 This will add a description to the object. The player can read
4432 this text by clicking on the item in his inventory. Use this
4433 message to describe what the key/passport is good for. A player
4434 might have 50 different keys on his key-ring. Don't expect
4435 players to recall their purpose just by their names.
4436 </attribute>
4437 </type>
4438
4439 <!--####################################################################-->
4440 <type number="101" name="Spell">
4441 <ignore>
4442 <ignore_list name="system_object" />
4443 </ignore>
4444 <description><![CDATA[
4445 Spell objects define a spell. When a spell is put in a spellbook,
4446 players can learn it by reading the book. Once learned, players
4447 can use the spell as often as they like. With increasing skill level
4448 of the player, spells may gain power but also increase cost.<br>
4449 Monsters can use spells which are put in their inventory (provided
4450 that certain "enabling" settings are correct). The monster's
4451 &lt;treasurelist&gt; can also be used to provide it with spells. ]]>
4452 </description>
4453 <use><![CDATA[
4454 A lot of the spells' settings can be tuned and customized.
4455 When creating new spells which are accessible to players, it is
4456 important to think about balance. A single spell which is too
4457 powerful and/or too easy to use can eventually toss the whole skill
4458 and magic school system out of whack. Testing new spells is
4459 quite important therefore. ]]>
4460 </use>
4461 <attribute arch="no_drop" value="1" type="fixed" />
4462 <attribute arch="invisible" value="1" type="fixed" />
4463 <attribute arch="skill" editor="skill name" type="string">
4464 The &lt;skill name&gt; matches the skill which is needed
4465 to cast this spell. This should be one out of "sorcery",
4466 "pyromancy", "evocation", "summoning" or "praying".
4467 If you want to fiddle with these, please take care not
4468 to upset the concept and balance of the various skills.
4469 </attribute>
4470 <attribute arch="subtype" editor="spell type" type="list_spell_type">
4471 The &lt;spell type&gt; defines the basic type of spell.
4472 Some of these types are of a more generic nature than others.
4473 </attribute>
4474 <attribute arch="level" editor="spell level" type="int">
4475 </attribute>
4476 <attribute arch="casting_time" editor="casting time" type="int">
4477 </attribute>
4478 <attribute arch="duration" editor="duration" type="int">
4479 </attribute>
4480 <attribute arch="other_arch" editor="create object" type="string">
4481 </attribute>
4482 <attribute arch="sp" editor="cost spellpoints" type="int">
4483 </attribute>
4484 <attribute arch="grace" editor="cost grace" type="int">
4485 </attribute>
4486 <attribute arch="maxsp" editor="double cost per level" type="int">
4487 </attribute>
4488 </type>
4489
4490 <!--####################################################################-->
4491 <type number="85" name="Spellbook">
4492 <description><![CDATA[
4493 By reading a spellbook, the player has a chance of learning the
4494 contained spell. Once learned from a book, the spell is available
4495 forever. Spellbooks with high level spells require some skill-level
4496 to read.<br><br>
4497 You can create widely customized spells only by adjusting the
4498 spell object in the spellbooks inventory. Refer to the description
4499 of spell objects for detailed information how to customize spells.<br>
4500 If you want to have a random spellbook instead, choose a &lt;treasurelist&gt;
4501 with a compilation of spells that the book may contain. ]]>
4502 </description>
4503 <use><![CDATA[
4504 Don't put any of the godgiven spells into a spellbook! These are
4505 reserved for the followers of the appropriate cults. Handing them
4506 out in a spellbook would violate the balance between different religions.
4507 <br><br>
4508 Note that there is no fundamental difference between the spellbooks
4509 of varying schools (pyromancy, sorcery, evocation, summoning, and
4510 even praying). The difference lies only in the spells they contain.
4511 It is up to you, the mapmaker, to pick the right type of book
4512 for your spells. ]]>
4513 </use>
4514 <attribute arch="skill" value="literacy" type="fixed" />
4515 <attribute arch="randomitems" editor="treasurelist" type="treasurelist">
4516 There are two ways to put spells into a spellbook:
4517 1. Put a spell object in the books inventory. In this case,
4518 treasurelist must be set to &lt;none&gt;.
4519 2. Choose a treasurelist which contains spells.
4520 In that way, a spell will be chosen randomly from the list.
4521 </attribute>
4522 <attribute arch="startequip" editor="godgiven item" type="bool">
4523 A godgiven item vanishes as soon as the player
4524 drops it to the ground.
4525 </attribute>
4526 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
4527 This text may contain a nice description
4528 of the spellbook's cover or something.
4529 </attribute>
4530 </type>
4531
4532 <!--####################################################################-->
4533 <type number="90" name="Spinner">
4534 <ignore>
4535 <ignore_list name="non_pickable" />
4536 </ignore>
4537 <description><![CDATA[
4538 Spinners change the direction of spell objects and other projectiles
4539 that fly past. Unlike directors, it does make a difference from what
4540 angle you shoot into the spinner. The direction of objects flying past
4541 is always changed by a certain degree. ]]>
4542 </description>
4543 <use><![CDATA[
4544 Spinners are very rarely used. I believe they are quite
4545 confusing and pointless. The only use I can think of is building
4546 some puzzle about where to shoot into spinners to shoot somewhere you
4547 otherwise couldn't.
4548
4549 When placing spinners on a map with magic walls, make sure the spell-
4550 projectiles from magic walls don't get to fly in loops. ]]>
4551 </use>
4552 <attribute arch="sp" editor="direction number" type="int">
4553 The spinner will change the direction of flying objects by
4554 45 degrees per &lt;direction number&gt;. Negative values spin clockwise,
4555 positive values counter clockwise.
4556
4557 Example: &lt;direction number&gt; -2 means spin 90 degrees clockwise.
4558 </attribute>
4559 &move_on;
4560 </type>
4561
4562 <!--####################################################################-->
4563 <type number="138" name="Swamp">
4564 <ignore>
4565 <ignore_list name="non_pickable" />
4566 </ignore>
4567 <description><![CDATA[
4568 Swamp areas show a special behaviour:
4569 When a player stands still on a swamp-square for too long,
4570 he will start to sink in and eventually drown and die.
4571 Items dropped on the swamp sink in and dissapear.
4572 Players with knowledge of the woodsman skill are a lot less likely
4573 to die in the swamp. ]]>
4574 </description>
4575 <attribute arch="is_floor" value="1" type="fixed" />
4576 <attribute arch="is_wooded" value="1" type="fixed" />
4577 <attribute arch="speed" editor="drowning speed" type="float">
4578 The higher the &lt;drowning speed&gt;, the faster will players and items
4579 sink into the swamp. Swamp with very high &lt;drowning speed&gt; can be a nasty
4580 and unexpected death-trap. Players should get a warning before such areas.
4581 </attribute>
4582 &speed_left;
4583 &move_on;
4584 &movement_types_terrain;
4585 <attribute arch="no_magic" editor="no spells" type="bool">
4586 If enabled, it is impossible for players to use (wizard-)
4587 spells on that spot.
4588 </attribute>
4589 <attribute arch="damned" editor="no prayers" type="bool">
4590 If enabled, it is impossible for players to use prayers
4591 on that spot. It also prevents players from saving.
4592 </attribute>
4593 </type>
4594
4595 <!--####################################################################-->
4596 <type number="41" name="Teleporter">
4597 <ignore>
4598 <ignore_list name="non_pickable" />
4599 </ignore>
4600 <description><![CDATA[
4601 When the player walks into a teleporter, he is transferred to a
4602 different location. The main difference to the object-type exit
4603 is the possibility to have teleporters connected to levers/buttons/etc.
4604 Sometimes teleporters are activated even against the players will.
4605 <br><br>
4606 Unlike exits, teleporters can also transfer items and
4607 monsters to different locations on the same map. ]]>
4608 </description>
4609 <use><![CDATA[
4610 When creating maps, I guess sooner or later you'll want to have
4611 an invisible teleporter. If using "invisible 1", the teleporter
4612 can still be discovered with the show_invisible spell. And in
4613 some cases you can't place it under the floor to prevent this.
4614 <br><br>
4615 Fortunately, there is a cool trick to make a perfectly invisible
4616 teleporter: You simply add teleporter functionality to the floor
4617 itself. That means: You take the floor arch (e.g. "flagstone"),
4618 set "type 41", and add slaying/hp/sp/connected... everything you need. ]]>
4619 </use>
4620 <attribute arch="slaying" editor="exit path" type="string">
4621 The exit path specifies the map that the player is transferred to.
4622 &lt;exit path&gt; can be an absolute path, beginning with '/'
4623 (for example "/peterm/FireTemple/fire1"). It can also be a relative
4624 path, not beginning with '/' (On the map "/peterm/FireTemple/Fire2"
4625 for example I could use the relative path "Fire1"). Use relative
4626 paths whenever possible! Note that upper/lower case must always be
4627 set correctly. However, please use lower case only.
4628
4629 If the &lt;exit path&gt; is set, ONLY players can get teleported. If the
4630 &lt;exit path&gt; is unset (empty), anything can get teleported: Players,
4631 monsters and items. In this case, the destined map is automatically
4632 the same map the teleporter is on.
4633 </attribute>
4634 <attribute arch="hp" editor="destination X" type="int">
4635 The exit destinations define the (x, y)-coordinates where the exit
4636 leads to.
4637
4638 If both are set to zero and &lt;exit path&gt; is empty, the player will
4639 get teleported to another, randomly chosen teleporter on the same
4640 map (Slightly confusing for the player though). Make sure there
4641 actually *is* a second one in that case.
4642
4643 If both are set to zero and &lt;exit path&gt; is set, the player will
4644 be transferred to the "default enter location" of the destined map.
4645 The latter can be set in the map-properties as "Enter X/Y". Though,
4646 please DO NOT use that. It turned out to be a source for numerous
4647 map-bugs.
4648 </attribute>
4649 <attribute arch="sp" editor="destination Y" type="int">
4650 The exit destinations define the (x, y)-coordinates where the exit
4651 leads to.
4652
4653 If both are set to zero and &lt;exit path&gt; is empty, the player will
4654 get teleported to another, randomly chosen teleporter on the same
4655 map (Slightly confusing for the player though). Make sure there
4656 actually *is* a second one in that case.
4657
4658 If both are set to zero and &lt;exit path&gt; is set, the player will
4659 be transferred to the "default enter location" of the destined map.
4660 The latter can be set in the map-properties as "Enter X/Y". Though,
4661 please DO NOT use that. It turned out to be a source for numerous
4662 map-bugs.
4663 </attribute>
4664 <attribute arch="connected" editor="connection" type="int">
4665 If a connection value is set, the teleporter will be activated
4666 whenever the connection is triggered. To use this properly,
4667 &lt;activation speed&gt; must be zero.
4668 </attribute>
4669 &activate_on;
4670 <attribute arch="speed" editor="activation speed" type="float">
4671 If the &lt;activation speed&gt; is nonzero, the teleporter will
4672 automatically be activated in regular time-intervals. Hence, the
4673 player can just step on it and gets teleported sooner or later.
4674 The duration between two activates depends on the given value.
4675 Default in the teleporter arch is &lt;activation speed&gt; 0.1.
4676
4677 VERY IMPORTANT: If you want to have your teleporter activated via
4678 button/handle/magic_ear/etc, you must set &lt;activation speed&gt; to zero!
4679 </attribute>
4680 &speed_left;
4681 </type>
4682
4683 <!--####################################################################-->
4684 <type number="26" name="Timed Gate">
4685 <ignore>
4686 <ignore_list name="non_pickable" />
4687 </ignore>
4688 <description><![CDATA[
4689 Gates play an important role in Crossfire. Gates can be opened
4690 by activating a button/trigger, by speaking passwords (-> magic_ear)
4691 or carrying special key-objects (-> inventory checker).
4692 Unlike locked doors, gates can get shut again after a player has
4693 passed, which makes them more practical in many cases. Unlike normal
4694 gates, timed gates open when triggered but automatically close again
4695 after some time.]]>
4696 </description>
4697 <use><![CDATA[
4698 Use gates to divide your maps into separated areas. After solving
4699 area A, the player gains access to area B, and so on. Make your
4700 maps more complex than "one-way". ]]>
4701 </use>
4702 <attribute arch="no_pick" value="1" type="fixed" />
4703 <attribute arch="connected" editor="connection" type="int">
4704 Whenever the inventory checker is triggered, all objects with identical
4705 &lt;connection&gt; value get activated. This only makes sense together with
4706 &lt;blocking passage&gt; disabled. If unset, the gate opens automatically
4707 after some time.
4708 </attribute>
4709 &activate_on;
4710 <attribute arch="wc" editor="position state" type="int">
4711 The &lt;position state&gt; defines the position of the gate:
4712 Zero means completely open/down, the "number of animation-steps" (usually
4713 about 6 or 7) means completely closed/up state. I suggest you don't
4714 mess with this value - Leave the default in place.
4715 </attribute>
4716 &movement_types_terrain;
4717 <attribute arch="no_magic" editor="restrict spells" type="bool">
4718 Restricting the use of spells to pass this gate. This has
4719 an effect only if &lt;block view&gt; is disabled.
4720 </attribute>
4721 <attribute arch="damned" editor="restrict prayers" type="bool">
4722 Restricting the use of prayers to pass this door. This has
4723 an effect only if &lt;block view&gt; is disabled.
4724 </attribute>
4725 <attribute arch="hp" editor="open duration" type="int">
4726 Defines the duration the gate remains closed. This only takes effect
4727 if the gate is not connected.
4728 </attribute>
4729 </type>
4730
4731 <!--####################################################################-->
4732 <type number="155" name="Trap">
4733 <ignore>
4734 <attribute arch="no_pick" />
4735 <attribute arch="title" />
4736 <attribute arch="name_pl" />
4737 <attribute arch="weight" />
4738 <attribute arch="value" />
4739 <attribute arch="material" />
4740 <attribute arch="unpaid" />
4741 </ignore>
4742 <description><![CDATA[
4743 A trap is a object that can either do damage or trigger another connected object
4744 when detonated. Traps are like runes except they are not magical in nature,
4745 and generally have either a physical attack or trigger a reaction.
4746 <br><br>
4747 Traps hit any monster or person who steps on them for 'dam' damage in
4748 'attacktype' attacktype and/or trigger a reaction.
4749 <br><br>
4750 Many traps are already defined in the archetypes. ]]>
4751 </description>
4752 <use><![CDATA[
4753 Avoid monsters stepping on your traps. For example, a party of orcs setting
4754 off your lightning wall and pit trap is usually a bad idea. ]]>
4755 </use>
4756 <attribute arch="no_pick" value="1" type="fixed" />
4757 &move_on;
4758 <attribute arch="level" editor="trap level" type="int">
4759 Level effects how easily a trap may be found and disarmed, and
4760 how much experience the player gets for doing so. Beware: High level
4761 traps can be quite a cheap source of experience! So either make them
4762 tough, or keep the level low.
4763 </attribute>
4764 <attribute arch="Cha" editor="visibility" type="int">
4765 This value determines what fraction of the time the trap is visible:
4766 It'll be randomly visible 1/&lt;visibility&gt; of the time. Also effects
4767 how easily the trap may be found.
4768 </attribute>
4769 <attribute arch="hp" editor="number of charges" type="int">
4770 The trap will detonate &lt;number of charges&gt; times before disappearing.
4771 </attribute>
4772 <attribute arch="dam" editor="direct damage" type="int">
4773 &lt;direct damage&gt; specifies how much damage is done by the trap.
4774 This should be set in reasonable relation to the trap's level.
4775 </attribute>
4776 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
4777 This attribute defines what attacktype to use for direct damage when
4778 the trap detonates.
4779 </attribute>
4780 <attribute arch="connected" editor="connection" type="int">
4781 When the trap is detonated, all objects with the same
4782 connection value get activated.
4783 </attribute>
4784 <attribute arch_begin="msg" arch_end="endmsg" editor="detonation text" type="text">
4785 When the trap detonates, this text is displayed to the
4786 victim. For especially powerful or complex traps, create an appropriate
4787 and thrilling description. ;)
4788 </attribute>
4789 </type>
4790
4791 <!--####################################################################-->
4792 <type number="95" name="Trapdoor">
4793 <ignore>
4794 <ignore_list name="non_pickable" />
4795 </ignore>
4796 <description><![CDATA[
4797 Trapdoors are very similar to pits. The difference is that they
4798 can not be closed. Instead, the weight of the object on the
4799 trapdoor determines weither it slams the trapdoor open and falls through
4800 or not.<br>
4801 Once a trapdoor has been opened (by a creature or items of sufficient
4802 weight,) it remains open, acting like an opened pit. ]]>
4803 </description>
4804 <use><![CDATA[
4805 Trapdoors should be used in the same fashion as pits:
4806 They should always drop the victims to some kind of lower level. They
4807 are not supposed to be used to randomly interconnect maps like teleporters. ]]>
4808 </use>
4809 <attribute arch="no_pick" value="1" type="fixed" />
4810 &move_on;
4811 <attribute arch="weight" editor="hold weight" type="int">
4812 This value defines how much weight the trapdoor can hold.
4813 Once items or creatures are gathered on the trapdoor, with
4814 a total weight surpassing this value, then the trapdoor will
4815 open and things start falling through.
4816 </attribute>
4817 <attribute arch="hp" editor="destination X" type="int">
4818 The trapdoor will transport creatures (and items) randomly into
4819 a two-square radius of the destination coordinates.
4820 If the destination square becomes blocked, the trapdoor will act like
4821 being filled up and not work anymore!
4822 </attribute>
4823 <attribute arch="sp" editor="destination Y" type="int">
4824 The trapdoor will transport creatures (and items) randomly into
4825 a two-square radius of the destination coordinates.
4826 If the destination square becomes blocked, the trapdoor will act like
4827 being filled up and not work anymore!
4828 </attribute>
4829 </type>
4830
4831 <!--####################################################################-->
4832 <type number="4" name="Treasure">
4833 <ignore>
4834 <attribute arch="nrof" />
4835 <attribute arch="title" />
4836 <attribute arch="name_pl" />
4837 <attribute arch="weight" />
4838 <attribute arch="value" />
4839 <attribute arch="material" />
4840 </ignore>
4841 <description><![CDATA[
4842 A treasure-object turns into certain randomitems when the map is loaded
4843 into the game. ]]>
4844 </description>
4845 <use><![CDATA[
4846 About usage of the "random-artifact" treasurelist:
4847 This will generate powerful stuff like girdles, xray helmets, special
4848 swords etc. If you put this as reward to your quest, players might be
4849 motivated to do it more than once. BUT, by doing so they will get a huge
4850 number of different artifacts! Besides, players will always seek the place
4851 with the most easy-to-get random artifact and ignore all others.
4852 My advice: Don't use it! Attract players with good fighting experience
4853 (from monsters), potions, spellbooks, money, and non-random artifacts. ]]>
4854 </use>
4855 <attribute arch="randomitems" editor="treasurelist" type="treasurelist">
4856 This entry determines what kind of treasure will appear. Look into
4857 /crossfire/share/crossfire/treasures for details about existing
4858 treasurelists.
4859 </attribute>
4860 <attribute arch="auto_apply" editor="auto-generate" type="bool">
4861 "Auto-generate" must be set in order to have the treasure be created
4862 when the map is loaded.
4863 If you want to create a random treasure chest, you unset this flag.
4864 That way, the player has to apply the object (the chest), then the
4865 treasure is generated.
4866 </attribute>
4867 <attribute arch="hp" editor="create number" type="int">
4868 "Create number" specifies how many pieces of the given treasurelist
4869 will appear. Note that for every piece there is a chance that nothing is
4870 generated. Also, sometimes there can be stacks of items generated, like
4871 for gems/money.
4872 </attribute>
4873 <attribute arch="exp" editor="quality level" type="int">
4874 The &lt;quality level&gt; will be used for the quality of the generated
4875 treasure instead of the map difficulty (as was done with shops).
4876 If zero/unset, the map difficulty will instead be used.
4877 (Example for comparison: Shop floors generate treasure of
4878 &lt;quality level&gt; 5 per default).
4879 </attribute>
4880 </type>
4881
4882 <!--####################################################################-->
4883 <type number="52" name="Trigger Marker">
4884 <ignore>
4885 <ignore_list name="system_object" />
4886 </ignore>
4887 <description><![CDATA[
4888 A trigger marker is an object that inserts an invisible force (a mark) into a
4889 player stepping on it WHEN TRIGGERED. This force does nothing except containing a
4890 &lt;key string&gt; which can be discovered by detectors or inventory
4891 checkers. It is also possible to use markers for removing marks again.
4892 <br><br>
4893 Note that the player has no possibility to "see" his own marks,
4894 except by the effect that they cause on the maps. ]]>
4895 </description>
4896 <use><![CDATA[
4897 Markers hold real cool possibilities for map-making. I encourage
4898 you to use them frequently. However there is one negative point
4899 about markers: Players don't "see" what's going on with them. It is
4900 your task, as map-creator, to make sure the player is always well
4901 informed and never confused.
4902 <br><br>
4903 Please avoid infinite markers when they aren't needed. They're
4904 using a little space in the player file after all, so if there
4905 is no real purpose, set an expire time. ]]>
4906 </use>
4907 <attribute arch="no_pick" value="1" type="fixed" />
4908 <attribute arch="slaying" editor="key string" type="string">
4909 The &lt;key string&gt; can be detected by inv. checkers/detectors.
4910 If the player already has a force with that &lt;key string&gt;,
4911 there won't be inserted a second one.
4912 </attribute>
4913 <attribute arch="connected" editor="connection" type="int">
4914 Unlike a regular marker this is the connection that triggers this marker to activate.
4915 </attribute>
4916 <attribute arch="food" editor="mark duration" type="int">
4917 This value defines the duration of the force it inserts.
4918 If nonzero, the duration of the player's mark is finite:
4919 about 1 food per 10 seconds. &lt;mark duration&gt; zero/unset
4920 means the mark will stay on the player forever.
4921 </attribute>
4922 <attribute arch="name" editor="delete mark" type="string">
4923 When the player steps onto the marker, all existing forces in
4924 the players inventory with a &lt;key string&gt; matching &lt;delete mark&gt;
4925 will be removed. If you don't want to remove any marks, leave
4926 this textfield empty.
4927
4928 Note that the string &lt;delete mark&gt; is set as the name of
4929 this marker. So don't be confused, and remember changing the
4930 name will take effect on the marker's functionality.
4931 </attribute>
4932 <attribute arch_begin="msg" arch_end="endmsg" editor="marking message" type="text">
4933 In the moment when the player gets marked, this text is displayed
4934 to him. You should really set a message in any marker you create,
4935 because it's the only way for the player to notice what's going on.
4936 </attribute>
4937 </type>
4938
4939 <!--####################################################################-->
4940 <type number="0" name="Wall">
4941 <required>
4942 <attribute arch="is_floor" value="0" />
4943 <attribute arch="alive" value="0" />
4944 <attribute arch="no_pass" value="1" />
4945 </required>
4946 <ignore>
4947 <attribute arch="nrof" />
4948 <attribute arch="title" />
4949 <attribute arch="name_pl" />
4950 <attribute arch="value" />
4951 <attribute arch="unpaid" />
4952 </ignore>
4953 <description><![CDATA[
4954 Walls usually block passage and sight. ]]>
4955 </description>
4956 &movement_types_terrain;
4957 <attribute arch="can_roll" editor="moveable" type="bool">
4958 If set, the object is able to "roll", so it can be pushed around.
4959 This setting is used for boulders and barrels.
4960 </attribute>
4961 <attribute arch="no_magic" editor="restrict spells" type="bool">
4962 This takes effect only with &lt;blocksview&gt; disabled.
4963 Restricting the use of spells to pass this wall.
4964 </attribute>
4965 <attribute arch="damned" editor="restrict prayers" type="bool">
4966 This takes effect only with &lt;blocksview&gt; disabled.
4967 Restricting the use of spells to pass this wall.
4968 </attribute>
4969 </type>
4970
4971 <!--####################################################################-->
4972 <type number="109" name="Wand &amp; Staff">
4973 <description><![CDATA[
4974 Wands contain a certain spell. The player can apply (ready) and
4975 fire the wand. After a defined number of casts, the wand is
4976 "used up". It is possible to recharge a wand with scrolls of
4977 charging, but usually that isn't worth the cost. ]]>
4978 </description>
4979 <use><![CDATA[
4980 Wands are quite seldomly used. The reason prolly is that they're
4981 generally not cost-efficient. Handing out high-level wands with
4982 powerful special spells isn't a good idea either, because of
4983 the recharge ability.
4984 <br><br>
4985 For low levels, staffs of healing/cure and word of recall are
4986 quite desirable though. Ideal rewards for low level quests. ]]>
4987 </use>
4988 <attribute arch="sp" editor="spell" type="spell">
4989 The &lt;spell&gt; specifies the contained spell.
4990 </attribute>
4991 <attribute arch="level" editor="casting level" type="int">
4992 The &lt;casting level&gt; of the wand determines it's power.
4993 An average level for wands in shops is about 10.
4994 </attribute>
4995 <attribute arch="food" editor="number of charges" type="int">
4996 The wand can be used &lt;number of charges&gt; times before it is
4997 used up. It can be recharged with scrolls of charging.
4998 </attribute>
4999 <attribute arch="startequip" editor="godgiven item" type="bool">
5000 A godgiven item vanishes as soon as the player
5001 drops it to the ground.
5002 </attribute>
5003 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
5004 This text may contain a description of the wand.
5005 </attribute>
5006 </type>
5007
5008 <!--####################################################################-->
5009 <type number="0" name="Weak Wall">
5010 <required>
5011 <attribute arch="is_floor" value="0" />
5012 <attribute arch="alive" value="1" />
5013 <attribute arch="tear_down" value="1" />
5014 </required>
5015 <ignore>
5016 <ignore_list name="non_pickable" />
5017 </ignore>
5018 <description><![CDATA[
5019 A weak wall is a breakable spot amidsts a solid wall. Typically
5020 these weak walls look similar to their solid "relatives" except
5021 for a small crack or little chunks of wall on the ground. ]]>
5022 </description>
5023 <use><![CDATA[
5024 If you want to create hidden rooms, using weak walls is alot
5025 better than completely indiscernible passages in a wall.<br>
5026 Anyways, there can be a lot more to weak walls than just finding
5027 them: Rising their defensive stats, weak walls can become a
5028 serious obstacle. An ice wall might only be torn down by a fire
5029 attack for example. A granite wall for instance might be very
5030 hard to destroy. ]]>
5031 </use>
5032 <attribute arch="alive" value="1" type="fixed" />
5033 <attribute arch="no_pick" value="1" type="fixed" />
5034 <attribute arch="tear_down" value="1" type="fixed" />
5035 <attribute arch="race" editor="race" type="string">
5036 For weak walls, &lt;race&gt; should always be set to "wall",
5037 unless you create something fancy like a building which
5038 is in fact meant to be a huge animal.
5039 Note that shovels slay walls, so they do tripple damage
5040 against weak walls.
5041 </attribute>
5042 <attribute arch="level" editor="level" type="int">
5043 The &lt;level&gt; of a weak wall works similar to monster levels.
5044 Due to the fact that weak walls cannot attack, the level
5045 is much less important though.
5046 </attribute>
5047 <attribute arch="hp" editor="health points" type="int">
5048 The &lt;health points&gt; of a weak wall define how long it takes to
5049 tear it down. With every successful hit from an opponent,
5050 &lt;health points&gt; get drained.
5051 </attribute>
5052 <attribute arch="maxhp" editor="max health" type="int">
5053 &lt;max health&gt; is the maximum amount of &lt;health points&gt; this
5054 weak wall can have. Since walls generally don't heal, I doubt
5055 this has much real effect.
5056 </attribute>
5057 <attribute arch="ac" editor="armour class" type="int">
5058 Weak walls of high &lt;armour class&gt; are less likely to get hit.
5059 &lt;armour class&gt; can be considered the "counterpiece" to &lt;weapon class&gt;.
5060 </attribute>
5061 <section name="resistance">
5062 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
5063 </attribute>
5064 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
5065 </attribute>
5066 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
5067 </attribute>
5068 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
5069 </attribute>
5070 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
5071 </attribute>
5072 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
5073 </attribute>
5074 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
5075 </attribute>
5076 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
5077 </attribute>
5078 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
5079 </attribute>
5080 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
5081 </attribute>
5082 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
5083 </attribute>
5084 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
5085 </attribute>
5086 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
5087 </attribute>
5088 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
5089 </attribute>
5090 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
5091 </attribute>
5092 <attribute arch="resist_turn_undead" editor="resist turn undead %" length="15" type="int">
5093 </attribute>
5094 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
5095 </attribute>
5096 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
5097 </attribute>
5098 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
5099 </attribute>
5100 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
5101 </attribute>
5102 <attribute arch="resist_godpower" editor="resist godpower %" length="15" type="int">
5103 </attribute>
5104 </section>
5105 </type>
5106
5107 <!--####################################################################-->
5108 <type number="15" name="Weapon">
5109 <description><![CDATA[
5110 Wielding a weapon, the object's stats will directly be inherited to the
5111 player. Usually enhancing his fighting-abilities. Non-magical weapons can
5112 be improved with scrolls. ]]>
5113 </description>
5114 <use><![CDATA[
5115 If you create artifacts (equipment) with stats- or resistance-bonus:
5116 Keep playbalance in mind! Such items mustn't be reachable without hard
5117 fighting AND questing. ]]>
5118 </use>
5119 <attribute arch="attacktype" editor="attacktype" type="bitmask_attacktype">
5120 This number is a bitmask, specifying the weapon's attacktypes.
5121 Attacktypes are: physical, magical, fire, cold.. etc. Most artifact weapons
5122 have no more than one or two attacktypes. Keep in mind that all weapons
5123 can be blessed by the player's diety, thus adding an additional attacktype.
5124
5125 When a player hits a monster with a weapon that has more than one attacktype,
5126 then he will do as much damage as the "best" of his attacktypes does. So,
5127 the more attacktypes you've got, the better your chance to take advantage
5128 of a monster's vulnerabilities. (Btw: Same rule applies for monster vs.
5129 player.). Attacktypes "magic" and "chaos" are somehow exceptions.
5130 </attribute>
5131 <attribute arch="weapontype" editor="weapontype" type="list_weapon_type">
5132 The &lt;weapontype&gt; characterizes the weapon's type of physical
5133 attack. It could best be considered a "subclassification"
5134 of the physical attacktype. For now, this is only used for
5135 attack messages!
5136
5137 You should always set this correctly when creating new
5138 weapons for your maps.
5139 </attribute>
5140 <attribute arch="skill" editor="skill name" type="string">
5141 Matching &lt;skill name&gt; of the skill that is required
5142 to use this weapon.
5143 </attribute>
5144 <attribute arch="dam" editor="damage" type="int">
5145 The damage value is used as base value for how much damage the weapon
5146 does per hit. The actual damage involves more dependencies,
5147 like wielder's level and defender's level. Look at existing weapons
5148 to get a feel for the range of weapon damage values.
5149 </attribute>
5150 <attribute arch="slaying" editor="slaying race" type="string">
5151 Slaying means the weapon does tripple (3x) damage to monsters of the
5152 specified race. If &lt;slaying race&gt; matches an arch name (e.g. "big_dragon"),
5153 only monsters of that archtype are hit with tripple damage.
5154
5155 No god blessings are possible for weapons with a race set in this entry
5156 (That's because god blessings add tripple damage against their own
5157 enemy races). Tripple damage is very effective.
5158 </attribute>
5159 <attribute arch="last_sp" editor="weapon speed" type="int">
5160 The weapon speed determines how often the wielder can swing the weapon
5161 during a certain period of time. The lower the faster, &lt;weapon speed&gt; 1
5162 is best (that is lightning- fast). A typical average value is 8.
5163 Speed and damage should be kept in reasonable relation.
5164 </attribute>
5165 <attribute arch="wc" editor="weapon class" type="int">
5166 The weapon class value adds to the overall weapon class of the wielder's
5167 melee attacks. Weapon class improves the chance of hitting the opponent.
5168 </attribute>
5169 <attribute arch="magic" editor="magic bonus" type="int">
5170 For a weapon, magic bonus works just like weapon class, except that
5171 magic bonus can be improved by the gods or reduced by acid. Hence, it is
5172 less useful than direct weapon class value on a weapon.
5173 </attribute>
5174 <attribute arch="item_power" editor="item power" type="int">
5175 The &lt;item power&gt; value measures how "powerful" an artifact is.
5176 Players will only be able to wear equipment with a certain total
5177 amount of &lt;item power&gt;, depending on their own level. This is the
5178 only way to prevent low level players to wear "undeserved" equipment
5179 (like gifts from other players or cheated items).
5180
5181 It is very important to adjust the &lt;item power&gt; value carefully
5182 for every artifact you create! If zero/unset, the CF server will
5183 calculate a provisional value at runtime, but this is never
5184 going to be an accurate measurement of &lt;item power&gt;.
5185 </attribute>
5186 <attribute arch="damned" editor="damnation" type="bool">
5187 A damned weapon cannot be unwielded unless
5188 the curse is removed. Removing damnations is
5189 a tick harder than removing curses.
5190 </attribute>
5191 <attribute arch="cursed" editor="curse" type="bool">
5192 A cursed weapon cannot be unwielded unless
5193 the curse is removed.
5194 </attribute>
5195 <attribute arch="lifesave" editor="save life" type="bool">
5196 An item with this flag enabled will save the players life
5197 for one time: When the player is wearing this item and his
5198 health points reach zero, the item disappears, replenishing
5199 half of the player's health.
5200
5201 An item with &lt;save life&gt; should not have
5202 any decent additional bonuses!
5203 </attribute>
5204 <attribute arch="unique" editor="unique item" type="bool">
5205 Unique items exist only one time on a server. If the item
5206 is taken, lost or destroyed - it's gone for good.
5207 </attribute>
5208 <attribute arch="startequip" editor="godgiven item" type="bool">
5209 A godgiven item vanishes as soon as the player
5210 drops it to the ground.
5211 </attribute>
5212 <section name="resistance">
5213 <attribute arch="resist_physical" editor="resist physical %" length="15" type="int">
5214 This adds physical resistance to the weapon (= armour value). The number is
5215 a percent-value in the range 0-100. Treat this with CARE. Look at other maps
5216 and what they require to do for getting this-and-that artifact.
5217 </attribute>
5218 <attribute arch="resist_magic" editor="resist magic %" length="15" type="int">
5219 This adds magic resistance to the weapon. The number is a percent-value in
5220 the range 0-100. Treat this with CARE. Look at other maps and what they
5221 require to do for getting this-and-that artifact.
5222 </attribute>
5223 <attribute arch="resist_fire" editor="resist fire %" length="15" type="int">
5224 This adds fire resistance to the weapon. The number is a percent-value in
5225 the range 0-100. Treat this with CARE. Look at other maps and what they
5226 require to do for getting this-and-that artifact.
5227 </attribute>
5228 <attribute arch="resist_electricity" editor="resist electricity %" length="15" type="int">
5229 This adds electricity resistance to the weapon. The number is a percent-value in
5230 the range 0-100. Treat this with CARE. Look at other maps and what they
5231 require to do for getting this-and-that artifact.
5232 </attribute>
5233 <attribute arch="resist_cold" editor="resist cold %" length="15" type="int">
5234 This adds fire resistance to the weapon. The number is a percent-value in
5235 the range 0-100. Treat this with CARE. Look at other maps and what they
5236 require to do for getting this-and-that artifact.
5237 </attribute>
5238 <attribute arch="resist_confusion" editor="resist confusion %" length="15" type="int">
5239 This adds confusion resistance to the weapon. The number is a percent-value in
5240 the range 0-100. Confusion resistance is not very effective
5241 unless the value comes close to 100 (= perfect immunity).
5242 </attribute>
5243 <attribute arch="resist_acid" editor="resist acid %" length="15" type="int">
5244 This adds acid resistance to the weapon. The number is a percent-value in
5245 the range 0-100. Treat this with CARE. Look at other maps and what they
5246 require to do for getting this-and-that artifact.
5247 </attribute>
5248 <attribute arch="resist_drain" editor="resist draining %" length="15" type="int">
5249 This adds draining resistance to the weapon. The number is a percent-value
5250 in the range 0-100. Draining resistance is little effective
5251 unless the value is 100 (= perfect immunity).
5252 </attribute>
5253 <attribute arch="resist_weaponmagic" editor="resist weaponmagic %" length="15" type="int">
5254 This adds weaponmagic resistance to the weapon. The number is a percent-value in
5255 the range 0-100. Weaponmagic resistance generally should not exist on
5256 equipment at all. Spells/Monsters doing weaponmagic damage (e.g. comet spell)
5257 are not meant to be easily resisted.
5258 </attribute>
5259 <attribute arch="resist_ghosthit" editor="resist ghosthit %" length="15" type="int">
5260 This adds ghosthit resistance to the weapon. The number is a percent-value
5261 in the range 0-100. Treat this with CARE. Look at other maps and what they
5262 require to do for getting this-and-that artifact.
5263 </attribute>
5264 <attribute arch="resist_poison" editor="resist poison %" length="15" type="int">
5265 This adds poison resistance to the weapon. The number is a percent-value in
5266 the range 0-100. Treat this with CARE. Look at other maps and what they
5267 require to do for getting this-and-that artifact.
5268 </attribute>
5269 <attribute arch="resist_slow" editor="resist slow %" length="15" type="int">
5270 This adds fear resistance to the weapon. The number is a percent-value in
5271 the range 0-100. Resistance to fear is pretty useless.
5272 </attribute>
5273 <attribute arch="resist_paralyze" editor="resist paralyze %" length="15" type="int">
5274 This adds paralyze resistance to the weapon. The number is a percent-value in
5275 the range 0-100. Paralyze resistance is little effective
5276 unless the value is 100 (= perfect immunity).
5277 </attribute>
5278 <attribute arch="resist_fear" editor="resist fear %" length="15" type="int">
5279 This adds fear resistance to the weapon. The number is a percent-value in
5280 the range 0-100. Resistance to fear is pretty useless.
5281 </attribute>
5282 <attribute arch="resist_deplete" editor="resist depletion %" length="15" type="int">
5283 This adds depletion resistance to the weapon. The number is a percent-value
5284 in the range 0-100. Depletion resistance is little effective
5285 unless the value is 100 (= perfect immunity).
5286 </attribute>
5287 <attribute arch="resist_death" editor="resist death-attack %" length="15" type="int">
5288 This adds death-attack resistance to the weapon. The number is a
5289 percent-value in the range 0-100. Death-attack resistance is little
5290 effective unless the value is 100 (= perfect immunity).
5291 Generally, resistance to death-attack is not supposed to be
5292 available to players!
5293 </attribute>
5294 <attribute arch="resist_chaos" editor="resist chaos %" length="15" type="int">
5295 This adds chaos resistance to the weapon. The number is a percent-value in
5296 the range 0-100. Treat this with CARE. Look at other maps and what they
5297 require to do for getting this-and-that artifact.
5298 Note that chaos is not a stand-alone attacktype. Chaos "contains" a
5299 combination of other attacktypes.
5300 </attribute>
5301 <attribute arch="resist_blind" editor="resist blinding %" length="15" type="int">
5302 This adds blinding resistance to the weapon. The number is a percent-value
5303 in the range 0-100. Treat this with CARE. Look at other maps and what they
5304 require to do for getting this-and-that artifact.
5305 </attribute>
5306 <attribute arch="resist_holyword" editor="resist holy power %" length="15" type="int">
5307 This adds holy power resistance to the weapon. The number is a percent-value
5308 in the range 0-100. Holy power is the attacktype that holyword-type spells
5309 use to hurt undead creatures. This kind of resistance is only reasonable
5310 for undead players (wraith or devourer cult).
5311 Generally, resistance to holy word should not be available for players.
5312 </attribute>
5313 </section>
5314 <section name="stats">
5315 <attribute arch="Str" editor="strength" type="int">
5316 The player's strentgh will rise/fall by the given value
5317 while wearing this weapon.
5318 </attribute>
5319 <attribute arch="Dex" editor="dexterity" type="int">
5320 The player's dexterity will rise/fall by the given value
5321 while wearing this weapon.
5322 </attribute>
5323 <attribute arch="Con" editor="constitution" type="int">
5324 The player's constitution will rise/fall by the given value
5325 while wearing this weapon.
5326 </attribute>
5327 <attribute arch="Int" editor="intelligence" type="int">
5328 The player's intelligence will rise/fall by the given value
5329 while wearing this weapon.
5330 </attribute>
5331 <attribute arch="Pow" editor="power" type="int">
5332 The player's power will rise/fall by the given value
5333 while wearing this weapon.
5334 </attribute>
5335 <attribute arch="Wis" editor="wisdom" type="int">
5336 The player's wisdom will rise/fall by the given value while
5337 wearing this weapon.
5338 </attribute>
5339 <attribute arch="Cha" editor="charisma" type="int">
5340 The player's charisma will rise/fall by the given value
5341 while wearing this weapon.
5342 </attribute>
5343 </section>
5344 <section name="misc">
5345 <attribute arch="luck" editor="luck bonus" type="int">
5346 With positive luck bonus, the player is more likely to
5347 succeed in all sorts of things (spellcasting, praying,...).
5348 Unless the &lt;luck bonus&gt; is very high, the effect will be
5349 barely visible in-game. Luck bonus on one piece of equipment
5350 should never exceed 3, and such bonus should not be too
5351 frequently available.
5352 </attribute>
5353 <attribute arch="hp" editor="health regen." type="int">
5354 Positive &lt;health regen.&gt; bonus speeds up the
5355 player's healing process. Negative values slow it down.
5356 </attribute>
5357 <attribute arch="sp" editor="mana regen." type="int">
5358 Positive &lt;mana regen.&gt; bonus speeds up the
5359 player's mana regeneration. Negative values slow it down.
5360 </attribute>
5361 <attribute arch="grace" editor="grace regen." type="int">
5362 Positive &lt;grace regen.&gt; bonus speeds up the
5363 player's grace regeneration. Negative values slow it down.
5364 Since grace can be regenerated rather easy with praying,
5365 additional &lt;grace regen.&gt; bonus should be VERY RARE!!
5366 </attribute>
5367 <attribute arch="food" editor="food bonus" type="int">
5368 Positive &lt;food bonus&gt; slows down the player's digestion,
5369 thus he consumes less food. Negative values speed it up.
5370
5371 Note that food is consumed not only for "being alive", but
5372 also for healing and mana-regeneration.
5373 &lt;food bonus&gt; only affects the amount of food consumed
5374 for "being alive". Hence, even with high &lt;food bonus&gt;,
5375 during a fight a player can run out of food quickly.
5376 </attribute>
5377 <attribute arch="xrays" editor="xray vision" type="bool">
5378 Xray vision allows the player to see through obstacles
5379 in a two-square-wide radius. This is extremely helpful and
5380 desirable, so don't give it away for cheap on equipment.
5381 </attribute>
5382 <attribute arch="stealth" editor="stealth" type="bool">
5383 Stealth allows the player to move silently.
5384 This comes to effect if a player turns himself
5385 invisible and tries to sneak around monsters.
5386 (At least that was the idea behind it)
5387 </attribute>
5388 <attribute arch="reflect_spell" editor="reflect spells" type="bool">
5389 If a player is wearing any piece of equipment with
5390 the ability to &lt;reflect spells&gt;, all kinds of
5391 spell-bullets and -beams will bounce off him.
5392 This works only about 90% of all times, to
5393 avoid players being completely immune to certain
5394 types of attacks.
5395
5396 This is a very powerful ability and it
5397 shouldn't be handed out cheap!
5398 </attribute>
5399 <attribute arch="reflect_missile" editor="reflect missiles" type="bool">
5400 If a player is wearing any piece of equipment with
5401 the ability to &lt;reflect missiles&gt;, all kinds of
5402 projectiles (e.g. arrows, bolts, boulders) will
5403 bounce off him. This works only about 90% of all
5404 times, to avoid players being completely immune to
5405 certain types of attacks.
5406 </attribute>
5407 <attribute arch="path_attuned" editor="attuned paths" type="bitmask_spellpath">
5408 Click on the &lt;attuned paths&gt; button to select spellpaths.
5409 The player will get attuned to the specified spellpaths
5410 while wearing this weapon.
5411 </attribute>
5412 <attribute arch="path_repelled" editor="repelled paths" type="bitmask_spellpath">
5413 Click on the &lt;repelled paths&gt; button to select spellpaths.
5414 The player will get repelled to the specified spellpaths
5415 while wearing this weapon.
5416 </attribute>
5417 <attribute arch="path_denied" editor="denied paths" type="bitmask_spellpath">
5418 Click on the &lt;denied paths&gt; button to select spellpaths.
5419 The specified spellpaths will be denied to the player
5420 while wearing this weapon.
5421 </attribute>
5422 </section>
5423 <attribute arch_begin="msg" arch_end="endmsg" editor="description" type="text">
5424 This text describes the weapons's "story". Every decent artifact weapon
5425 should have such a description.
5426 </attribute>
5427 </type>
5428
5429 <type number="116" name="Event Connector">
5430 <description><![CDATA[
5431 Event connectors link specific events that happen to objects to
5432 a crossfire plug-in. ]]>
5433 </description>
5434 <attribute arch="subtype" editor="event type" type="list_event_type">
5435 The type of event that triggers a notify to the plug-in.
5436 </attribute>
5437 <attribute arch="title" editor="plug-in" type="string">
5438 The name of the plug-in that should be notified of the event, e.g. "cfpython"
5439 for python and "perl" for the Crossfire-Perl plug-in.
5440 </attribute>
5441 <attribute arch="slaying" editor="extension" type="string">
5442 The name of the extension to invoke (for python, this is the path to a script,
5443 for perl this is the name of a extension package without the ".ext" extension.
5444 </attribute>
5445 <attribute arch="name" editor="options" type="string">
5446 A string that is passed unaltered to the extension above. Often used to pass
5447 options to the extension that alter its behaviour.
5448 </attribute>
5449 </type>
5450
5451 </types>