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

File Contents

# User Rev Content
1 root 1.1 =head1 NAME
2    
3     Crossfire::Data - various data structures useful for understanding archs and objects
4    
5     =head1
6    
7     THIS FILE IS AUTOGENERATED, DO NOT EDIT!
8    
9     It's a translation of the following files:
10    
11     res/spells.xml
12     res/types.xml
13     res/typenumbers.xml
14    
15     See F<res/README> for more info.
16    
17     =cut
18    
19 root 1.4 package Crossfire::Data;
20    
21 root 1.3 our %BITMASK = (
22     attacktype => {
23     0 => 'Physical',
24     1 => 'Magical',
25     2 => 'Fire',
26     3 => 'Electricity',
27     4 => 'Cold',
28     5 => 'Confusion',
29     6 => 'Acid',
30     7 => 'Drain',
31     8 => 'Weaponmagic',
32     9 => 'Ghosthit',
33     10 => 'Poison',
34     11 => 'Slow',
35     12 => 'Paralyze',
36     13 => 'Turn Undead',
37     14 => 'Fear',
38     15 => 'Cancellation',
39     16 => 'Depletion',
40     17 => 'Death',
41     18 => 'Chaos',
42     19 => 'Counterspell',
43     20 => 'God Power',
44     21 => 'Holy Power',
45     22 => 'Blinding'
46     },
47     material => {
48     0 => 'Paper',
49     1 => 'Iron',
50     2 => 'Glass',
51     3 => 'Leather',
52     4 => 'Wood',
53     5 => 'Organics',
54     6 => 'Stone',
55     7 => 'Cloth',
56 root 1.13 8 => 'Adamantite',
57     9 => 'Liquid',
58     10 => 'Soft Metal',
59     11 => 'Bone',
60     12 => 'Ice',
61     13 => '(supress name on display)'
62 root 1.3 },
63 root 1.14 movement_type => {
64     0 => 'Walk',
65     1 => 'Fly Low',
66     2 => 'Fly High',
67     3 => 'Swim',
68 root 1.16 4 => 'Boat',
69     16 => 'Other'
70 root 1.14 },
71 root 1.3 pick_up => {
72     0 => 'Nothing',
73     1 => 'Wealth',
74     2 => 'Food',
75     3 => 'Weapons',
76     4 => 'Armour',
77     5 => 'Inverse',
78     6 => 'All'
79     },
80     spellpath => {
81     0 => 'Protection',
82     1 => 'Fire',
83     2 => 'Frost',
84     3 => 'Electricity',
85     4 => 'Missiles',
86     5 => 'Self',
87     6 => 'Summoning',
88     7 => 'Abjuration',
89     8 => 'Restoration',
90     9 => 'Detonation',
91     10 => 'Mind',
92     11 => 'Creation',
93     12 => 'Teleportation',
94     13 => 'Information',
95     14 => 'Transmutation',
96     15 => 'Transferrence',
97     16 => 'Turning',
98     17 => 'Wounding',
99     18 => 'Death',
100     19 => 'Light'
101     },
102     will_apply => {
103     0 => 'Apply Handles',
104     1 => 'Open Chests',
105     2 => 'Break Walls',
106     3 => 'Open Doors'
107     }
108     );
109    
110     our %LIST = (
111 root 1.15 attack_movement_bits_0_3 => {
112     0 => 'default',
113     1 => 'attack from distance',
114     2 => 'run away',
115     3 => 'hit and run',
116     4 => 'wait, then hit, then move',
117     5 => 'rush blindly',
118     6 => 'always run',
119     7 => 'attack from distance if hit',
120     8 => 'do not approach'
121     },
122     attack_movement_bits_4_7 => {
123     0 => 'none',
124     16 => 'pet',
125     32 => 'small circle',
126     48 => 'large circle',
127     64 => 'small horizontal',
128     80 => 'large horizontal',
129     96 => 'random direction',
130     112 => 'random movement',
131     128 => 'small vertical',
132     144 => 'large vertical'
133     },
134 root 1.3 direction => {
135     0 => '<none>',
136     1 => 'north',
137     2 => 'northeast',
138     3 => 'east',
139     4 => 'southeast',
140     5 => 'south',
141     6 => 'southwest',
142     7 => 'west',
143     8 => 'northwest'
144     },
145 root 1.10 event_type => {
146     0 => 'none',
147     1 => 'apply',
148     2 => 'attack',
149     3 => 'death',
150     4 => 'drop',
151     5 => 'pickup',
152     6 => 'say',
153     7 => 'stop',
154     8 => 'time',
155     9 => 'throw',
156     10 => 'trigger',
157     11 => 'close',
158     12 => 'timer',
159 elmex 1.22 28 => 'move',
160     41 => 'drop_on'
161 root 1.10 },
162 root 1.3 mood => {
163     0 => 'furious',
164     1 => 'angry',
165     2 => 'calm',
166     3 => 'sleep',
167     4 => 'charm'
168 root 1.1 },
169 root 1.3 potion_effect => {
170     0 => '<none>',
171     65536 => 'life restoration',
172     1048576 => 'improvement'
173 root 1.1 },
174 root 1.3 skill_type => {
175     1 => 'lockpicking',
176     2 => 'hiding',
177     3 => 'smithery',
178     4 => 'bowyer',
179     5 => 'jeweler',
180     6 => 'alchemy',
181     7 => 'stealing',
182     8 => 'literacy',
183     9 => 'bargaining',
184     10 => 'jumping',
185     11 => 'detect magic',
186     12 => 'oratory',
187     13 => 'singing',
188     14 => 'detect curse',
189     15 => 'find traps',
190     16 => 'mediatation',
191     17 => 'punching',
192     18 => 'flame touch',
193     19 => 'karate',
194     20 => 'climbing',
195     21 => 'woodsman',
196     22 => 'inscription',
197     23 => 'one handed weapons',
198     24 => 'missile weapons',
199     25 => 'throwing',
200     26 => 'use magic item',
201     27 => 'disarm traps',
202     28 => 'set traps',
203     29 => 'thaumaturgy',
204     30 => 'praying',
205     31 => 'clawing',
206     32 => 'levitation',
207     33 => 'summoning',
208     34 => 'pyromancy',
209     35 => 'evocation',
210     36 => 'sorcery',
211     37 => 'two handed weapons'
212 root 1.1 },
213 root 1.3 spell_type => {
214     1 => 'raise dead',
215     2 => 'rune',
216     3 => 'make mark',
217     4 => 'bolt',
218     5 => 'bullet',
219     6 => 'explosion',
220     7 => 'cone',
221     8 => 'bomb',
222     9 => 'wonder',
223     10 => 'smite',
224     11 => 'magic missile',
225     12 => 'summon golem',
226     13 => 'dimension door',
227     14 => 'magic mapping',
228     15 => 'magic wall',
229     16 => 'destruction',
230     17 => 'perceive self',
231     18 => 'word of recall',
232     19 => 'invisible',
233     20 => 'probe',
234     21 => 'healing',
235     22 => 'create food',
236     23 => 'earth to dust',
237     24 => 'change ability',
238     25 => 'bless',
239     26 => 'curse',
240     27 => 'summon monster',
241     28 => 'recharge',
242     29 => 'polymorph',
243     30 => 'alchemy',
244     31 => 'remove curse',
245     32 => 'identify',
246     33 => 'detection',
247     34 => 'mood change',
248     35 => 'moving ball',
249     36 => 'swarm',
250     37 => 'charge mana',
251     38 => 'dispel rune',
252     39 => 'create missile',
253     40 => 'consecrate',
254     41 => 'animate weapon',
255     42 => 'light',
256     43 => 'change map light',
257     44 => 'faery fire',
258     45 => 'disease',
259     46 => 'aura',
260     47 => 'town portal'
261 root 1.1 },
262 root 1.3 weapon_type => {
263     0 => '<unknown>',
264     1 => 'sword',
265     2 => 'arrows',
266     3 => 'axe',
267     4 => 'katana',
268     5 => 'knife, dagger',
269     6 => 'whip, chain',
270     7 => 'hammer, flail',
271     8 => 'club, stick'
272     }
273     );
274    
275     our %IGNORE_LIST = (
276     non_pickable => [
277     'value',
278     'nrof',
279     'weight',
280     'name_pl',
281     'material',
282     'no_pick',
283     'unpaid',
284     'title',
285     'identified'
286     ],
287     system_object => [
288     'value',
289     'nrof',
290     'weight',
291     'name_pl',
292     'material',
293     'no_pick',
294     'unpaid',
295     'title',
296     'glow_radius',
297     'identified',
298     'blocksview',
299     'invisible'
300     ]
301     );
302    
303     our %DEFAULT_ATTR = (
304 root 1.7 attr => [
305     [
306     'name',
307     {
308     desc => 'This is the name of the object, displayed to the player.',
309     name => 'name',
310     type => 'string'
311     }
312     ],
313     [
314     'name_pl',
315     {
316     desc => 'This is the plural name of the object. A plural name must be set for all items that can be picked up and collected by the player.',
317     name => 'plural name',
318     type => 'string'
319     }
320     ],
321     [
322     'title',
323     {
324 root 1.9 desc => 'This is the object\'s title. Once an object is identified the title is attached to the name. Typical titles are "of Mostrai", "of xray vision" etc.',
325 root 1.7 name => 'title',
326     type => 'string'
327     }
328     ],
329     [
330     'face',
331     {
332     desc => 'The image-name defines what image is displayed for this object in-game.',
333     name => 'image',
334     type => 'string'
335     }
336     ],
337     [
338     'nrof',
339     {
340     desc => 'This value determines the number of objects in one stack (for example: 100 goldcoins => "number = 100"). You should set this at least to one, for any pickable object - otherwise it won\'t be mergeable into a stack.',
341     name => 'number',
342     type => 'int'
343     }
344     ],
345     [
346     'weight',
347     {
348 root 1.9 desc => 'This value defines the object\'s weight in grams (1000g is 1kg). Objects with zero weight are not pickable for players. Still, set the "non-pickable"-flag for explicitly non-pickable objects (hey, this is opensource.. you never know ;) ).',
349 root 1.7 name => 'weight',
350     type => 'int'
351     }
352     ],
353     [
354     'value',
355     {
356 root 1.18 desc => 'Determines the value of the object, in units of silver coins (one platinum coin == 50 silver coins). Value for buying/selling will be further modified by various factors. Hence, testing values in-game is usually inevitable.',
357 root 1.7 name => 'value',
358     type => 'int'
359     }
360     ],
361     [
362     'glow_radius',
363     {
364 root 1.9 desc => 'If <glow radius> is set to a value greater zero, the object appears lit up on dark maps. <glow radius> can be a value between 0 and 4, the higher, the more light does the object emit.',
365 root 1.7 name => 'glow radius',
366     type => 'int'
367     }
368     ],
369     [
370     'material',
371     {
372     desc => 'This bitmask-value informs the player of which material(s) the object consists. Material does also affect how likely the object can be destroyed by hazardous spell-effects.',
373     name => 'material',
374     type => 'bitmask',
375     value => $BITMASK{material}
376     }
377     ],
378     [
379     'no_pick',
380     {
381     desc => 'If set, the object cannot be picked up (Neither by players nor monsters).',
382     name => 'non-pickable',
383     type => 'bool'
384     }
385     ],
386     [
387     'invisible',
388     {
389     desc => 'Generally makes the object invisible. Depending on the object-type, some can be made visible by the show_invisible spell. If in doubt, test it. Putting an invisible object under the floor always prevents it from being shown.',
390     name => 'invisible',
391     type => 'bool'
392     }
393     ],
394     [
395     'blocksview',
396     {
397     desc => 'If an item is set to block view, players (and monsters) cannot see byond it unless they cross it or manage to stand ontop.',
398     name => 'block view',
399     type => 'bool'
400     }
401     ],
402     [
403     'identified',
404     {
405     desc => 'If an item is identified, the player has full knowledge about it.',
406     name => 'identified',
407     type => 'bool'
408     }
409     ],
410     [
411     'unpaid',
412     {
413     desc => 'An <unpaid> item cannot be used unless a player carried it over a shop mat, paying the demanded price. Setting this flag makes sense only for pickable items inside shops.',
414     name => 'unpaid',
415     type => 'bool'
416     }
417     ]
418     ]
419 root 1.3 );
420    
421     our %TYPE = (
422     Ability => {
423 root 1.7 attr => [
424     [
425     'invisible',
426     {
427     type => 'fixed',
428     value => 1
429     }
430     ],
431     [
432     'no_drop',
433     {
434     type => 'fixed',
435     value => 1
436     }
437     ],
438     [
439     'sp',
440     {
441     desc => 'The monster will use the specified <short range spell> when the player is within 6-square radius (of the monster\'s head).',
442     name => 'short range spell',
443     type => 'spell'
444     }
445     ],
446     [
447     'hp',
448     {
449     desc => 'The monster will use the specified <long range spell> when the player is at least 6 squares away (from the monster\'s head). Setting a <long range spell> is optional. If unset, the <short range spell> gets used all the time.',
450     name => 'long range spell',
451     type => 'nz_spell'
452     }
453     ],
454     [
455     'maxsp',
456     {
457     desc => 'Sometimes you\'ll want a monster to use one ability more than others. To achieve this, set the <importance> to a value greater than one. Abilities with this value zero/unset are counted to be of <importance> one. Example: A monster with "small fireball" of <importance> 3 and "paralyze" of <importance> 1 will averagely cast three out of four times the "small fireball".',
458     name => 'importance',
459     type => 'int'
460     }
461     ],
462     [
463     'attacktype',
464     {
465 root 1.9 desc => 'This flag specifies whether the ability <is magical> in nature. If enabled, all spells produced by this ability will have magic attacktype added to the usual attacktypes. This should always be set for spell-like abilities. "Natural" abilities like a dragon\'s firebreath are an exception. Note that non-magical abilities are more dangerous because magic resistance does not protect from those.',
466 root 1.7 name => 'is magical',
467     type => 'bool',
468     value => [
469     0,
470     2
471     ]
472     }
473     ]
474     ],
475 root 1.3 desc => 'Abilities are to be put in a monster\'s inventory. They grant monsters the knowledge to cast spells. Spells from abilities are usually magical in nature, thus adding magic attacktype to the spell-damage they produce. <br><br> A particularly nice feature of abilities is that they can hold two spells: One for short range- and one for long range use. \\n\\n You should know that spellcasting monsters receive abilities via &lt;treasurelist&gt;.',
476     ignore => [
477     $IGNORE_LIST{system_object}
478     ],
479 root 1.5 name => 'Ability',
480 root 1.3 use => 'If you want to create "customized" spellcasting monsters, you should use abilities (rather than spellbooks/wands or something). The long/short-range spell feature can make boss-monsters more interesting and challenging. <br><br> You should keep in mind that magic abilities allow players to get better resistance. You can turn off the magic part to make the spells more dangerous. However, this really shouldn\'t be neccessary unless you work on very high level maps. And what fun is a magic resistance cloak when it has no effect?'
481     },
482     Altar => {
483 root 1.7 attr => [
484     [
485     'no_pick',
486     {
487     type => 'fixed',
488     value => 1
489     }
490     ],
491     [
492 root 1.14 'move_on',
493 root 1.7 {
494 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
495     name => 'movement type',
496     type => 'bitmask',
497     value => $BITMASK{movement_type}
498 root 1.7 }
499     ],
500     [
501     'slaying',
502     {
503     desc => 'This string specifies the item that must be put on the altar to activate it. It can either be the name of an archetype, or directly the name of an object. Yet, titles are not recognized by altars. Remember to put a note somewhere, telling the player what he is expected to drop on the altar. (Often this is put in the altar\'s name: E.g. "drop 100 platinums")',
504     name => 'match item name',
505     type => 'string'
506     }
507     ],
508     [
509     'food',
510     {
511     desc => 'The drop amount specifies the amount of items (specified in <match item name>) that must be dropped to activate the altar. If <match item name> is set to "money", then the value of the sacrificed money must be equal to <drop amount> (ie, if food=200, then 200 silver, 20 gold, or 4 platinum will all work.) Note that the maximum possible for <drop amount> is 32767.',
512     name => 'drop amount',
513     type => 'int'
514     }
515     ],
516     [
517     'connected',
518     {
519     desc => 'If a connection value is set, the altar will trigger all objects with the same value, when activated. This will only work once.',
520     name => 'connection',
521     type => 'int'
522     }
523     ],
524     [
525     'sp',
526     {
527 root 1.9 desc => 'When activated, the selected <spell> will be casted (once, on the player). This should work for any given spell. The altar will work infinitely in this way. Don\'t set both <spell> and <connection> for one altar.',
528 root 1.7 name => 'spell',
529     type => 'spell'
530     }
531     ],
532     [
533     'msg',
534     {
535     desc => 'This text will be displayed to the player in the exact moment when the altar is activated.',
536     end => 'endmsg',
537     name => 'message',
538     type => 'text'
539     }
540     ]
541     ],
542 root 1.9 desc => 'When a player puts a defined number of certain items on the altar, then either a spell is casted (on the player) or a connector is triggered. If the latter is the case, the altar works only once. Either way, the sacrificed item disappears.',
543 root 1.3 ignore => [
544     $IGNORE_LIST{non_pickable}
545 root 1.5 ],
546     name => 'Altar'
547 root 1.3 },
548     'Altar Trigger' => {
549 root 1.7 attr => [
550     [
551     'no_pick',
552     {
553     type => 'fixed',
554     value => 1
555     }
556     ],
557     [
558     'slaying',
559     {
560     desc => 'This string specifies the item that must be put on the altar to activate it. It can either be the name of an archetype, or directly the name of an object. Yet, titles are not recognized by altars. Remember to put a note somewhere, telling the player what he is expected to drop on the altar. (Often this is put in the altar\'s name: E.g. "drop 100 platinums")',
561     name => 'match item name',
562     type => 'string'
563     }
564     ],
565     [
566     'food',
567     {
568     desc => 'The drop amount specifies the amount of items (specified in <match item name>) that must be dropped to activate the altar. If <match item name> is set to "money", then the value of the sacrificed money must be equal to <drop amount> (ie, if food=200, then 200 silver, 20 gold, or 4 platinum will all work.) Note that the maximum possible for <drop amount> is 32767.',
569     name => 'drop amount',
570     type => 'int'
571     }
572     ],
573     [
574     'connected',
575     {
576     desc => 'If a connection value is set, the altar will trigger all objects with the same value, when activated. This will only work once.',
577     name => 'connection',
578     type => 'int'
579     }
580     ],
581     [
582     'sp',
583     {
584 root 1.9 desc => 'When activated, this <spell> will be casted (once, on the player). This should work for any given spell. The altar will work infinitely in this way. Don\'t set both <spell> and <connection> for one altar.',
585 root 1.7 name => 'spell',
586     type => 'spell'
587     }
588     ],
589     [
590     'exp',
591     {
592     desc => 'Being activated, the altar will reset after <reset time> ticks. After reset, the altar is ready to be activated once again. The default <reset time> is 30.',
593     name => 'reset time',
594     type => 'int'
595     }
596     ],
597     [
598     'last_sp',
599     {
600     desc => 'If this attribute is enabled, the altar_trigger won\'t push the connected value by altar reset. Only ONCE by dropping the sacrifice. This is typically used when the altar is connected to a creator, e.g. for selling tickets. If this attribute is disabled (default), the altar_trigger will push the connected value TWICE per sacrifice: First by dropping sacrifice, second by reset. This mode is typically used for altars being connected to gates, resulting in the gate being opened and closed again.',
601     name => 'ignore reset',
602     type => 'bool'
603     }
604     ],
605     [
606 root 1.14 'move_on',
607 root 1.7 {
608 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
609     name => 'movement type',
610     type => 'bitmask',
611     value => $BITMASK{movement_type}
612 root 1.7 }
613     ],
614     [
615     'msg',
616     {
617     desc => 'This text will be displayed to the player in the exact moment when the altar is activated.',
618     end => 'endmsg',
619     name => 'message',
620     type => 'text'
621     }
622     ]
623     ],
624 root 1.9 desc => 'Altar_triggers work pretty much like normal altars (drop sacrifice -> connection activated), except for the fact that they reset after usage. Hence, altar_triggers can be used infinitely.',
625 root 1.3 ignore => [
626     $IGNORE_LIST{non_pickable}
627     ],
628 root 1.5 name => 'Altar Trigger',
629 root 1.3 use => 'Altar_triggers are very useful if you want to charge a price for... <UL> <LI> ...an item. -> Connect the altar_trigger (set "last_sp 1") to a creator. <LI> ...opening a gate. -> Connect the altar_trigger (set "last_sp 0") to the gate. <LI> ...information. -> Connect the altar_trigger (set "last_sp 1") to a magic_mouth. </UL> The big advantage over normal altars is the infinite usability of altar_triggers! If there are ten players on one server, they\'re quite grateful if things work more than once. =)'
630     },
631     Amulet => {
632 root 1.7 attr => [
633     [
634     'ac',
635     {
636     desc => 'This value defines the amount of armour-class bonus for wearing this item. <Armour class> lessens the chance of being hit. Lower values are better. It should usually be set only for armour-like equipment.',
637     name => 'armour class',
638     type => 'int'
639     }
640     ],
641     [
642     'wc',
643     {
644     desc => 'The <weapon class> value adds to the overall weapon class of the wielder\'s melee attacks. Weapon class improves the chance of hitting the opponent. Weapon class is the "counterpiece" of <armour class>. It should usually be set only for weapon-like items. Lower values are better.',
645     name => 'weapon class',
646     type => 'int'
647     }
648     ],
649     [
650     'item_power',
651     {
652     desc => 'The <item power> value measures how "powerful" an artifact is. Players will only be able to wear equipment with a certain total amount of <item power>, depending on their own level. This is the only way to prevent low level players to wear "undeserved" equipment (like gifts from other players or cheated items). It is very important to adjust the <item power> value carefully for every artifact you create! If zero/unset, the CF server will calculate a provisional value at runtime, but this is never going to be an accurate measurement of <item power>.',
653     name => 'item power',
654     type => 'int'
655     }
656     ],
657     [
658     'damned',
659     {
660     desc => 'A damned piece of equipment cannot be unwielded unless the curse is removed. Removing damnations is a tick harder than removing curses.',
661     name => 'damnation',
662     type => 'bool'
663     }
664     ],
665     [
666     'cursed',
667     {
668     desc => 'A cursed piece of equipment cannot be unwielded unless the curse is removed.',
669     name => 'curse',
670     type => 'bool'
671     }
672     ],
673     [
674     'lifesave',
675     {
676 root 1.9 desc => 'An item with this flag enabled will save the players life for one time: When the player is wearing this item and his health points reach zero, the item disappears, replenishing half of the player\'s health. An item with <save life> should not have any decent additional bonuses!',
677 root 1.7 name => 'save life',
678     type => 'bool'
679     }
680     ],
681     [
682     'unique',
683     {
684     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
685     name => 'unique item',
686     type => 'bool'
687     }
688     ],
689     [
690     'startequip',
691     {
692     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
693     name => 'godgiven item',
694     type => 'bool'
695     }
696     ],
697     [
698     'applied',
699     {
700     desc => 'If you put this item into the inventory of a monster, and you want the monster to use/wear the item - you must set <is applied>. Enabling this flag doesn\'t make any sense if the item is NOT in a monster\'s inventory.',
701     name => 'is applied',
702     type => 'bool'
703     }
704     ],
705     [
706     'msg',
707     {
708     desc => 'This text describes the item\'s "story". Every decent artifact should have such a description.',
709     end => 'endmsg',
710     name => 'description',
711     type => 'text'
712     }
713     ]
714     ],
715 root 1.3 desc => 'Wearing an amulet, the object\'s stats will directly be inherited to the player. Amulets are usually meant for protection and defense.',
716 root 1.5 name => 'Amulet',
717 root 1.4 section => [
718     [
719     'resistance',
720 root 1.7 [
721     [
722     'resist_physical',
723     {
724     desc => 'This adds physical resistance to the item (= armour value). The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
725     name => 'resist physical %',
726     type => 'int'
727     }
728     ],
729     [
730     'resist_magic',
731     {
732     desc => 'This adds magic resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
733     name => 'resist magic %',
734     type => 'int'
735     }
736     ],
737     [
738     'resist_fire',
739     {
740     desc => 'This adds fire resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
741     name => 'resist fire %',
742     type => 'int'
743     }
744     ],
745     [
746     'resist_electricity',
747     {
748     desc => 'This adds electricity resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
749     name => 'resist electricity %',
750     type => 'int'
751     }
752     ],
753     [
754     'resist_cold',
755     {
756     desc => 'This adds fire resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
757     name => 'resist cold %',
758     type => 'int'
759     }
760     ],
761     [
762     'resist_confusion',
763     {
764     desc => 'This adds confusion resistance to the item. The number is a percent-value in the range 0-100. Confusion resistance is not very effective unless the value comes close to 100 (= perfect immunity).',
765     name => 'resist confusion %',
766     type => 'int'
767     }
768     ],
769     [
770     'resist_acid',
771     {
772     desc => 'This adds acid resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
773     name => 'resist acid %',
774     type => 'int'
775     }
776     ],
777     [
778     'resist_drain',
779     {
780     desc => 'This adds draining resistance to the item. The number is a percent-value in the range 0-100. Draining resistance is little effective unless the value is 100 (= perfect immunity).',
781     name => 'resist draining %',
782     type => 'int'
783     }
784     ],
785     [
786     'resist_weaponmagic',
787     {
788     desc => 'This adds weaponmagic resistance to the item. The number is a percent-value in the range 0-100. Weaponmagic resistance generally should not exist on equipment at all. Spells/Monsters doing weaponmagic damage (e.g. comet spell) are not meant to be easily resisted.',
789     name => 'resist weaponmagic %',
790     type => 'int'
791     }
792     ],
793     [
794     'resist_ghosthit',
795     {
796     desc => 'This adds ghosthit resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
797     name => 'resist ghosthit %',
798     type => 'int'
799     }
800     ],
801     [
802     'resist_poison',
803     {
804     desc => 'This adds poison resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
805     name => 'resist poison %',
806     type => 'int'
807     }
808     ],
809     [
810     'resist_slow',
811     {
812     desc => 'This adds fear resistance to the item. The number is a percent-value in the range 0-100. Resistance to fear is pretty useless.',
813     name => 'resist slow %',
814     type => 'int'
815     }
816     ],
817     [
818     'resist_paralyze',
819     {
820     desc => 'This adds paralyze resistance to the item. The number is a percent-value in the range 0-100. Paralyze resistance is little effective unless the value is 100 (= perfect immunity).',
821     name => 'resist paralyze %',
822     type => 'int'
823     }
824     ],
825     [
826     'resist_fear',
827     {
828     desc => 'This adds fear resistance to the item. The number is a percent-value in the range 0-100. Resistance to fear is pretty useless.',
829     name => 'resist fear %',
830     type => 'int'
831     }
832     ],
833     [
834     'resist_deplete',
835     {
836     desc => 'This adds depletion resistance to the item. The number is a percent-value in the range 0-100. Depletion resistance is little effective unless the value is 100 (= perfect immunity).',
837     name => 'resist depletion %',
838     type => 'int'
839     }
840     ],
841     [
842     'resist_death',
843     {
844     desc => 'This adds death-attack resistance to the item. The number is a percent-value in the range 0-100. Death-attack resistance is little effective unless the value is 100 (= perfect immunity). Generally, resistance to death-attack is not supposed to be available to players!',
845     name => 'resist death-attack %',
846     type => 'int'
847     }
848     ],
849     [
850     'resist_chaos',
851     {
852     desc => 'This adds chaos resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact. Note that chaos is not a stand-alone attacktype. Chaos "contains" a combination of other attacktypes.',
853     name => 'resist chaos %',
854     type => 'int'
855     }
856     ],
857     [
858     'resist_blind',
859     {
860     desc => 'This adds blinding resistance to the item. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
861     name => 'resist blinding %',
862     type => 'int'
863     }
864     ],
865     [
866     'resist_holyword',
867     {
868     desc => 'This adds holy power resistance to the item. The number is a percent-value in the range 0-100. Holy power is the attacktype that holyword-type spells use to hurt undead creatures. This kind of resistance is only reasonable for undead players (wraith or devourer cult). Generally, resistance to holy word should not be available for players.',
869     name => 'resist holy power %',
870     type => 'int'
871     }
872     ]
873     ]
874     ],
875     [
876     'stats',
877     [
878     [
879     'Str',
880     {
881     desc => 'The player\'s strentgh will rise/fall by the given value while wearing this piece of equipment.',
882     name => 'strength',
883     type => 'int'
884     }
885     ],
886     [
887     'Dex',
888     {
889     desc => 'The player\'s dexterity will rise/fall by the given value while wearing this piece of equipment.',
890     name => 'dexterity',
891     type => 'int'
892     }
893     ],
894     [
895     'Con',
896     {
897     desc => 'The player\'s constitution will rise/fall by the given value while wearing this piece of equipment.',
898     name => 'constitution',
899     type => 'int'
900     }
901     ],
902     [
903     'Int',
904     {
905     desc => 'The player\'s intelligence will rise/fall by the given value while wearing this piece of equipment.',
906     name => 'intelligence',
907     type => 'int'
908     }
909     ],
910     [
911     'Pow',
912     {
913     desc => 'The player\'s power will rise/fall by the given value while wearing this piece of equipment.',
914     name => 'power',
915     type => 'int'
916     }
917     ],
918     [
919     'Wis',
920     {
921     desc => 'The player\'s wisdom will rise/fall by the given value while wearing this piece of equipment.',
922     name => 'wisdom',
923     type => 'int'
924     }
925     ],
926     [
927     'Cha',
928     {
929     desc => 'The player\'s charisma will rise/fall by the given value while wearing this piece of equipment.',
930     name => 'charisma',
931     type => 'int'
932     }
933     ]
934     ]
935     ],
936     [
937     'misc',
938     [
939     [
940     'luck',
941     {
942     desc => 'With positive luck bonus, the player is more likely to succeed in all sorts of things (spellcasting, praying,...). Unless the <luck bonus> is very high, the effect will be barely visible in-game. Luck bonus on one piece of equipment should never exceed 3, and such bonus should not be too frequently available.',
943     name => 'luck bonus',
944     type => 'int'
945     }
946     ],
947     [
948     'hp',
949     {
950     desc => 'Positive <health regen.> bonus speeds up the player\'s healing process. Negative values slow it down.',
951     name => 'health regen.',
952     type => 'int'
953     }
954     ],
955     [
956     'sp',
957     {
958     desc => 'Positive <mana regen.> bonus speeds up the player\'s mana regeneration. Negative values slow it down.',
959     name => 'mana regen.',
960     type => 'int'
961     }
962     ],
963     [
964     'grace',
965     {
966     desc => 'Positive <grace regen.> bonus speeds up the player\'s grace regeneration. Negative values slow it down. Since grace can be regenerated rather easy with praying, additional <grace regen.> bonus should be VERY RARE!!',
967     name => 'grace regen.',
968     type => 'int'
969     }
970     ],
971     [
972     'food',
973     {
974     desc => 'Positive <food bonus> slows down the player\'s digestion, thus he consumes less food. Negative values speed it up. Note that food is consumed not only for "being alive", but also for healing and mana-regeneration. <food bonus> only affects the amount of food consumed for "being alive". Hence, even with high <food bonus>, during a fight a player can run out of food quickly.',
975     name => 'food bonus',
976     type => 'int'
977     }
978     ],
979     [
980     'xrays',
981     {
982 root 1.9 desc => 'Xray vision allows the player to see through obstacles in a two-square-wide radius. This is extremely helpful and desirable, so don\'t give it away for cheap on equipment.',
983 root 1.7 name => 'xray vision',
984     type => 'bool'
985     }
986     ],
987     [
988     'stealth',
989     {
990     desc => 'Stealth allows the player to move silently. This comes to effect if a player turns himself invisible and tries to sneak around monsters. (At least that was the idea behind it)',
991     name => 'stealth',
992     type => 'bool'
993     }
994     ],
995     [
996     'reflect_spell',
997     {
998     desc => 'If a player is wearing any piece of equipment with the ability to <reflect spells>, all kinds of spell-bullets and -beams will bounce off him. This works only about 90% of all times, to avoid players being completely immune to certain types of attacks. This is a very powerful ability and it shouldn\'t be handed out cheap!',
999     name => 'reflect spells',
1000     type => 'bool'
1001     }
1002     ],
1003     [
1004     'reflect_missile',
1005     {
1006     desc => 'If a player is wearing any piece of equipment with the ability to <reflect missiles>, all kinds of projectiles (e.g. arrows, bolts, boulders) will bounce off him. This works only about 90% of all times, to avoid players being completely immune to certain types of attacks.',
1007     name => 'reflect missiles',
1008     type => 'bool'
1009     }
1010     ],
1011     [
1012 root 1.14 'move_type',
1013 root 1.7 {
1014 root 1.14 desc => 'Determines which kinds of movement this object can use (e.g. for monsters) or grants (e.g. for amulets).',
1015     name => 'movement type',
1016     type => 'bitmask',
1017     value => $BITMASK{movement_type}
1018 root 1.7 }
1019     ],
1020     [
1021     'path_attuned',
1022     {
1023     desc => 'Click on the <attuned paths> button to select spellpaths. The player will get attuned to the specified spellpaths while wearing this item.',
1024     name => 'attuned paths',
1025     type => 'bitmask',
1026     value => $BITMASK{spellpath}
1027     }
1028     ],
1029     [
1030     'path_repelled',
1031     {
1032     desc => 'Click on the <repelled paths> button to select spellpaths. The player will get repelled to the specified spellpaths while wearing this item.',
1033     name => 'repelled paths',
1034     type => 'bitmask',
1035     value => $BITMASK{spellpath}
1036     }
1037     ],
1038     [
1039     'path_denied',
1040     {
1041     desc => 'Click on the <denied paths> button to select spellpaths. The specified spellpaths will be denied to the player while wearing this item.',
1042     name => 'denied paths',
1043     type => 'bitmask',
1044     value => $BITMASK{spellpath}
1045     }
1046     ]
1047     ]
1048     ]
1049     ],
1050     use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
1051     },
1052     Battleground => {
1053     attr => [
1054     [
1055     'no_pick',
1056     {
1057     type => 'fixed',
1058     value => 1
1059     }
1060     ],
1061     [
1062     'is_floor',
1063 root 1.4 {
1064 root 1.7 type => 'fixed',
1065     value => 1
1066 root 1.4 }
1067     ],
1068     [
1069 root 1.7 'hp',
1070 root 1.4 {
1071 root 1.7 desc => 'The exit destinations define the (x, y)-coordinates where players get teleported after they died on this battleground.',
1072     name => 'destination X',
1073     type => 'int'
1074 root 1.4 }
1075     ],
1076     [
1077 root 1.7 'sp',
1078 root 1.4 {
1079 root 1.7 desc => 'The exit destinations define the (x, y)-coordinates where players get teleported after they died on this battleground.',
1080     name => 'destination Y',
1081     type => 'int'
1082 root 1.4 }
1083     ]
1084     ],
1085 root 1.3 desc => 'Battleground is very special: In short, players can die on battleground without any death penalties. They don\'t loose or gain experience while on battleground. Acid, draining and depletion effects don\'t work either. When a player dies on battleground, he gets teleported to an exit location which is defined in the battleground object.',
1086     ignore => [
1087     $IGNORE_LIST{non_pickable}
1088     ],
1089 root 1.5 name => 'Battleground',
1090 root 1.3 use => 'Battleground is only meant for player vs. player duels. You can design combat arenas similiar to the one in scorn.<br> What should NEVER be done is placing battleground tiles in open dungeons or other free kinds of land. It must not be possible to gain significant treasure for fighting on battleground, because it bears no risk.<br><br> (Battleground will cease to work when the image or name is changed, or when it is placed beneath another floor tile. This is not a bug, it is there to prevent any attempts of placing "hidden" battleground tiles anywhere.)'
1091     },
1092     Book => {
1093 root 1.7 attr => [
1094     [
1095     'level',
1096     {
1097     desc => 'If this value is set to be greater than zero, the player needs a certain literacy level to succeed reading the book. The book can be read if: mental_level greater <literacy level> - 5. Adding level to a book can be a nice idea, personally I like it when a player needs more than his fighting skills to solve a quest. However, keep the booklevel at least below 15 because it is quite hard to gain high mental levels.',
1098     name => 'literacy level',
1099     type => 'int'
1100     }
1101     ],
1102     [
1103     'startequip',
1104     {
1105     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
1106     name => 'godgiven item',
1107     type => 'bool'
1108     }
1109     ],
1110     [
1111     'unique',
1112     {
1113     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
1114     name => 'unique item',
1115     type => 'bool'
1116     }
1117     ],
1118     [
1119     'msg',
1120     {
1121     desc => 'This is the text that appears "written" in the book.',
1122     end => 'endmsg',
1123     name => 'book content',
1124     type => 'text'
1125     }
1126 root 1.14 ],
1127     [
1128     'slaying',
1129     {
1130     desc => 'This is the key string of the book. The key string is checked by an inventory checker. (This is used eg. for the gate/port passes in scorn)',
1131     name => 'key string',
1132     type => 'string'
1133     }
1134 root 1.7 ]
1135     ],
1136 root 1.5 desc => 'Applying a book, the containing message is displayed to the player.',
1137     name => 'Book'
1138 root 1.1 },
1139 root 1.3 Boots => {
1140 root 1.7 attr => [
1141     [
1142     'exp',
1143     {
1144     desc => 'Boots with <speed bonus> will increase the player\'s walking speed while worn. This kind of bonus is quite desirable for players of low- and medium level. High level players usually have fastest possible walking speed and thus don\'t need <speed bonus> anymore. Still, this bonus is good for nice artifacts - not everything has to be for highest level.',
1145     name => 'speed bonus',
1146     type => 'int'
1147     }
1148     ],
1149     [
1150     'magic',
1151     {
1152     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the boots. Important: <magic bonus> on boots has no effect if there is no <armour class> set. It only works in combination with <armour class>.',
1153     name => 'magic bonus',
1154     type => 'int'
1155     }
1156     ]
1157     ],
1158 root 1.3 desc => 'Wearing boots, the object\'s stats will directly be inherited to the player. Usually enhancing his speed, or granting some minor protection bonus.',
1159     import => [
1160     $TYPE{Amulet}
1161     ],
1162 root 1.5 name => 'Boots',
1163 root 1.3 use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
1164     },
1165     Bracers => {
1166 root 1.7 attr => [
1167     [
1168     'magic',
1169     {
1170     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the bracers.',
1171     name => 'magic bonus',
1172     type => 'int'
1173     }
1174     ]
1175     ],
1176 root 1.3 desc => 'Bracers are armour-plates worn around the wrists. Wearing bracer, the object\'s stats will directly be inherited to the player. Usually enhancing his defense.',
1177     import => [
1178     $TYPE{Amulet}
1179     ],
1180 root 1.5 name => 'Bracers',
1181 root 1.3 use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
1182     },
1183     'Brestplate Armour' => {
1184 root 1.7 attr => [
1185     [
1186     'last_heal',
1187     {
1188     desc => 'This poses a penalty to spell regeneration speed, for wearing the armour. The bigger the spellpoint penalty, the worse.',
1189     name => 'spellpoint penalty',
1190     type => 'int'
1191     }
1192     ],
1193     [
1194     'last_sp',
1195     {
1196     desc => 'Slowdown penalty reduces the player\'s walking speed when wearing the armour. Bigger values are worse - zero is best.',
1197     name => 'slowdown penalty',
1198     type => 'int'
1199     }
1200     ],
1201     [
1202     'magic',
1203     {
1204     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the armour.',
1205     name => 'magic bonus',
1206     type => 'int'
1207     }
1208     ]
1209     ],
1210 root 1.3 desc => 'Wearing an armour, the object\'s stats will directly be inherited to the player. Usually enhancing his defense.',
1211 root 1.7 import => [
1212     $TYPE{Amulet}
1213     ],
1214     name => 'Brestplate Armour',
1215     use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
1216     },
1217     Button => {
1218     attr => [
1219     [
1220 root 1.14 'move_on',
1221 root 1.7 {
1222 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
1223     name => 'movement type',
1224     type => 'bitmask',
1225     value => $BITMASK{movement_type}
1226 root 1.7 }
1227     ],
1228     [
1229 root 1.14 'move_off',
1230 root 1.7 {
1231 root 1.14 desc => 'Which movement types deactivate this object (e.g. button).',
1232     name => 'movement type',
1233     type => 'bitmask',
1234     value => $BITMASK{movement_type}
1235 root 1.7 }
1236     ],
1237     [
1238     'no_pick',
1239     {
1240     type => 'fixed',
1241     value => 1
1242     }
1243     ],
1244     [
1245     'weight',
1246     {
1247     desc => 'The button is pressed (triggered), as soon as <press weigh> gram are placed ontop of it.',
1248     name => 'press weight',
1249 root 1.9 type => 'int'
1250 root 1.7 }
1251     ],
1252     [
1253     'connected',
1254     {
1255     desc => 'Every time the button is pressed or released, all objects with the same <connection> value are activated.',
1256     name => 'connection',
1257     type => 'int'
1258     }
1259     ],
1260     [
1261     'msg',
1262     {
1263     desc => 'This text may describe the item. You can use this message to explain the button\'s purpose to the player.',
1264     end => 'endmsg',
1265     name => 'description',
1266     type => 'text'
1267     }
1268     ]
1269 root 1.3 ],
1270     desc => 'When a predefined amount of weigh is placed on a button, the &lt;connection&gt; value is triggered. In most cases this happens when a player or monster steps on it. When the button is "released", the &lt;connection&gt; value get\'s triggered a second time.',
1271     ignore => [
1272     $IGNORE_LIST{non_pickable}
1273 root 1.5 ],
1274     name => 'Button'
1275 root 1.3 },
1276 root 1.9 'Button Trigger' => {
1277     desc => 'Handle buttons are buttons which reset after a short period of time. Every time it is either applied or reset, the &lt;connection&gt; value is triggered.',
1278     ignore => [
1279     $IGNORE_LIST{non_pickable}
1280     ],
1281     import => [
1282     $TYPE{Button}
1283     ],
1284     name => 'Button Trigger'
1285     },
1286     'Class Changer' => {
1287     attr => [
1288     [
1289     'randomitems',
1290     {
1291     desc => 'This entry determines which initial items the character receives.',
1292     name => 'class items',
1293     type => 'treasurelist'
1294     }
1295     ]
1296     ],
1297     desc => 'Class changer are used while creating a character.',
1298     ignore => [
1299     $IGNORE_LIST{non_pickable}
1300     ],
1301     name => 'Class Changer',
1302     section => [
1303     [
1304     'stats',
1305     [
1306     [
1307     'Str',
1308     {
1309     desc => 'The player\'s strength will rise by the given value if he chooses this class. (Negative values make strength fall)',
1310     name => 'strength',
1311     type => 'int'
1312     }
1313     ],
1314     [
1315     'Dex',
1316     {
1317     desc => 'The player\'s dexterity will rise by the given value if he chooses this class. (Negative values make dexterity fall)',
1318     name => 'dexterity',
1319     type => 'int'
1320     }
1321     ],
1322     [
1323     'Con',
1324     {
1325     desc => 'The player\'s constitution will rise by the given value if he chooses this class. (Negative values make constitution fall)',
1326     name => 'constitution',
1327     type => 'int'
1328     }
1329     ],
1330     [
1331     'Int',
1332     {
1333     desc => 'The player\'s intelligence will rise by the given value if he chooses this class. (Negative values make intelligence fall)',
1334     name => 'intelligence',
1335     type => 'int'
1336     }
1337     ],
1338     [
1339     'Pow',
1340     {
1341     desc => 'The player\'s power will rise by the given value if he chooses this class. (Negative values make power fall)',
1342     name => 'power',
1343     type => 'int'
1344     }
1345     ],
1346     [
1347     'Wis',
1348     {
1349     desc => 'The player\'s wisdom will rise by the given value if he chooses this class. (Negative values make wisdom fall)',
1350     name => 'wisdom',
1351     type => 'int'
1352     }
1353     ],
1354     [
1355     'Cha',
1356     {
1357     desc => 'The player\'s charisma will rise by the given value if he chooses this class. (Negative values make charisma fall)',
1358     name => 'charisma',
1359     type => 'int'
1360     }
1361     ]
1362     ]
1363     ]
1364     ]
1365     },
1366 root 1.3 Cloak => {
1367 root 1.7 attr => [
1368     [
1369     'magic',
1370     {
1371     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the cloak. Important: <magic bonus> on cloaks has no effect if there is no <armour class> set. It only works in combination with <armour class>.',
1372     name => 'magic bonus',
1373     type => 'int'
1374     }
1375     ]
1376     ],
1377 root 1.3 desc => 'Wearing a cloak, the object\'s stats will directly be inherited to the player. Cloaks usually add minor &lt;armour class&gt; and sometimes a bit of resistance.',
1378     import => [
1379     $TYPE{Amulet}
1380     ],
1381 root 1.5 name => 'Cloak',
1382 root 1.3 use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
1383     },
1384     Clock => {
1385 root 1.7 attr => [
1386     [
1387     'msg',
1388     {
1389     desc => 'This text may describe the item',
1390     end => 'endmsg',
1391     name => 'description',
1392     type => 'text'
1393     }
1394     ]
1395     ],
1396 root 1.5 desc => 'Applying a clock, the time is displayed to the player.',
1397     name => 'Clock'
1398 root 1.1 },
1399 root 1.3 Container => {
1400 root 1.7 attr => [
1401     [
1402     'race',
1403     {
1404     desc => 'If set, the container will hold only certain types of objects. Possible choices for <container class> are: "gold and jewels", "arrows" and "keys". Unfortunately it is not easy to create new container classes, because items need a matching counterpiece-attribute to the <container class> before they can be put inside a container. This attribute ("race") is set only for the existing container classes.',
1405     name => 'container class',
1406     type => 'string'
1407     }
1408     ],
1409     [
1410     'slaying',
1411     {
1412     desc => 'If <key string> is set, only players with a special key of matching <key string> are able to open the container.',
1413     name => 'key string',
1414     type => 'string'
1415     }
1416     ],
1417     [
1418     'container',
1419     {
1420     desc => 'The container can hold a maximum total weight of the given value in gram. Note that this weight limit is calculated *after* the weight reduction (<reduce weight>) has been applied.',
1421     name => 'maximum weight',
1422     type => 'int'
1423     }
1424     ],
1425     [
1426     'Str',
1427     {
1428     desc => 'This value determines how much the weight of items is reduced in percent, when put inside the container. <reduce weight %> 0 means no reduction, <reduce weight %> 100 means items are weightless inside. Most default values are in the range of ten.',
1429     name => 'reduce weight %',
1430     type => 'int'
1431     }
1432     ],
1433     [
1434     'is_cauldron',
1435     {
1436     desc => 'If set, the container can be used as alchemy-cauldron. The player can put ingredients inside, close it, cast alchemy and if his formulae is true, he\'ll get what he longed for.',
1437     name => 'alchemy cauldron',
1438     type => 'bool'
1439     }
1440     ],
1441     [
1442     'unique',
1443     {
1444     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good. All contents of a unique container are unique as well.',
1445     name => 'unique item',
1446     type => 'bool'
1447     }
1448     ],
1449     [
1450     'startequip',
1451     {
1452     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
1453     name => 'godgiven item',
1454     type => 'bool'
1455     }
1456     ],
1457     [
1458     'other_arch',
1459     {
1460     desc => 'This is used for a certain kind of... "animation" when opening the container. Stick to the default arches here and you won\'t get into trouble.',
1461     name => 'animation arch',
1462     type => 'string'
1463     }
1464     ],
1465     [
1466     'msg',
1467     {
1468     desc => 'This text may contain a description of the container.',
1469     end => 'endmsg',
1470     name => 'description',
1471     type => 'text'
1472     }
1473     ]
1474     ],
1475 root 1.3 desc => 'A player can put (certain kinds of) items in the container. The overall weight of items is reduced when put inside a container, depending on the settings. <br><br> A special feature of containers is the "cauldron", capable of mixing alchemical receipes.',
1476 root 1.5 name => 'Container',
1477 root 1.3 use => 'Note on chests - There are two types of chests: <UL> <LI> First the random treasure chests - Those are NOT containers (but object type Treasure), they create random treasures when applied. Archetype name is "chest". <LI> Second there are the permanent chests - Those are containers, they can be opened and closed again. Archetype name is "chest_2". </UL>'
1478     },
1479     Converter => {
1480 root 1.7 attr => [
1481     [
1482     'no_pick',
1483     {
1484     type => 'fixed',
1485     value => 1
1486     }
1487     ],
1488     [
1489     'slaying',
1490     {
1491     desc => '<cost arch> is the name of the archetype the player has to put on the converter, as payment.',
1492     name => 'cost arch',
1493     type => 'string'
1494     }
1495     ],
1496     [
1497     'food',
1498     {
1499     desc => 'The player has to put <cost number> items of <cost arch> on the converter, in order to get <receive number> items of <receive arch>.',
1500     name => 'cost number',
1501     type => 'int'
1502     }
1503     ],
1504     [
1505     'other_arch',
1506     {
1507 root 1.8 desc => '<receive arch> is the name of the archetype to convert into. This field is ignored if the converter has items in inventory. In this case one of the inventory items is duplicated. The duplicated item is randomly chosen from all items present.',
1508 root 1.7 name => 'receive arch',
1509     type => 'string'
1510     }
1511     ],
1512     [
1513     'sp',
1514     {
1515     desc => 'The player has to put <cost number> items of <cost arch> on the converter, in order to get <receive number> items of <receive arch>.',
1516     name => 'receive number',
1517     type => 'int'
1518     }
1519     ],
1520     [
1521     'msg',
1522     {
1523     desc => 'This text may contain a description of the converter.',
1524     end => 'endmsg',
1525     name => 'description',
1526     type => 'text'
1527     }
1528     ]
1529     ],
1530 root 1.3 desc => 'Converters are like "exchange tables". When the player drops a specific type of items, they get converted into other items, at a predefined exchange-ratio.',
1531     ignore => [
1532     'value',
1533     'nrof',
1534     'name_pl',
1535     'no_pick',
1536     'unpaid',
1537     'title'
1538     ],
1539 root 1.5 name => 'Converter',
1540 root 1.3 use => 'Converters are better than shopping with doormats, because the converters never get sold out. For some items like food or jewels those "exchange tables" are really nice, while for the more important stuff like potions converters should not exist. <br><br> VERY IMPORTANT: Be careful with the exchange-ratio! When you drop items on a converter, the stuff you get must be of equal or lesser value than before! (Except if you are using "rare" items like dragonscales for payment). The code will not check if your ratio is sane, so the player could gain infinite wealth by using your converter.'
1541     },
1542     Creator => {
1543 root 1.7 attr => [
1544     [
1545     'no_pick',
1546     {
1547     type => 'fixed',
1548     value => 1
1549     }
1550     ],
1551     [
1552     'other_arch',
1553     {
1554 root 1.8 desc => 'This string defines the object that will be created. You can choose any of the existing arches. This field is ignored if the creator has items in inventory. In this case one of the inventory items is duplicated. The duplicated item is randomly chosen from all items present.',
1555 root 1.7 name => 'create arch',
1556     type => 'string'
1557     }
1558     ],
1559     [
1560     'connected',
1561     {
1562     desc => 'Whenever the connection value is activated, the creator gets triggered.',
1563     name => 'connection',
1564     type => 'int'
1565     }
1566     ],
1567     [
1568 elmex 1.21 'activate_on_push',
1569     {
1570     desc => 'Whether the teleporter should only be activated on push.',
1571     name => 'Activate on push',
1572     type => 'bool'
1573     }
1574     ],
1575     [
1576     'activate_on_release',
1577     {
1578     desc => 'Whether the teleporter should only be activated on release.',
1579     name => 'Activate on release',
1580     type => 'bool'
1581     }
1582     ],
1583     [
1584 root 1.7 'lifesave',
1585     {
1586 root 1.9 desc => 'If <infinit uses> is set, the creator will work infinitely, regardless of the value in <number of uses>.',
1587 root 1.7 name => 'infinit uses',
1588     type => 'bool'
1589     }
1590     ],
1591     [
1592 elmex 1.25 'speed',
1593     {
1594     desc => 'When this field is set the creator will periodically create stuff (and will still do so when the connection is triggered). A value of 1 means roughly 8 times a second.',
1595     name => 'speed',
1596     type => 'float'
1597     }
1598     ],
1599     [
1600 root 1.7 'hp',
1601     {
1602     desc => 'The creator can be triggered <number of uses> times, thus creating that many objects, before it dissappears. Default is <number of uses> 1 (-> one-time usage).',
1603     name => 'number of uses',
1604     type => 'int'
1605     }
1606     ],
1607     [
1608     'slaying',
1609     {
1610 root 1.8 desc => 'The created object will bear the name and title specified in <name of creation>. If nothing is set, the standard name and title of the archetype is used.',
1611 root 1.7 name => 'name of creation',
1612     type => 'string'
1613     }
1614     ],
1615     [
1616     'level',
1617     {
1618     desc => 'The created object will be of that level. If zero/unset, the standard level of the archetype is used.',
1619     name => 'level of creation',
1620     type => 'int'
1621     }
1622     ]
1623     ],
1624 elmex 1.25 desc => 'A creator is an object which creates another object when it is triggered. The child object can be anything. Creators are VERY useful for all kinds of map-mechanisms. They can even periodically create things.',
1625 root 1.3 ignore => [
1626     $IGNORE_LIST{system_object}
1627     ],
1628 root 1.5 name => 'Creator',
1629 root 1.3 use => 'Don\'t hesitate to hide your creators under the floor. The created items will still always appear ontop of the floor.'
1630     },
1631     Detector => {
1632 root 1.7 attr => [
1633     [
1634     'no_pick',
1635     {
1636     type => 'fixed',
1637     value => 1
1638     }
1639     ],
1640     [
1641     'slaying',
1642     {
1643     desc => '<match name> specifies the name of the object we are looking for. Actually it does also check for the <key string> in key-objects, but for this case inventory checkers are often more powerful to use.',
1644     name => 'match name',
1645     type => 'string'
1646     }
1647     ],
1648     [
1649     'connected',
1650     {
1651     desc => 'When the detector is triggered, all objects with the same connection value get activated.',
1652     name => 'connection',
1653     type => 'int'
1654     }
1655     ],
1656     [
1657     'speed',
1658     {
1659     desc => 'This value defines the time between two detector-checks. If you want the detector to behave almost like pedestals/buttons, set speed rather high, like <detection speed> 1.0.',
1660     name => 'detection speed',
1661     type => 'float'
1662     }
1663 root 1.17 ],
1664     [
1665     'speed_left',
1666     {
1667     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
1668     name => 'speed left',
1669     type => 'float'
1670     }
1671     ],
1672     [
1673     'speed_left',
1674     {
1675     desc => 'The speed left. This value is incremented by <speed> on every tick. If it is larger than 0, the detector checks, and the speed is decremented by 1.',
1676     name => 'speed left',
1677     type => 'float'
1678     }
1679 root 1.7 ]
1680     ],
1681 root 1.3 desc => 'Detectors work quite much like inv. checkers/pedestals: If the detector finds a specific object, it toggles its connected value. <br><br> What is "unique" about them, compared to inv. checkers/ pedestals? - First, detectors check their square for a match periodically, not instantly. Second, detectors check directly for object names. Third, detectors do not check the inventory of players/monsters.',
1682     ignore => [
1683     $IGNORE_LIST{system_object}
1684     ],
1685 root 1.5 name => 'Detector',
1686 root 1.3 use => 'There is one major speciality about detectors: You can detect spells blown over a detector! To detect a lighting bolt for example, set "slaying ligthing" and "speed 1.0". In combination with spellcasting walls, this can be very useful for map-mechanisms.'
1687     },
1688     Director => {
1689 root 1.7 attr => [
1690     [
1691     'sp',
1692     {
1693     desc => 'Projectiles will leave the director flying in the selected <direction>. A director with direction <none> simply stops projectiles. (The latter works out a bit strange for some spells).',
1694     name => 'direction',
1695     type => 'list',
1696     value => $LIST{direction}
1697     }
1698     ],
1699     [
1700 root 1.14 'move_on',
1701 root 1.7 {
1702 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
1703     name => 'movement type',
1704     type => 'bitmask',
1705     value => $BITMASK{movement_type}
1706 root 1.7 }
1707     ]
1708     ],
1709 root 1.3 desc => 'Directors change the direction of spell objects and other projectiles that fly past. Unlike spinners, directors always move objects in the same direction. It does not make a difference from what angle you shoot into it.<br> Directors are visible per default.',
1710     ignore => [
1711     $IGNORE_LIST{non_pickable}
1712     ],
1713 root 1.5 name => 'Director',
1714 root 1.3 use => 'Directors are rarely used in maps. Sometimes they are placed to change the direction of spells coming out of magic walls, "channeling" spell-projectiles in some direction. When doing this, <B>never place directors facing each other with magic walls fireing into them!</B> The spell-projectiles bouncing between the directors would accumulate to huge numbers and at some point slow down the server by eating memory- and CPU-time. <br><br> You\'d better not place directors in monster vs. player combat areas too much, because that freaks out wizard-type players.'
1715     },
1716     Disease => {
1717 root 1.7 attr => [
1718     [
1719     'invisible',
1720     {
1721     type => 'fixed',
1722     value => 1
1723     }
1724     ],
1725     [
1726     'level',
1727     {
1728     desc => 'The <plaque level> is proportional to the disease\'s deadliness. This mainly reflects in the <damage>. It has no effect on most other symptoms. Neverthless, it is a very important value for all damage-inflicting diseases.',
1729     name => 'plaque level',
1730     type => 'int'
1731     }
1732     ],
1733     [
1734     'race',
1735     {
1736     desc => 'The disease will only infect creatures of the specified <race>. "<race> *" means every creature can be infected.',
1737     name => 'infect race',
1738     type => 'string'
1739     }
1740     ],
1741     [
1742     'ac',
1743     {
1744     desc => 'Every time the disease "moves" the severity of the symptoms are increased by <progressiveness>/100. (severity = 1 + (accumlated progression)/100)',
1745     name => 'progressiveness',
1746     type => 'int'
1747     }
1748     ],
1749     [
1750     'msg',
1751     {
1752     desc => 'This text is displayed to the player every time the symptoms strike.',
1753     end => 'endmsg',
1754     name => 'message',
1755     type => 'text'
1756     }
1757     ]
1758     ],
1759 root 1.3 desc => 'Diseases are an intersting form of spellcraft in Crossfire. Once casted, they can spread out and infect creatures in a large area. Being infected can have various effects, from amusing farts to horrible damage - almost everything is possible.',
1760     ignore => [
1761     $IGNORE_LIST{system_object}
1762     ],
1763 root 1.5 name => 'Disease',
1764 root 1.4 section => [
1765     [
1766     'spreading',
1767 root 1.7 [
1768     [
1769     'wc',
1770     {
1771     desc => 'The <infectiosness> defines the chance of new creatures getting infected. If you set this too high, the disease is very likely to be too effective. <infectiosness>/127 is the chance of someone in range catching it.',
1772     name => 'infectiosness',
1773     type => 'int'
1774     }
1775     ],
1776     [
1777     'last_grace',
1778     {
1779     desc => 'The <attenuation> value reduces the diseases\' <infectiosness> everytime it infects someone new. This limits how many generations a disease can propagate.',
1780     name => 'attenuation',
1781     type => 'int'
1782     }
1783     ],
1784     [
1785     'magic',
1786     {
1787     desc => '<infection range> sets the range at which infection may occur. If positive, the <infection range> is level dependant - If negative, it is not: E.g. "<infection range> -6" means creatures can be infected in six square range, and <plaque level> doesn\'t modify that.',
1788     name => 'infection range',
1789     type => 'int'
1790     }
1791     ],
1792     [
1793     'maxhp',
1794     {
1795     desc => '<persistence> defines how long the disease can persist OUTSIDE a host. The disease can "move" <persistence> times outside a host before it vanishes. A negative value means the disease lasts for permanent (which is only recommended to use in maps without monsters).',
1796     name => 'persistence',
1797     type => 'int'
1798     }
1799     ],
1800     [
1801     'maxgrace',
1802     {
1803     desc => 'The disease will last in the host for <curing duration> "disease moves" (Assuming the host survives and doesn\'t use a curing spell). After this period the disease is naturally cured, which provides the host with immunity from this particular disease of lower or equal level. A negative value means the disease can never be cured naturally. Note that this value can be further modulated by spell-parameters, if the disease is registered as spell in the code. Due to that, most default diseases take a lot longer to cure than it seems.',
1804     name => 'curing duration',
1805     type => 'int'
1806     }
1807     ],
1808     [
1809     'speed',
1810     {
1811     desc => 'The <speed> of the disease determines how fast the disease will "move", thus how fast the symptoms strike the host.',
1812     name => 'moving speed',
1813     type => 'float'
1814     }
1815 root 1.17 ],
1816     [
1817     'speed_left',
1818     {
1819     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
1820     name => 'speed left',
1821     type => 'float'
1822     }
1823 root 1.7 ]
1824     ]
1825     ],
1826     [
1827     'symptoms',
1828     [
1829     [
1830     'attacktype',
1831     {
1832     desc => 'The disease will attack the host with the given <attacktype>. Godpower attacktype is commonly used for "unresistable" diseases.',
1833     name => 'attacktype',
1834     type => 'bitmask',
1835     value => $BITMASK{attacktype}
1836     }
1837     ],
1838     [
1839     'dam',
1840     {
1841     desc => 'A disease with a positive <damage> value will strike the player for that amount of damage every time the symptoms occur. A negative <damage> value produces %-based damage: "<damage> -10" means the player\'s health is reduced by 10% every time the symptoms strike. Diseases with %-based damage can be dangerous - but not deadly - for players of all levels.',
1842     name => 'damage',
1843     type => 'int'
1844     }
1845     ],
1846     [
1847     'other_arch',
1848     {
1849     desc => 'If set, the specified arch is created and dropped every time the symptoms strike. This can be various things: farts, body pieces, eggs ... Even monsters can be created that way. You could also make a disease where some exotic stuff like money/gems is created.',
1850     name => 'create arch',
1851     type => 'string'
1852     }
1853     ],
1854     [
1855     'last_sp',
1856     {
1857     desc => 'If set, the disease imposes a <slowdown penalty> while being infected. The player\'s speed is reduced by <slowdown penalty> % of normal value.',
1858     name => 'slowdown penalty',
1859     type => 'int'
1860     }
1861     ],
1862     [
1863     'exp',
1864     {
1865     desc => 'When the player manages to cure this disease (with a curing spell), he is awarded with <exp. for curing> experience.',
1866     name => 'exp. for curing',
1867     type => 'int'
1868     }
1869     ],
1870     [
1871     'maxsp',
1872     {
1873     desc => 'Every time the disease "moves", the player\'s mana is reduced by the value of <mana depletion>. For negative values, a %-based amount is taken.',
1874     name => 'mana depletion',
1875     type => 'int'
1876     }
1877     ],
1878     [
1879     'last_eat',
1880     {
1881     desc => 'Every time the disease "moves", the player\'s food is reduced by the value of <food depletion>. For negative values, a %-based amount is taken.',
1882     name => 'food depletion',
1883     type => 'int'
1884     }
1885     ],
1886     [
1887     'hp',
1888     {
1889     desc => 'This value increases the player\'s healing rate. Negative values decrease it.',
1890     name => 'health regen.',
1891     type => 'int'
1892     }
1893     ],
1894     [
1895     'sp',
1896     {
1897     desc => 'This value increases the player\'s rate of mana regeneration. Negative values decrease it.',
1898     name => 'mana regen.',
1899     type => 'int'
1900     }
1901     ]
1902     ]
1903     ],
1904     [
1905     'disability',
1906     [
1907     [
1908     'Str',
1909     {
1910     desc => 'The player\'s strength will rise by the given value while being infected. (Negative values make strength fall)',
1911     name => 'strength',
1912     type => 'int'
1913     }
1914     ],
1915     [
1916     'Dex',
1917     {
1918     desc => 'The player\'s dexterity will rise by the given value while being infected. (Negative values make dexterity fall)',
1919     name => 'dexterity',
1920     type => 'int'
1921     }
1922     ],
1923     [
1924     'Con',
1925     {
1926     desc => 'The player\'s constitution will rise by the given value while being infected. (Negative values make constitution fall)',
1927     name => 'constitution',
1928     type => 'int'
1929     }
1930     ],
1931     [
1932     'Int',
1933     {
1934     desc => 'The player\'s intelligence will rise by the given value while being infected. (Negative values make intelligence fall)',
1935     name => 'intelligence',
1936     type => 'int'
1937     }
1938     ],
1939     [
1940     'Pow',
1941     {
1942     desc => 'The player\'s power will rise by the given value while being infected. (Negative values make power fall)',
1943     name => 'power',
1944     type => 'int'
1945     }
1946     ],
1947     [
1948     'Wis',
1949     {
1950     desc => 'The player\'s wisdom will rise by the given value while being infected. (Negative values make wisdom fall)',
1951     name => 'wisdom',
1952     type => 'int'
1953     }
1954     ],
1955     [
1956     'Cha',
1957     {
1958     desc => 'The player\'s charisma will rise by the given value while being infected. (Negative values make charisma fall)',
1959     name => 'charisma',
1960     type => 'int'
1961     }
1962     ]
1963     ]
1964     ]
1965     ],
1966     use => 'Diseases are extremely flexible and usable in a many ways. So far they are mostly used for causing bad, unwanted effects. You could just as well create a disease which helps the player (recharging mana for example). Infection with a "positive disease" could even be a quest reward.'
1967     },
1968 root 1.9 Door => {
1969     attr => [
1970     [
1971     'no_pick',
1972     {
1973     type => 'fixed',
1974     value => 1
1975     }
1976     ],
1977     [
1978     'alive',
1979     {
1980     type => 'fixed',
1981     value => 1
1982     }
1983     ],
1984     [
1985 root 1.14 'move_block',
1986 root 1.9 {
1987 root 1.14 desc => 'Objects using these movement types cannot move over this space.',
1988     name => 'blocked movement',
1989     type => 'bitmask',
1990     value => $BITMASK{movement_type}
1991     }
1992     ],
1993     [
1994     'move_allow',
1995     {
1996     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
1997     name => 'allowed movement',
1998     type => 'bitmask',
1999     value => $BITMASK{movement_type}
2000     }
2001     ],
2002     [
2003     'move_slow',
2004     {
2005     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
2006     name => 'slowed movement',
2007     type => 'bitmask',
2008     value => $BITMASK{movement_type}
2009     }
2010     ],
2011     [
2012     'move_slow_penalty',
2013     {
2014     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
2015     name => 'slow movement penalty',
2016     type => 'int'
2017 root 1.9 }
2018     ],
2019     [
2020     'hp',
2021     {
2022     desc => 'The more <hitpoints> the door has, the longer it takes to be broken.',
2023     name => 'hitpoints',
2024     type => 'int'
2025     }
2026     ],
2027     [
2028     'ac',
2029     {
2030     desc => 'Doors of high <armour class> are less likely to get hit. <armour class> can be considered the "counterpiece" to <weapon class>.',
2031     name => 'armour class',
2032     type => 'int'
2033     }
2034     ],
2035     [
2036     'other_arch',
2037     {
2038     desc => 'This string defines the object that will be created when the door was defeated.',
2039     name => 'drop arch',
2040     type => 'string'
2041     }
2042     ],
2043     [
2044     'randomitems',
2045     {
2046     desc => 'This entry determines what kind of traps will appear in the door.',
2047     name => 'treasurelist',
2048     type => 'treasurelist'
2049     }
2050     ]
2051     ],
2052     desc => 'A door can be opened with a normal key. It also can be broken by attacking it, and it can be defeated with the lockpicking skill. If a door is defeated, horizontally and vertically adjacent doors are automatically removed.',
2053     ignore => [
2054     $IGNORE_LIST{non_pickable}
2055     ],
2056     name => 'Door'
2057     },
2058 root 1.7 Duplicator => {
2059     attr => [
2060     [
2061     'other_arch',
2062 root 1.4 {
2063 elmex 1.22 desc => 'Only objects of matching archtype, lying ontop of the duplicator will be duplicated, multiplied or removed. All other objects will be ignored.',
2064 root 1.7 name => 'target arch',
2065     type => 'string'
2066 root 1.4 }
2067     ],
2068     [
2069 root 1.7 'level',
2070 root 1.4 {
2071 root 1.7 desc => 'The number of items in the target pile will be multiplied by the <multiply factor>. If it is set to zero, all target objects will be destroyed.',
2072     name => 'multiply factor',
2073     type => 'int'
2074 root 1.4 }
2075     ],
2076     [
2077 root 1.7 'connected',
2078 root 1.4 {
2079 root 1.7 desc => 'An activator (lever, altar, button, etc) with matching connection value is able to trigger this duplicator. Be very careful that players cannot abuse it to create endless amounts of money or other valuable stuff!',
2080     name => 'connection',
2081     type => 'int'
2082 root 1.4 }
2083 elmex 1.21 ],
2084     [
2085     'activate_on_push',
2086     {
2087     desc => 'Whether the teleporter should only be activated on push.',
2088     name => 'Activate on push',
2089     type => 'bool'
2090     }
2091     ],
2092     [
2093     'activate_on_release',
2094     {
2095     desc => 'Whether the teleporter should only be activated on release.',
2096     name => 'Activate on release',
2097     type => 'bool'
2098     }
2099 root 1.4 ]
2100     ],
2101 root 1.3 desc => 'When activated, a duplicator can duplicate, multiply or destroy a pile of objects which lies somewhere on top of the duplicator. The duplicator has one arch name specified as &lt;target arch&gt;, and only objects of this archetype can be affected.<br> It will multiply the number of items in the pile, by the &lt;multiply factor&gt;. If the latter is set to zero, it will destroy objects.',
2102     ignore => [
2103     $IGNORE_LIST{system_object}
2104     ],
2105 root 1.5 name => 'Duplicator',
2106 root 1.3 use => 'I hope it is clear that one must be very cautious when inserting a duplicator anywhere with &lt;multiply factor&gt; greater than one. It is designed to be used for betting mechanisms only (bet -&gt; win/loose). It is <b>not acceptable</b> to allow duplication of anything other than coins, gold and jewels. Besides, it is very important that the chance to loose the input matches the chance to earn winnings.<br> A duplicator with &lt;multiply factor&gt; 3 for example should have a loosing rate of 2/3 = 67%.'
2107     },
2108 root 1.10 'Event Connector' => {
2109     attr => [
2110     [
2111     'subtype',
2112     {
2113     desc => 'The type of event that triggers a notify to the plug-in.',
2114     name => 'event type',
2115     type => 'list',
2116     value => $LIST{event_type}
2117     }
2118     ],
2119     [
2120     'title',
2121     {
2122     desc => 'The name of the plug-in that should be notified of the event, e.g. "cfpython" for python and "perl" for the Crossfire-Perl plug-in.',
2123     name => 'plug-in',
2124 root 1.11 type => 'string'
2125 root 1.10 }
2126     ],
2127     [
2128     'slaying',
2129     {
2130     desc => 'The name of the extension to invoke (for python, this is the path to a script, for perl this is the name of a extension package without the ".ext" extension.',
2131     name => 'extension',
2132 root 1.11 type => 'string'
2133 root 1.10 }
2134     ],
2135     [
2136     'name',
2137     {
2138     desc => 'A string that is passed unaltered to the extension above. Often used to pass options to the extension that alter its behaviour.',
2139     name => 'options',
2140 root 1.11 type => 'string'
2141 root 1.10 }
2142     ]
2143     ],
2144     desc => 'Event connectors link specific events that happen to objects to a crossfire plug-in.',
2145     name => 'Event Connector'
2146     },
2147 root 1.3 Exit => {
2148 root 1.7 attr => [
2149     [
2150     'slaying',
2151     {
2152     desc => 'The exit path defines the map that the player is transferred to. You can enter an absolute path, beginning with \'/\' (for example "/peterm/FireTemple/fire1"). It can also be a relative path, not beginning with \'/\' (On the map "/peterm/FireTemple/Fire2" for example I could use the relative path "Fire1"). Use relative paths whenever possible! Note that upper/lower case must always be set correctly. However, please use lower case only. It is well possible to have an exit pointing to the same map that the exit is on. If slaying is not set in an exit, the player will see a message like "the exit is closed".',
2153     name => 'exit path',
2154     type => 'string'
2155     }
2156     ],
2157     [
2158     'hp',
2159     {
2160     desc => 'The exit destinations define the (x, y)-coordinates where the exit leads to. If both are set to zero, the player will be transferred to the "default enter location" of the destined map. The latter can be set in the map- properties as "Enter X/Y". Though, please DO NOT use that. It turned out to be a source for numerous map-bugs.',
2161     name => 'destination X',
2162     type => 'int'
2163     }
2164     ],
2165     [
2166     'sp',
2167     {
2168     desc => 'The exit destinations define the (x, y)-coordinates where the exit leads to. If both are set to zero, the player will be transferred to the "default enter location" of the destined map. The latter can be set in the map- properties as "Enter X/Y". Though, please DO NOT use that. It turned out to be a source for numerous map-bugs.',
2169     name => 'destination Y',
2170     type => 'int'
2171     }
2172     ],
2173     [
2174 root 1.14 'move_on',
2175 root 1.7 {
2176 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
2177     name => 'movement type',
2178     type => 'bitmask',
2179     value => $BITMASK{movement_type}
2180 root 1.7 }
2181     ],
2182     [
2183     'msg',
2184     {
2185     desc => 'If set, this message will be displayed to the player when he applies the exit. This is quite useful to throw in some "role-play feeling": "As you enter the dark cave you hear the sound of rustling dragonscales...". Well, my english is poor, but you get the point. =)',
2186     end => 'endmsg',
2187     name => 'exit message',
2188     type => 'text'
2189     }
2190     ],
2191     [
2192     'unique',
2193     {
2194     desc => 'This flag defines the destined map as "personal unique map". If set, there will be a seperate version of that map for every player out there. This feature is used for the permanent apartments (in Scorn/Nuernberg/Caterham...). It should not be used for anything else than apartments, since Crossfire is a *multi*player game. In such a permanent apartment don\'t forget to set the unique-flag for all floor tiles too (see floors). An exit pointing outside of a personal unique map must have the "unique destination"-flag unset.',
2195     name => 'unique destination',
2196     type => 'bool'
2197     }
2198     ]
2199     ],
2200 root 1.3 desc => 'When the player applies an exit, he is transferred to a different location. (Monsters cannot use exits.) Depending on how it is set, the player applies the exit just by walking into it, or by pressing &lt;a&gt;pply when standing on the exit.',
2201     ignore => [
2202     $IGNORE_LIST{non_pickable}
2203     ],
2204 root 1.5 name => 'Exit',
2205 root 1.3 use => 'If you want to have an invisible exit, set &lt;invisible&gt; (, of course &lt;apply by walking&gt;), and put it *under* the floor. Otherwise it could be detected with the show_invisible spell. <br><br> You can be quite creative with the outlook of secret exits (their "face"). Don\'t forget to give the player relyable hints about them though.'
2206     },
2207     Flesh => {
2208 root 1.7 attr => [
2209     [
2210     'food',
2211     {
2212     desc => 'The player\'s stomache will get filled with this amount of foodpoints. The player\'s health will increase by <foodpoints>/50 hp.',
2213     name => 'foodpoints',
2214     type => 'int'
2215     }
2216     ],
2217     [
2218     'level',
2219     {
2220     desc => 'The <flesh level> is not visible to the players and it affects only dragon players. Normally this value reflects the level of the monster from which the flesh item originates. Dragon players always search for flesh of highest level possible, because it bears the best chance to gain high resistances.',
2221     name => 'flesh level',
2222     type => 'int'
2223     }
2224     ],
2225     [
2226     'startequip',
2227     {
2228     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
2229     name => 'godgiven item',
2230     type => 'bool'
2231     }
2232     ],
2233     [
2234     'msg',
2235     {
2236     desc => 'This text may describe the item.',
2237     end => 'endmsg',
2238     name => 'description',
2239     type => 'text'
2240     }
2241     ]
2242     ],
2243 root 1.17 desc => 'Just like with food, the player can fill his stomache and gain a little health by eating flesh-objects. <br> For dragon players, flesh plays a very special role though: If the flesh has resistances set, a dragon player has a chance to gain resistance in those categories. The only constraint to this process is the &lt;flesh level&gt;. Don\'t forget that flesh items with resistances have to be balanced according to map/monster difficulty.',
2244 root 1.5 name => 'Flesh',
2245 root 1.4 section => [
2246     [
2247     'resistance',
2248 root 1.7 [
2249     [
2250     'resist_physical',
2251     {
2252     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2253     name => 'resist physical %',
2254     type => 'int'
2255     }
2256     ],
2257     [
2258     'resist_magic',
2259     {
2260     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2261     name => 'resist magic %',
2262     type => 'int'
2263     }
2264     ],
2265     [
2266     'resist_fire',
2267     {
2268     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2269     name => 'resist fire %',
2270     type => 'int'
2271     }
2272     ],
2273     [
2274     'resist_electricity',
2275     {
2276     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2277     name => 'resist electricity %',
2278     type => 'int'
2279     }
2280     ],
2281     [
2282     'resist_cold',
2283     {
2284     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2285     name => 'resist cold %',
2286     type => 'int'
2287     }
2288     ],
2289     [
2290     'resist_confusion',
2291     {
2292     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2293     name => 'resist confusion %',
2294     type => 'int'
2295     }
2296     ],
2297     [
2298     'resist_acid',
2299     {
2300     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2301     name => 'resist acid %',
2302     type => 'int'
2303     }
2304     ],
2305     [
2306     'resist_drain',
2307     {
2308     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2309     name => 'resist draining %',
2310     type => 'int'
2311     }
2312     ],
2313     [
2314     'resist_weaponmagic',
2315     {
2316     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2317     name => 'resist weaponmagic %',
2318     type => 'int'
2319     }
2320     ],
2321     [
2322     'resist_ghosthit',
2323     {
2324     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2325     name => 'resist ghosthit %',
2326     type => 'int'
2327     }
2328     ],
2329     [
2330     'resist_poison',
2331     {
2332     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2333     name => 'resist poison %',
2334     type => 'int'
2335     }
2336     ],
2337     [
2338     'resist_slow',
2339     {
2340     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2341     name => 'resist slow %',
2342     type => 'int'
2343     }
2344     ],
2345     [
2346     'resist_paralyze',
2347     {
2348     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2349     name => 'resist paralyze %',
2350     type => 'int'
2351     }
2352     ],
2353     [
2354     'resist_fear',
2355     {
2356     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2357     name => 'resist fear %',
2358     type => 'int'
2359     }
2360     ],
2361     [
2362     'resist_deplete',
2363     {
2364     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2365     name => 'resist depletion %',
2366     type => 'int'
2367     }
2368     ],
2369     [
2370     'resist_death',
2371     {
2372     desc => 'RResistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2373     name => 'resist death-attack %',
2374     type => 'int'
2375     }
2376     ],
2377     [
2378     'resist_chaos',
2379     {
2380     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2381     name => 'resist chaos %',
2382     type => 'int'
2383     }
2384     ],
2385     [
2386     'resist_blind',
2387     {
2388     desc => 'Resistances on flesh items make them more durable against spellcraft of the appropriate kind. It also allows dragon players to eventually gain resistance by eating it. Usually resistance should only be set for flesh items in a monster\'s inventory.',
2389     name => 'resist blinding %',
2390     type => 'int'
2391     }
2392     ]
2393     ]
2394 root 1.4 ]
2395     ],
2396 root 1.3 use => 'For dragon players, flesh items can be highly valuable. Note that many standard monsters carry flesh items from their &lt;treasurelist&gt;. These flesh items "inherit" resistances and level from the monster they belong to. When you add special flesh items to the inventory of a monster, this is not the case - so you have to set it manually. <br><br> Generally adding special flesh-treaties for dragon players is a great thing to do. Always consider that dragon players might really not be interested in that special piece of weapon or armour, so don\'t let the dragon-fellows miss out on the reward completely.'
2397     },
2398     Floor => {
2399 root 1.7 attr => [
2400     [
2401     'is_floor',
2402     {
2403     type => 'fixed',
2404     value => 1
2405     }
2406     ],
2407     [
2408     'no_pick',
2409     {
2410     type => 'fixed',
2411     value => 1
2412     }
2413     ],
2414     [
2415     'no_magic',
2416     {
2417     desc => 'If enabled, it is impossible for players to use (wizard-) spells on that spot.',
2418     name => 'no spells',
2419     type => 'bool'
2420     }
2421     ],
2422     [
2423     'damned',
2424     {
2425     desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving.',
2426     name => 'no prayers',
2427     type => 'bool'
2428     }
2429     ],
2430     [
2431     'unique',
2432     {
2433     desc => 'Unique floor means that any items dropped on that spot will be saved byond map reset. For permanent apartments, all floor tiles must be set <unique map>.',
2434     name => 'unique map',
2435     type => 'bool'
2436     }
2437     ],
2438     [
2439     'msg',
2440     {
2441     desc => 'This text may describe the object.',
2442     end => 'endmsg',
2443     name => 'description',
2444     type => 'text'
2445     }
2446     ]
2447     ],
2448 root 1.3 desc => 'Floor is a very basic thing whithout too much functionality. It\'s a floor - you stand on it.',
2449     ignore => [
2450     $IGNORE_LIST{non_pickable}
2451     ],
2452 root 1.5 name => 'Floor',
2453 root 1.4 section => [
2454     [
2455     'terrain',
2456 root 1.7 [
2457     [
2458 root 1.14 'move_block',
2459     {
2460     desc => 'Objects using these movement types cannot move over this space.',
2461     name => 'blocked movement',
2462     type => 'bitmask',
2463     value => $BITMASK{movement_type}
2464     }
2465     ],
2466     [
2467     'move_allow',
2468     {
2469     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
2470     name => 'allowed movement',
2471     type => 'bitmask',
2472     value => $BITMASK{movement_type}
2473     }
2474     ],
2475     [
2476     'move_slow',
2477     {
2478     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
2479     name => 'slowed movement',
2480     type => 'bitmask',
2481     value => $BITMASK{movement_type}
2482     }
2483     ],
2484     [
2485     'move_slow_penalty',
2486 root 1.7 {
2487 root 1.14 desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
2488     name => 'slow movement penalty',
2489 root 1.7 type => 'int'
2490     }
2491     ],
2492     [
2493     'is_wooded',
2494     {
2495     desc => 'This flag indicates this spot contains wood or high grass. Players with activated woodsman skill can move faster here.',
2496     name => 'wooded terrain',
2497     type => 'bool'
2498     }
2499     ],
2500     [
2501     'is_hilly',
2502     {
2503     desc => 'This flag indicates this spot contains hills or large rocks. Players with activated mountaineer skill can move faster here.',
2504     name => 'hilly terrain',
2505     type => 'bool'
2506     }
2507     ]
2508     ]
2509 root 1.4 ]
2510     ]
2511 root 1.3 },
2512     'Floor (Encounter)' => {
2513 root 1.7 attr => [
2514     [
2515     'is_floor',
2516     {
2517     type => 'fixed',
2518     value => 1
2519     }
2520     ],
2521     [
2522     'no_pick',
2523     {
2524     type => 'fixed',
2525     value => 1
2526     }
2527     ],
2528     [
2529     'no_magic',
2530     {
2531     desc => 'If enabled, it is impossible for players to use (wizard-) spells on that spot.',
2532     name => 'no spells',
2533     type => 'bool'
2534     }
2535     ],
2536     [
2537     'damned',
2538     {
2539     desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving.',
2540     name => 'no prayers',
2541     type => 'bool'
2542     }
2543     ],
2544     [
2545     'unique',
2546     {
2547     desc => 'Unique floor means that any items dropped on that spot will be saved byond map reset. For permanent apartments, all floor tiles must be set <unique map>.',
2548     name => 'unique map',
2549     type => 'bool'
2550     }
2551     ],
2552     [
2553     'msg',
2554     {
2555     desc => 'This text may describe the object.',
2556     end => 'endmsg',
2557     name => 'description',
2558     type => 'text'
2559     }
2560     ]
2561     ],
2562 root 1.3 desc => 'Encounter-Floor is pretty much the same as normal floor. Most outdoor floor/ground-arches are set to be "encounters". That is kind of a relict from former code: When walking over encounter-floor, players sometimes got beamed to little maps with monsters on them. Nowadays this feature is disabled - Hence encounter floor is not different from normal floor.',
2563     ignore => [
2564     $IGNORE_LIST{non_pickable}
2565 root 1.4 ],
2566 root 1.5 name => 'Floor (Encounter)',
2567 root 1.4 section => [
2568     [
2569     'terrain',
2570 root 1.7 [
2571     [
2572 root 1.14 'move_block',
2573     {
2574     desc => 'Objects using these movement types cannot move over this space.',
2575     name => 'blocked movement',
2576     type => 'bitmask',
2577     value => $BITMASK{movement_type}
2578     }
2579     ],
2580     [
2581     'move_allow',
2582 root 1.7 {
2583 root 1.14 desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
2584     name => 'allowed movement',
2585     type => 'bitmask',
2586     value => $BITMASK{movement_type}
2587     }
2588     ],
2589     [
2590     'move_slow',
2591     {
2592     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
2593     name => 'slowed movement',
2594     type => 'bitmask',
2595     value => $BITMASK{movement_type}
2596     }
2597     ],
2598     [
2599     'move_slow_penalty',
2600     {
2601     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
2602     name => 'slow movement penalty',
2603 root 1.7 type => 'int'
2604     }
2605     ],
2606     [
2607     'is_wooded',
2608     {
2609     desc => 'This flag indicates this spot contains wood or high grass. Players with activated woodsman skill can move faster here.',
2610     name => 'wooded terrain',
2611     type => 'bool'
2612     }
2613     ],
2614     [
2615     'is_hilly',
2616     {
2617     desc => 'This flag indicates this spot contains hills or large rocks. Players with activated mountaineer skill can move faster here.',
2618     name => 'hilly terrain',
2619     type => 'bool'
2620     }
2621     ]
2622     ]
2623 root 1.4 ]
2624 root 1.3 ]
2625     },
2626     Food => {
2627 root 1.7 attr => [
2628     [
2629     'food',
2630     {
2631     desc => 'The player\'s stomache will get filled with this amount of foodpoints. The player\'s health will increase by <foodpoints>/50 hp.',
2632     name => 'foodpoints',
2633     type => 'int'
2634     }
2635     ],
2636     [
2637     'startequip',
2638     {
2639     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
2640     name => 'godgiven item',
2641     type => 'bool'
2642     }
2643     ]
2644     ],
2645 root 1.5 desc => 'By eating/drinking food-objects, the player can fill his stomache and gain a little health.',
2646     name => 'Food'
2647 root 1.1 },
2648 root 1.3 Gate => {
2649 root 1.7 attr => [
2650     [
2651     'no_pick',
2652     {
2653     type => 'fixed',
2654     value => 1
2655     }
2656     ],
2657     [
2658 elmex 1.20 'speed',
2659     {
2660     desc => 'The speed of the gate affects how fast it is closing/opening.',
2661     type => 'float'
2662     }
2663     ],
2664     [
2665 root 1.7 'connected',
2666     {
2667     desc => 'Whenever the inventory checker is triggered, all objects with identical <connection> value get activated. This only makes sense together with <blocking passage> disabled.',
2668     name => 'connection',
2669     type => 'int'
2670     }
2671     ],
2672     [
2673     'wc',
2674     {
2675     desc => 'The <position state> defines the position of the gate: Zero means completely open/down, the "number of animation-steps" (usually about 6 or 7) means completely closed/up state. I suggest you don\'t mess with this value - Leave the default in place.',
2676     name => 'position state',
2677     type => 'int'
2678     }
2679     ],
2680     [
2681 root 1.14 'move_block',
2682     {
2683     desc => 'Objects using these movement types cannot move over this space.',
2684     name => 'blocked movement',
2685     type => 'bitmask',
2686     value => $BITMASK{movement_type}
2687     }
2688     ],
2689     [
2690     'move_allow',
2691     {
2692     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
2693     name => 'allowed movement',
2694     type => 'bitmask',
2695     value => $BITMASK{movement_type}
2696     }
2697     ],
2698     [
2699     'move_slow',
2700 root 1.7 {
2701 root 1.14 desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
2702     name => 'slowed movement',
2703     type => 'bitmask',
2704     value => $BITMASK{movement_type}
2705     }
2706     ],
2707     [
2708     'move_slow_penalty',
2709     {
2710     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
2711     name => 'slow movement penalty',
2712     type => 'int'
2713 root 1.7 }
2714     ],
2715     [
2716     'no_magic',
2717     {
2718     desc => 'Restricting the use of spells to pass this gate. This has an effect only if <block view> is disabled.',
2719     name => 'restrict spells',
2720     type => 'bool'
2721     }
2722     ],
2723     [
2724     'damned',
2725     {
2726     desc => 'Restricting the use of prayers to pass this door. This has an effect only if <block view> is disabled.',
2727     name => 'restrict prayers',
2728     type => 'bool'
2729     }
2730     ]
2731     ],
2732 root 1.3 desc => 'Gates play an important role in Crossfire. Gates can be opened by activating a button/trigger, by speaking passwords (-> magic_ear) or carrying special key-objects (-> inventory checker). Unlike locked doors, gates can get shut again after a player has passed, which makes them more practical in many cases.',
2733     ignore => [
2734     $IGNORE_LIST{non_pickable}
2735     ],
2736 root 1.5 name => 'Gate',
2737 root 1.3 use => 'Use gates to divide your maps into seperated areas. After solving area A, the player gains access to area B, and so on. Make your maps more complex than "one-way".'
2738     },
2739     Girdle => {
2740 root 1.7 attr => [
2741     [
2742     'magic',
2743     {
2744     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the helmet. Important: <magic bonus> on girdles has no effect if there is no <armour class> set. Girdles shouldn\'t have <armour class>, thus <magic bonus> is pointless here.',
2745     name => 'magic bonus',
2746     type => 'int'
2747     }
2748     ]
2749     ],
2750     desc => 'Wearing a girdle, the object\'s stats will directly be inherited to the player. Girdles usually provide stats- or damage bonuses and no defense.',
2751     import => [
2752     $TYPE{Amulet}
2753     ],
2754     name => 'Girdle',
2755     use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
2756     },
2757     Gloves => {
2758     attr => [
2759     [
2760     'magic',
2761     {
2762     desc => 'If the gloves provide <armour class>, <magic bonus> will increase it. If the gloves have <weapon class> instead, then <magic bonus> will increase that.',
2763     name => 'magic bonus',
2764     type => 'int'
2765     }
2766     ]
2767     ],
2768     desc => 'Wearing gloves, the object\'s stats will directly be inherited to the player. Gloves can add defense or damage bonuses.',
2769     import => [
2770     $TYPE{Amulet}
2771     ],
2772     name => 'Gloves',
2773     use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
2774     },
2775     Handle => {
2776     attr => [
2777     [
2778     'no_pick',
2779     {
2780     type => 'fixed',
2781     value => 1
2782     }
2783     ],
2784     [
2785     'connected',
2786     {
2787     desc => 'Every time the handle is applied, all objects with the same <connection> value are activated.',
2788     name => 'connection',
2789     type => 'int'
2790     }
2791     ],
2792     [
2793     'msg',
2794     {
2795     desc => 'This text may describe the item. You can use this message to explain the handle\'s purpose to the player.',
2796     end => 'endmsg',
2797     name => 'description',
2798     type => 'text'
2799     }
2800     ]
2801     ],
2802     desc => 'A handle can be applied by players and (certain) monsters. Every time it is applied, the &lt;connection&gt; value is triggered.',
2803     ignore => [
2804     $IGNORE_LIST{non_pickable}
2805     ],
2806     name => 'Handle',
2807     use => 'Handles are commonly used to move gates. When placing your lever, don\'t forget that some monsters are able to apply it. The ability to apply levers is rare among monsters - but vampires can do it for example.'
2808     },
2809     'Handle Trigger' => {
2810     desc => 'Handle triggers are handles which reset after a short period of time. Every time it is either applied or reset, the &lt;connection&gt; value is triggered.',
2811     ignore => [
2812     $IGNORE_LIST{non_pickable}
2813     ],
2814     import => [
2815     $TYPE{Handle}
2816     ],
2817     name => 'Handle Trigger',
2818     use => 'When you connect an ordinary handle to a gate, the gate normally remains opened after the first player passed. If you want to keep the gate shut, connecting it to a handle trigger is an easy solution.'
2819     },
2820     'Hazard Floor' => {
2821     attr => [
2822     [
2823     'is_floor',
2824     {
2825     type => 'fixed',
2826     value => 1
2827     }
2828     ],
2829     [
2830     'lifesave',
2831     {
2832     type => 'fixed',
2833     value => 1
2834     }
2835     ],
2836     [
2837 root 1.14 'move_on',
2838 root 1.7 {
2839 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
2840     name => 'movement type',
2841     type => 'bitmask',
2842     value => $BITMASK{movement_type}
2843 root 1.7 }
2844     ],
2845     [
2846     'no_pick',
2847     {
2848     type => 'fixed',
2849     value => 1
2850     }
2851     ],
2852     [
2853     'attacktype',
2854     {
2855     desc => 'This attribute specifys the attacktypes that this floor uses to damage it\'s victims. Attacktypes are: physical, fire, cold.. etc. If you want a real tough hazard floor, add more than just one attacktype.',
2856     name => 'attacktype',
2857     type => 'bitmask',
2858     value => $BITMASK{attacktype}
2859     }
2860     ],
2861     [
2862     'dam',
2863     {
2864     desc => 'The <base damage> defines how much damage is inflicted to the victim per hit. The final damage is influenced by several other factors like the victim\'s resistance and level.',
2865     name => 'base damage',
2866     type => 'int'
2867     }
2868     ],
2869     [
2870     'wc',
2871     {
2872     desc => '<weapon class> improves the chance of hitting the victim. Lower values are better. Usually, hazard floors like lava are supposed to hit the victim all the time. Therefore, <weaponclass> should be set to something like -30.',
2873     name => 'weaponclass',
2874     type => 'int'
2875     }
2876     ],
2877     [
2878     'level',
2879     {
2880     desc => 'I guess this value is supposed to work similar to monster levels. But in fact, it does not seem to have an effect. Set any non-zero value to be on the safe side.',
2881     name => 'attack level',
2882     type => 'int'
2883     }
2884     ],
2885     [
2886     'no_magic',
2887     {
2888     desc => 'If enabled, it is impossible for players to use (wizard-) spells on that spot.',
2889     name => 'no spells',
2890     type => 'bool'
2891     }
2892     ],
2893     [
2894     'damned',
2895     {
2896     desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving.',
2897     name => 'no prayers',
2898     type => 'bool'
2899     }
2900     ],
2901     [
2902     'unique',
2903     {
2904     desc => 'Unique floor means that any items dropped on that spot will be saved byond map reset. For permanent apartments, all floor tiles must be set <unique map>.',
2905     name => 'unique map',
2906     type => 'bool'
2907     }
2908     ]
2909 root 1.3 ],
2910     desc => 'The best example for Hazard Floor is lava. It works like standard floor, but damages all creatures standing on it. Damage is taken in regular time intervals.',
2911     ignore => [
2912     $IGNORE_LIST{non_pickable}
2913     ],
2914 root 1.5 name => 'Hazard Floor',
2915 root 1.4 section => [
2916     [
2917     'terrain',
2918 root 1.7 [
2919     [
2920 root 1.14 'move_block',
2921     {
2922     desc => 'Objects using these movement types cannot move over this space.',
2923     name => 'blocked movement',
2924     type => 'bitmask',
2925     value => $BITMASK{movement_type}
2926     }
2927     ],
2928     [
2929     'move_allow',
2930 root 1.7 {
2931 root 1.14 desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
2932     name => 'allowed movement',
2933     type => 'bitmask',
2934     value => $BITMASK{movement_type}
2935     }
2936     ],
2937     [
2938     'move_slow',
2939     {
2940     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
2941     name => 'slowed movement',
2942     type => 'bitmask',
2943     value => $BITMASK{movement_type}
2944     }
2945     ],
2946     [
2947     'move_slow_penalty',
2948     {
2949     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
2950     name => 'slow movement penalty',
2951 root 1.7 type => 'int'
2952     }
2953     ],
2954     [
2955     'is_wooded',
2956     {
2957     desc => 'This flag indicates this spot contains wood or high grass. Players with activated woodsman skill can move faster here.',
2958     name => 'wooded terrain',
2959     type => 'bool'
2960     }
2961     ],
2962     [
2963     'is_hilly',
2964     {
2965     desc => 'This flag indicates this spot contains hills or large rocks. Players with activated mountaineer skill can move faster here.',
2966     name => 'hilly terrain',
2967     type => 'bool'
2968     }
2969     ]
2970     ]
2971 root 1.4 ]
2972     ],
2973 root 1.3 use => 'The default lava for example does minor damage. But you can turn it up so that your hazard floor poses a real threat.<br> Like magic walls, such floors add a permanent thrill to your map. You can use that to safely chase off too-weak players, or just to have something different.'
2974     },
2975     Helmet => {
2976 root 1.7 attr => [
2977     [
2978     'magic',
2979     {
2980     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the helmet. Important: <magic bonus> on helmets has no effect if there is no <armour class> set. It only works in combination with <armour class>. Crowns for instance typically provide no <amour class>.',
2981     name => 'magic bonus',
2982     type => 'int'
2983     }
2984     ]
2985     ],
2986 root 1.3 desc => 'Wearing a helmet, the object\'s stats will directly be inherited to the player. Normal helmets usually increase defense, while crowns add more special bonuses like stats/resistances paired with low defense.',
2987     import => [
2988     $TYPE{Amulet}
2989     ],
2990 root 1.5 name => 'Helmet',
2991 root 1.3 use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
2992     },
2993     'Holy Altar' => {
2994 root 1.7 attr => [
2995     [
2996     'no_pick',
2997     {
2998     type => 'fixed',
2999     value => 1
3000     }
3001     ],
3002     [
3003     'other_arch',
3004     {
3005     desc => 'The altar belongs to the god of the given name. Possible options for <god name> are: Devourers, Lythander, Mostrai, Gaea, Ruggilli, Gnarg, Gorokh, Valriel and Sorig. If you want to have an unconsecrated altar, set <god name> 0 and eventually <reconsecrate level> 0.',
3006     name => 'god name',
3007     type => 'string'
3008     }
3009     ],
3010     [
3011     'level',
3012     {
3013 elmex 1.22 desc => 'To re-consecrate an altar, the player\'s wisdom level must be as high or higher than this value. In that way, some altars can not be re-consecrated, while other altars, like those in dungeons, could be. Altars located in temples should have at least <reconsecrate level> 120. Some characters might need those altars, they would be very unhappy to see them re-consecrated to another cult.',
3014 root 1.7 name => 'reconsecrate level',
3015     type => 'int'
3016     }
3017     ]
3018     ],
3019 root 1.3 desc => 'Holy_altars are altars for the various religions. Praying at a Holy_altar will make you a follower of that god, and if you already follow that god, you may get some extra bonus.',
3020     ignore => [
3021     $IGNORE_LIST{non_pickable}
3022 root 1.5 ],
3023     name => 'Holy Altar'
3024 root 1.3 },
3025     Horn => {
3026 root 1.7 attr => [
3027     [
3028     'sp',
3029     {
3030     desc => 'Sets the <spell> of the horn. Consider twice before handing out any horns to players, since they can be used endlessly without any mana cost! Horns with heal/ restoration/ protection spells, IF available, MUST be very very VERY hard to get!',
3031     name => 'spell',
3032     type => 'spell'
3033     }
3034     ],
3035     [
3036     'level',
3037     {
3038     desc => 'The casting level of the <spell> determines it\'s power. For attack spells, level should not be set too high.',
3039     name => 'casting level',
3040     type => 'int'
3041     }
3042     ],
3043     [
3044     'hp',
3045     {
3046     desc => 'This value represents the initial amount of spellpoints in the horn. Naturally, this is quite unimportant.',
3047     name => 'initial spellpoints',
3048     type => 'int'
3049     }
3050     ],
3051     [
3052     'maxhp',
3053     {
3054     desc => 'When the horn is fully charged up, it will hold this maximum amount of spellpoints. Make sure it is enough to cast the contained spell at least once. But don\'t set the value too high, as that might make the horn way too effective.',
3055     name => 'max. spellpoints',
3056     type => 'int'
3057     }
3058     ],
3059     [
3060     'startequip',
3061     {
3062     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
3063     name => 'godgiven item',
3064     type => 'bool'
3065     }
3066     ],
3067     [
3068     'msg',
3069     {
3070     desc => 'This text may contain a description of the horn.',
3071     end => 'endmsg',
3072     name => 'description',
3073     type => 'text'
3074     }
3075     ]
3076     ],
3077 root 1.3 desc => 'Horns are very similar to rods. The difference is that horns regenerate spellpoints faster and thus are more valuable than rods. <br><br> A horn contains a spell. The player can use this spell by applying and "fireing" (blowing) the horn. Unlike wands/scrolls, horns can be used endlessly.',
3078     ignore => [
3079     'title'
3080     ],
3081 root 1.5 name => 'Horn',
3082 root 1.3 use => 'Horns are powerful due to their fast recharge rate. They should never contain high level attacking spells. Even curing/healing spells are almost too good on a horn.'
3083     },
3084     Inorganic => {
3085 root 1.7 attr => [
3086     [
3087     'is_dust',
3088     {
3089     name => 'is dust',
3090     type => 'bool'
3091     }
3092     ]
3093     ],
3094 root 1.4 desc => 'Inorganic materials are generally used as ingredients for alchemical receipes. By themselves, they have no special functionalities.',
3095 root 1.5 name => 'Inorganic',
3096 root 1.4 section => [
3097     [
3098     'resistance',
3099 root 1.7 [
3100     [
3101     'resist_physical',
3102     {
3103     name => 'resist physical %',
3104     type => 'int'
3105     }
3106     ],
3107     [
3108     'resist_magic',
3109     {
3110     name => 'resist magic %',
3111     type => 'int'
3112     }
3113     ],
3114     [
3115     'resist_fire',
3116     {
3117     name => 'resist fire %',
3118     type => 'int'
3119     }
3120     ],
3121     [
3122     'resist_electricity',
3123     {
3124     name => 'resist electricity %',
3125     type => 'int'
3126     }
3127     ],
3128     [
3129     'resist_cold',
3130     {
3131     name => 'resist cold %',
3132     type => 'int'
3133     }
3134     ],
3135     [
3136     'resist_acid',
3137     {
3138     name => 'resist acid %',
3139     type => 'int'
3140     }
3141     ],
3142     [
3143     'resist_weaponmagic',
3144     {
3145     name => 'resist weaponmagic %',
3146     type => 'int'
3147     }
3148     ],
3149     [
3150     'resist_ghosthit',
3151     {
3152     name => 'resist ghosthit %',
3153     type => 'int'
3154     }
3155     ],
3156     [
3157     'resist_poison',
3158     {
3159     name => 'resist poison %',
3160     type => 'int'
3161     }
3162     ],
3163     [
3164     'resist_death',
3165     {
3166     name => 'resist death-attack %',
3167     type => 'int'
3168     }
3169     ],
3170     [
3171     'resist_chaos',
3172     {
3173     name => 'resist chaos %',
3174     type => 'int'
3175     }
3176     ],
3177     [
3178     'resist_holyword',
3179     {
3180     name => 'resist holy power %',
3181     type => 'int'
3182     }
3183     ]
3184     ]
3185 root 1.4 ]
3186     ]
3187 root 1.1 },
3188 root 1.3 'Inventory Checker' => {
3189 root 1.7 attr => [
3190     [
3191     'no_pick',
3192     {
3193     type => 'fixed',
3194     value => 1
3195     }
3196     ],
3197     [
3198     'slaying',
3199     {
3200     desc => 'This string specifies the object we are looking for: We have a match if the player does/don\'t carry a key object or a mark with identical <key string>. Note that key objects usually appear as "passports" in this context. A typical example is the city gate mechanism of scorn.',
3201     name => 'match key string',
3202     type => 'string'
3203     }
3204     ],
3205     [
3206     'race',
3207     {
3208     desc => 'This string specifies the object we are looking for: We have a match if the player does/don\'t carry an object of archtype <match arch name>.',
3209     name => 'match arch name',
3210     type => 'string'
3211     }
3212     ],
3213     [
3214     'hp',
3215     {
3216     desc => 'This value specifies the object we are looking for: We have a match if the player does/don\'t carry an object that is of type <match type>. Example: Set <match type> 15 (type 15 => weapon) and <blocking passage> enabled. Now you have an inv. checker blocking all players that carry any kind of melee weapon. To pass, a player is forced to leave behind all his weaponry... bad news for a warrior. ;)',
3217     name => 'match type',
3218     type => 'int'
3219     }
3220     ],
3221     [
3222     'last_sp',
3223     {
3224     desc => 'Enabled means having that object is a match. Disabled means not having that object is a match.',
3225     name => 'match = having',
3226     type => 'bool'
3227     }
3228     ],
3229     [
3230     'connected',
3231     {
3232     desc => 'Whenever the inventory checker is triggered, all objects with identical <connection> value get activated. This only makes sense together with <blocking passage> disabled.',
3233     name => 'connection',
3234     type => 'int'
3235     }
3236     ],
3237     [
3238 root 1.14 'move_block',
3239 root 1.7 {
3240 root 1.14 desc => 'Objects using these movement types cannot move over this space.',
3241     name => 'blocked movement',
3242     type => 'bitmask',
3243     value => $BITMASK{movement_type}
3244     }
3245     ],
3246     [
3247     'move_allow',
3248     {
3249     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
3250     name => 'allowed movement',
3251     type => 'bitmask',
3252     value => $BITMASK{movement_type}
3253     }
3254     ],
3255     [
3256     'move_slow',
3257     {
3258     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
3259     name => 'slowed movement',
3260     type => 'bitmask',
3261     value => $BITMASK{movement_type}
3262     }
3263     ],
3264     [
3265     'move_slow_penalty',
3266     {
3267     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
3268     name => 'slow movement penalty',
3269     type => 'int'
3270 root 1.7 }
3271     ],
3272     [
3273     'last_heal',
3274     {
3275     desc => '<remove match> means remove object if found. Setting this is usually not recommended because inv. checkers are in general invisible. So, unlike for altars/ locked doors, the player won\'t expect to lose an object when walking over that square. And he doesn\'t even get a message either. So, *if* you enable <remove match>, make sure to inform the player what\'s going on!',
3276     name => 'remove match',
3277     type => 'bool'
3278     }
3279     ]
3280     ],
3281 root 1.14 desc => 'Inventory checkers passively check the players inventory for a specific object. You can set a connected value that is triggered either if that object is present or missing (-&gt; "last_sp") when a player walks over the inv. checker. A valid option is to remove the matching object (usually not recommended, see "last_heal"). <br><br> Alternatively, you can set your inv. checker to block all players that do/don\'t carry the matching object. <br><br> As you can see, inv. checkers are quite powerful, holding a great variety of possibilities.',
3282 root 1.3 ignore => [
3283     $IGNORE_LIST{system_object}
3284     ],
3285 root 1.5 name => 'Inventory Checker',
3286 root 1.3 use => 'Putting a check_inventory space in front of a gate (one below) and one on the opposite side works reasonably well as a control mechanism. Unlike the key/door-combo, this one works infinite since it is independant from map reset. Use it to put a "structure" into your maps: Player must solve area A to gain access to area B. This concept can be found in nearly every RPG - simple but effective.'
3287     },
3288 root 1.8 'Item Transformer' => {
3289     attr => [
3290     [
3291     'food',
3292     {
3293     desc => '<number of uses> controls how many times the item transformer can be used. The value 0 means "unlimited"',
3294     name => 'number of uses',
3295     type => 'int'
3296     }
3297     ],
3298     [
3299     'slaying',
3300     {
3301     desc => 'Contains the verb that is used to construct a message to the player applying the item transformer.',
3302     name => 'verb',
3303     type => 'string'
3304     }
3305     ],
3306     [
3307     'startequip',
3308     {
3309     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
3310     name => 'godgiven item',
3311     type => 'bool'
3312     }
3313     ],
3314     [
3315     'msg',
3316     {
3317     desc => 'This text may contain a description of the item transformer.',
3318     end => 'endmsg',
3319     name => 'description',
3320     type => 'text'
3321     }
3322     ]
3323     ],
3324     desc => 'An item transformer is simply applied, after having marked a \'victim\' item. If the victim is suitable, it will be transformed into something else.',
3325     name => 'Item Transformer',
3326     use => 'To make an item transformable, you just have to fill the \'slaying\' field. The syntax is: <br> <pre>slaying slayer:[yield ]new_item[;slayer:[yield ]new_item]*</pre> <br> with [] denoting optional part, and * any number of preceding []. \'new_item\' must be the name of an existing archetype. <br><br> Example, for object apple: slaying knife:2 half_apple <br><br> This means that, when applying a knife (should be an Item Transformer), one \'apple\' will be transformed into 2 \'half_apple\'.'
3327     },
3328 root 1.3 Jewel => {
3329 root 1.7 attr => [
3330     [
3331     'race',
3332     {
3333     type => 'fixed',
3334     value => 'gold and jewels'
3335     }
3336     ],
3337     [
3338     'msg',
3339     {
3340     desc => 'This text may describe the object.',
3341     end => 'endmsg',
3342     name => 'description',
3343     type => 'text'
3344     }
3345     ]
3346     ],
3347 root 1.5 desc => 'Items of the type Gold &amp; Jewels are handled like a currency. Unlike for any other type of item, in shops, the buy- and selling prices differ only marginally.',
3348     name => 'Jewel'
3349 root 1.1 },
3350 root 1.9 Key => {
3351     attr => [
3352     [
3353     'startequip',
3354     {
3355     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
3356     name => 'godgiven item',
3357     type => 'bool'
3358     }
3359     ]
3360     ],
3361     desc => 'When carrying a key, a normal door can be opened. The key will disappear.',
3362     name => 'Key'
3363     },
3364 root 1.3 'Locked Door' => {
3365 root 1.7 attr => [
3366     [
3367 root 1.14 'move_type',
3368 root 1.7 {
3369     type => 'fixed',
3370 root 1.14 value => 0
3371 root 1.7 }
3372     ],
3373     [
3374     'no_pick',
3375     {
3376     type => 'fixed',
3377     value => 1
3378     }
3379     ],
3380     [
3381     'slaying',
3382     {
3383     desc => 'The <key string> in the door must be identical with the <key string> in the special key, then the door is unlocked. It is VERY important to set the <key string> to something that is unique among the CF mapset. DONT EVER USE the default string "set_individual_value".',
3384     name => 'key string',
3385     type => 'string'
3386     }
3387     ],
3388     [
3389     'no_magic',
3390     {
3391     desc => 'Restricting the use of spells to pass this door. This should be set in most cases. (Don\'t forget that the spell "dimension door" is easily available at about wisdom level 10).',
3392     name => 'restrict spells',
3393     type => 'bool'
3394     }
3395     ],
3396     [
3397     'damned',
3398     {
3399     desc => 'Restricting the use of prayers to pass this door. This should be set in most cases.',
3400     name => 'restrict prayers',
3401     type => 'bool'
3402     }
3403     ],
3404     [
3405     'msg',
3406     {
3407     desc => 'When a player is trying to open the door without carrying the appropriate key, this text is displayed to the player. This is a good opportunity to place hints about the special key needed to unlock the door.',
3408     end => 'endmsg',
3409     name => 'lock message',
3410     type => 'text'
3411     }
3412     ]
3413     ],
3414     desc => 'A locked door can be opened only when carrying the appropriate special key.',
3415     ignore => [
3416     $IGNORE_LIST{non_pickable}
3417     ],
3418     name => 'Locked Door',
3419     use => 'If you want to create a locked door that cannot be opened (no key), set a &lt;key string&gt; like "no_key_available". This will clearify things and only a fool would create a key matching that string. Door-objects can not only be used for "doors". In many maps these are used with all kinds of faces/names, especially often as "magic force". A good example is the map "Lake_Country/ebony/masterlev". There you have magic forces (door objects) put under certain artifact items. To get your hands on the artifacts, you need to bring up the appropriate quest items (key objects).'
3420     },
3421     'Magic Ear' => {
3422     attr => [
3423     [
3424     'no_pick',
3425     {
3426     type => 'fixed',
3427     value => 1
3428     }
3429     ],
3430     [
3431     'connected',
3432     {
3433     desc => 'The Magic_ear will trigger all objects with the same connection value, every time it is activated.',
3434     name => 'connection',
3435     type => 'int'
3436     }
3437     ],
3438     [
3439     'msg',
3440     {
3441     desc => 'This textfield contains the keyword-matching-syntax. The text should have the following format: "@match <keyword1>|<keyword2>|... ". Any number of keywords from one to infinite is allowed. Make sure they are seperated by a \'|\'. Examples: "@match yes", "@match gold|treasure". The connected value will be triggerd when the player speaks any of the given keywords within a two-square radius. IMPORTANT: Upper/lower case does not make a difference!',
3442     end => 'endmsg',
3443     name => 'keyword-matching',
3444     type => 'text'
3445     }
3446     ]
3447     ],
3448     desc => 'Magic_ears trigger a connected value when the player speaks a specific keyword.',
3449     ignore => [
3450     $IGNORE_LIST{system_object}
3451     ],
3452     name => 'Magic Ear',
3453     use => 'Whenever you put magic_ears on your maps, make sure there are CLEAR and RELYABLE hints about the keywords somewhere. Don\'t make something like a gate that is opened by speaking "open" or "sesame", expecting the player to figure this out all by himself. <br><br> Magic_ears are typically used for interaction with NPCs. You can create the impression that the NPC actually *does* something according to his conversation with a player. Mostly this means opening a gate or handing out some item, but you could be quite creative here.'
3454     },
3455     'Magic Wall' => {
3456     attr => [
3457     [
3458     'dam',
3459     {
3460     desc => 'The magic wall will cast this <spell>.',
3461     name => 'spell',
3462     type => 'spell'
3463     }
3464     ],
3465     [
3466     'level',
3467     {
3468     desc => 'The wall will cast it\'s spells at level <spell level>. "level 1" walls cast spells at minimal strength. "level 100" walls cast deadly spells. Arch default is level 1 - you should always set this value to meet the overall difficulty of your map.',
3469     name => 'spell level',
3470     type => 'int'
3471     }
3472     ],
3473     [
3474     'connected',
3475     {
3476     desc => 'Every time the <connection> value is triggered, the wall will cast it\'s spell. You should set <casting speed> to zero, or this won\'t have much visible effect.',
3477     name => 'connection',
3478     type => 'int'
3479     }
3480     ],
3481     [
3482 elmex 1.21 'activate_on_push',
3483     {
3484     desc => 'Whether the teleporter should only be activated on push.',
3485     name => 'Activate on push',
3486     type => 'bool'
3487     }
3488     ],
3489     [
3490     'activate_on_release',
3491     {
3492     desc => 'Whether the teleporter should only be activated on release.',
3493     name => 'Activate on release',
3494     type => 'bool'
3495     }
3496     ],
3497     [
3498 root 1.7 'speed',
3499     {
3500     desc => 'The <casting speed> defines the spellcasting speed of the wall. You can fine-tune how long the duration between two casts shall be. If you want to create a wall that can be activated (cast per trigger) via connected lever/button/etc, you must set "speed 0".',
3501     name => 'casting speed',
3502     type => 'float'
3503     }
3504     ],
3505     [
3506 root 1.17 'speed_left',
3507     {
3508     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
3509     name => 'speed left',
3510     type => 'float'
3511     }
3512     ],
3513     [
3514 root 1.7 'sp',
3515     {
3516     desc => 'The magic wall will cast it\'s spells always in the specified <direction>. A magic wall with direction set to <none> will always fire in a random direction.',
3517     name => 'direction',
3518     type => 'list',
3519     value => $LIST{direction}
3520     }
3521     ],
3522     [
3523 root 1.14 'move_block',
3524     {
3525     desc => 'Objects using these movement types cannot move over this space.',
3526     name => 'blocked movement',
3527     type => 'bitmask',
3528     value => $BITMASK{movement_type}
3529     }
3530     ],
3531     [
3532     'move_allow',
3533     {
3534     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
3535     name => 'allowed movement',
3536     type => 'bitmask',
3537     value => $BITMASK{movement_type}
3538     }
3539     ],
3540     [
3541     'move_slow',
3542 root 1.7 {
3543 root 1.14 desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
3544     name => 'slowed movement',
3545     type => 'bitmask',
3546     value => $BITMASK{movement_type}
3547     }
3548     ],
3549     [
3550     'move_slow_penalty',
3551     {
3552     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
3553     name => 'slow movement penalty',
3554     type => 'int'
3555 root 1.7 }
3556     ]
3557 root 1.3 ],
3558     desc => 'Magic walls fire spells in a given direction, in regular intervals. Magic walls can contain any spell. However, some spells do not operate very successfully in them. The only way to know is to test the spell you want to use with a wall. <br><br> Several types of magical walls are predefined for you in the archetypes, and can be found on the "connected" Pickmap.',
3559     ignore => [
3560     $IGNORE_LIST{non_pickable}
3561     ],
3562 root 1.5 name => 'Magic Wall',
3563 root 1.4 section => [
3564     [
3565     'destroyable',
3566 root 1.7 [
3567     [
3568     'alive',
3569     {
3570     desc => 'Walls with <is destroyable> enabled can be attacked and (eventually) destroyed by the player. If disabled, all other attributes on this tab, as well as resistances, are meaningless.',
3571     name => 'is destroyable',
3572     type => 'bool'
3573     }
3574     ],
3575     [
3576     'hp',
3577     {
3578     desc => 'The more <hitpoints> the wall has, the longer it takes to be destroyed.',
3579     name => 'hitpoints',
3580     type => 'int'
3581     }
3582     ],
3583     [
3584     'maxhp',
3585     {
3586     desc => '<max hitpoints> are the maximum amount of hitpoints the wall can have. This only makes sense if the wall can regain health.',
3587     name => 'max hitpoints',
3588     type => 'int'
3589     }
3590     ],
3591     [
3592     'ac',
3593     {
3594     desc => 'A magic wall of high <armour class> is less likely to get hit from an opponent. <armour class> can be considered the "counterpiece" to <weapon class>.',
3595     name => 'armour class',
3596     type => 'int'
3597     }
3598     ]
3599     ]
3600     ],
3601     [
3602     'resistance',
3603     [
3604     [
3605     'resist_physical',
3606     {
3607     name => 'resist physical %',
3608     type => 'int'
3609     }
3610     ],
3611     [
3612     'resist_magic',
3613     {
3614     name => 'resist magic %',
3615     type => 'int'
3616     }
3617     ],
3618     [
3619     'resist_fire',
3620     {
3621     name => 'resist fire %',
3622     type => 'int'
3623     }
3624     ],
3625     [
3626     'resist_electricity',
3627     {
3628     name => 'resist electricity %',
3629     type => 'int'
3630     }
3631     ],
3632     [
3633     'resist_cold',
3634     {
3635     name => 'resist cold %',
3636     type => 'int'
3637     }
3638     ],
3639     [
3640     'resist_confusion',
3641     {
3642     name => 'resist confusion %',
3643     type => 'int'
3644     }
3645     ],
3646     [
3647     'resist_acid',
3648     {
3649     name => 'resist acid %',
3650     type => 'int'
3651     }
3652     ],
3653     [
3654     'resist_drain',
3655     {
3656     name => 'resist draining %',
3657     type => 'int'
3658     }
3659     ],
3660     [
3661     'resist_weaponmagic',
3662     {
3663     name => 'resist weaponmagic %',
3664     type => 'int'
3665     }
3666     ],
3667     [
3668     'resist_ghosthit',
3669     {
3670     name => 'resist ghosthit %',
3671     type => 'int'
3672     }
3673     ],
3674     [
3675     'resist_poison',
3676     {
3677     name => 'resist poison %',
3678     type => 'int'
3679     }
3680     ],
3681     [
3682     'resist_slow',
3683     {
3684     name => 'resist slow %',
3685     type => 'int'
3686     }
3687     ],
3688     [
3689     'resist_paralyze',
3690     {
3691     name => 'resist paralyze %',
3692     type => 'int'
3693     }
3694     ],
3695     [
3696     'resist_fear',
3697     {
3698     name => 'resist fear %',
3699     type => 'int'
3700     }
3701     ],
3702     [
3703     'resist_deplete',
3704     {
3705     name => 'resist depletion %',
3706     type => 'int'
3707     }
3708     ],
3709     [
3710     'resist_turn_undead',
3711     {
3712     name => 'resist turn undead %',
3713     type => 'int'
3714     }
3715     ],
3716     [
3717     'resist_death',
3718     {
3719     name => 'resist death-attack %',
3720     type => 'int'
3721     }
3722     ],
3723     [
3724     'resist_chaos',
3725     {
3726     name => 'resist chaos %',
3727     type => 'int'
3728     }
3729     ],
3730     [
3731     'resist_blind',
3732     {
3733     name => 'resist blinding %',
3734     type => 'int'
3735     }
3736     ],
3737     [
3738     'resist_holyword',
3739     {
3740     name => 'resist holy power %',
3741     type => 'int'
3742     }
3743     ],
3744     [
3745     'resist_godpower',
3746     {
3747     name => 'resist godpower %',
3748     type => 'int'
3749     }
3750     ]
3751     ]
3752     ]
3753     ],
3754     use => 'Spellcasting walls pose an interesting alternative to monsters. Usually they are set to be undestroyable. Thus, while monsters in a map can be cleared out, the magic walls remain. Low level characters for example will not be able to pass through their spell-area, hence they cannot loot a map that a high level character might have cleared out. <br><br> Another point of magic walls is that if the player dies, he has to face them all again. Magic walls can add a kind of "permanent thrill" to your maps. <br><br> Be careful that your magic walls don\'t kill the monsters on a map. If placing monsters, eventually take ones that are immune to the walls\' spell(s). <br><br> It is possible to make walls rotate when triggered. But that is so confusing (and useless IMHO) that I did not mention it above. You can find a working example on the map "/pup_land/castle_eureca/castle_eureca8".'
3755     },
3756     Marker => {
3757     attr => [
3758     [
3759     'no_pick',
3760     {
3761     type => 'fixed',
3762     value => 1
3763     }
3764     ],
3765     [
3766     'slaying',
3767     {
3768     desc => 'The <key string> can be detected by inv. checkers/detectors. If the player already has a force with that <key string>, there won\'t be inserted a second one.',
3769     name => 'key string',
3770     type => 'string'
3771     }
3772     ],
3773     [
3774     'connected',
3775     {
3776     desc => 'When the detector is triggered, all objects with the same connection value get activated.',
3777     name => 'connection',
3778     type => 'int'
3779     }
3780     ],
3781     [
3782     'speed',
3783 root 1.4 {
3784 root 1.7 desc => 'The <marking speed> defines how quickly it will mark something standing on the marker. Set this value rather high to make sure the player really gets his mark. I think <marking speed> 1.0 should do fine.',
3785     name => 'marking speed',
3786     type => 'float'
3787 root 1.4 }
3788     ],
3789     [
3790 root 1.17 'speed_left',
3791     {
3792     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
3793     name => 'speed left',
3794     type => 'float'
3795     }
3796     ],
3797     [
3798 root 1.7 'food',
3799     {
3800     desc => 'This value defines the duration of the force it inserts. If nonzero, the duration of the player\'s mark is finite: about 1 food per 10 seconds. <mark duration> zero/unset means the mark will stay on the player forever.',
3801     name => 'mark duration',
3802     type => 'int'
3803     }
3804     ],
3805     [
3806     'name',
3807     {
3808     desc => 'When the player steps onto the marker, all existing forces in the players inventory with a <key string> matching <delete mark> will be removed. If you don\'t want to remove any marks, leave this textfield empty. Note that the string <delete mark> is set as the name of this marker. So don\'t be confused, and remember changing the name will take effect on the marker\'s functionality.',
3809     name => 'delete mark',
3810     type => 'string'
3811     }
3812     ],
3813     [
3814     'msg',
3815 root 1.4 {
3816 root 1.7 desc => 'In the moment when the player gets marked, this text is displayed to him. You should really set a message in any marker you create, because it\'s the only way for the player to notice what\'s going on.',
3817     end => 'endmsg',
3818     name => 'marking message',
3819     type => 'text'
3820 root 1.4 }
3821     ]
3822     ],
3823 root 1.3 desc => 'A marker is an object that inserts an invisible force (a mark) into a player stepping on it. This force does nothing except containing a &lt;key string&gt; which can be discovered by detectors or inventory checkers. It is also possible to use markers for removing marks again. <br><br> Note that the player has no possibility to "see" his own marks, except by the effect that they cause on the maps.',
3824     ignore => [
3825     $IGNORE_LIST{system_object}
3826     ],
3827 root 1.5 name => 'Marker',
3828 root 1.3 use => 'Markers hold real cool possibilities for map-making. I encourage you to use them frequently. However there is one negative point about markers: Players don\'t "see" what\'s going on with them. It is your task, as map-creator, to make sure the player is always well informed and never confused. <br><br> Please avoid infinite markers when they aren\'t needed. They\'re using a little space in the player file after all, so if there is no real purpose, set an expire time.'
3829     },
3830     Misc => {
3831 root 1.7 attr => [
3832     [
3833 root 1.14 'move_block',
3834     {
3835     desc => 'Objects using these movement types cannot move over this space.',
3836     name => 'blocked movement',
3837     type => 'bitmask',
3838     value => $BITMASK{movement_type}
3839     }
3840     ],
3841     [
3842     'move_allow',
3843     {
3844     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
3845     name => 'allowed movement',
3846     type => 'bitmask',
3847     value => $BITMASK{movement_type}
3848     }
3849     ],
3850     [
3851     'move_slow',
3852 root 1.7 {
3853 root 1.14 desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
3854     name => 'slowed movement',
3855     type => 'bitmask',
3856     value => $BITMASK{movement_type}
3857     }
3858     ],
3859     [
3860     'move_slow_penalty',
3861     {
3862     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
3863     name => 'slow movement penalty',
3864     type => 'int'
3865 root 1.7 }
3866     ],
3867     [
3868     'cursed',
3869     {
3870     desc => 'Curses can have various effects: On equipment and food, they generally harm the player in some way.',
3871     name => 'cursed',
3872     type => 'bool'
3873     }
3874     ],
3875     [
3876     'damned',
3877     {
3878     desc => 'A damned item/floor on the ground makes it impossible for players to use prayers on that spot. It also prevents players from saving. Damnation on equipment works similar to a curse.',
3879     name => 'damned',
3880     type => 'bool'
3881     }
3882     ],
3883     [
3884     'unique',
3885     {
3886     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
3887     name => 'unique item',
3888     type => 'bool'
3889     }
3890     ],
3891     [
3892     'startequip',
3893     {
3894     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
3895     name => 'godgiven item',
3896     type => 'bool'
3897     }
3898     ],
3899     [
3900     'msg',
3901     {
3902     desc => 'This text may describe the object.',
3903     end => 'endmsg',
3904     name => 'description',
3905     type => 'text'
3906     }
3907     ]
3908     ],
3909 root 1.5 name => 'Misc'
3910 root 1.1 },
3911 root 1.3 Money => {
3912 root 1.7 attr => [
3913     [
3914     'race',
3915     {
3916     type => 'fixed',
3917     value => 'gold and jewels'
3918     }
3919     ]
3920     ],
3921 root 1.3 desc => 'Items of the type Money are handled as currency. Money cannot be sold/bought in shops. When money is dropped in a shop, it stays the same.<br> When a player picks an item from a shop and attempts to walk over the shop mat, the item\'s selling-price is automatically subtracted from the player\'s money. <br><br> For money, always use the default arches. Don\'t modify them.',
3922     ignore => [
3923     'unpaid'
3924 root 1.5 ],
3925     name => 'Money'
3926 root 1.3 },
3927     'Monster & NPC' => {
3928 root 1.7 attr => [
3929     [
3930     'alive',
3931     {
3932     type => 'fixed',
3933     value => 1
3934     }
3935     ],
3936     [
3937     'randomitems',
3938     {
3939     desc => 'When the monster is killed, items from the treasurelist will drop to the ground. This is a common way to reward players for killing (masses of) monsters. Note that you can always put items into the monster\'s inventory. Those will drop-at-kill just like the stuff from the <treasurelist>.',
3940     name => 'treasurelist',
3941     type => 'treasurelist'
3942     }
3943     ],
3944     [
3945     'level',
3946     {
3947     desc => 'A monster\'s <level> is the most important attribute. <level> affects the power of a monster in various ways.',
3948     name => 'level',
3949     type => 'int'
3950     }
3951     ],
3952     [
3953     'race',
3954     {
3955 root 1.17 desc => 'Every monster should have a race set to categorize it. The monster\'s <race> can have different effects: Slaying weapons inflict tripple damage against enemy races and holy word kills only enemy races of the god.',
3956 root 1.7 name => 'race',
3957     type => 'string'
3958     }
3959     ],
3960     [
3961     'exp',
3962     {
3963 root 1.17 desc => 'When a player kills this monster, he will get exactly this amount of <experience>. The experience will flow into the skill-category the player used for the kill. If you create special monsters of tweaked strenght/abilities, always make sure that the <experience> is set to a reasonable value. Compare with existing arches to get a feeling what reasonable means. Keep in mind that spellcasting monsters are a lot harder to kill than non-spellcasters!',
3964 root 1.7 name => 'experience',
3965     type => 'int'
3966     }
3967     ],
3968     [
3969     'speed',
3970     {
3971     desc => 'The <speed> determines how fast a monster will both move and fight. High <speed> makes a monster considerably stronger.',
3972     name => 'speed',
3973     type => 'float'
3974     }
3975     ],
3976     [
3977 root 1.17 'speed_left',
3978     {
3979     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
3980     name => 'speed left',
3981     type => 'float'
3982     }
3983     ],
3984     [
3985 root 1.7 'other_arch',
3986     {
3987     desc => 'This only takes effect if <multiply> is enabled. The monster will create a <breed monster> every once in a while. <breed monster> can be set to any valid arch-name of a monster. Multipart monster should not be used.',
3988     name => 'breed monster',
3989     type => 'string'
3990     }
3991     ],
3992     [
3993     'generator',
3994     {
3995     desc => 'Monsters with <generator> enabled will create a <breed monster> every once in a while. Mice are a good example for this effect. If enabled, you must also set <breed monster> or check <template generation> and put other monsters in the inventory.',
3996     name => 'multiply',
3997     type => 'bool'
3998     }
3999     ],
4000     [
4001     'use_content_on_gen',
4002     {
4003     desc => 'This only takes effect if <multiply> is enabled. The monster will create a new monster every once in a while by duplicating it\'s inventory. In this case, the <breed monster> value is never used and can be forgotten. Each time the monster need to generate an object, it will be a randomly chosen item from the inventory. When generator is destroyed, inventory is destroyed.',
4004     name => 'template generation',
4005     type => 'bool'
4006     }
4007     ],
4008     [
4009 root 1.14 'move_type',
4010 root 1.7 {
4011 root 1.14 desc => 'Determines which kinds of movement this object can use (e.g. for monsters) or grants (e.g. for amulets).',
4012     name => 'movement type',
4013     type => 'bitmask',
4014     value => $BITMASK{movement_type}
4015 root 1.7 }
4016     ],
4017     [
4018     'undead',
4019     {
4020     desc => 'Several spells only affect undead monsters: turn undead, banish undead, holy word, etc.',
4021     name => 'undead',
4022     type => 'bool'
4023     }
4024     ],
4025     [
4026     'carrying',
4027     {
4028     desc => 'If a monster has something in the inventory, this value can be set to reflect the slowdown due to the carried weight.',
4029     name => 'carries weight',
4030     type => 'int'
4031     }
4032     ],
4033     [
4034     'msg',
4035     {
4036     end => 'endmsg',
4037     name => 'npc message',
4038     type => 'text'
4039     }
4040     ]
4041     ],
4042 root 1.3 desc => 'Monsters can behave in various kinds of ways. They can be aggressive, attacking the player. Or peaceful, helping the player - maybe joining him as pet. The unagressive creatures who communicate with players are usually called "NPCs" (Non Player Character), a well-known term in role-play environments.',
4043     ignore => [
4044     'material',
4045     'name_pl',
4046     'nrof',
4047     'value',
4048     'unpaid'
4049     ],
4050 root 1.5 name => 'Monster & NPC',
4051 root 1.4 section => [
4052     [
4053     'melee',
4054 root 1.7 [
4055     [
4056     'attacktype',
4057     {
4058     desc => 'This number is a bitmask, specifying the monster\'s attacktypes for melee damage. Attacktypes are: physical, magical, fire, cold.. etc. Strong monsters often have more than just physical attacktype. When a monster with multiple attacktypes hits aan oponent, it will do as much damage as the "best" of it\'s attacktypes does. So, the more attacktypes, the more dangerous. Attacktypes "magic" and "chaos" are somehow exceptions.',
4059     name => 'attacktype',
4060     type => 'bitmask',
4061     value => $BITMASK{attacktype}
4062     }
4063     ],
4064     [
4065     'dam',
4066     {
4067     desc => 'Among other parameters, <damage> affects how much melee damage a monster inflicts. <damage> is used as base value for damage per hit. <level>, <speed>, <weapon class> and resistances also take effect on the melee damage of a monster.',
4068     name => 'damage',
4069     type => 'int'
4070     }
4071     ],
4072     [
4073     'wc',
4074     {
4075     desc => 'Monsters of high <weapon class> are more likely to really hit their opponent. <weapon class> can be considered the "counterpiece" to <armour class>.',
4076     name => 'weapon class',
4077     type => 'int'
4078     }
4079     ],
4080     [
4081     'hp',
4082     {
4083     desc => 'The <health points> of a monster define how long it takes to kill it. With every successful hit from an opponent, <health points> get drained - The monster dies by zero <health points>.',
4084     name => 'health points',
4085     type => 'int'
4086     }
4087     ],
4088     [
4089     'maxhp',
4090     {
4091     desc => '<max health> is the maximum amount of <health points> this monster can have.',
4092     name => 'max health',
4093     type => 'int'
4094     }
4095     ],
4096     [
4097     'ac',
4098     {
4099     desc => 'Monsters of low <armour class> are less likely to get hit from their opponent. <armour class> can be considered the "counterpiece" to <weapon class>. Values typically range between +20 (very bad) to -20 (quite good).',
4100     name => 'armour class',
4101     type => 'int'
4102     }
4103     ],
4104     [
4105     'Con',
4106     {
4107 root 1.8 desc => 'Monsters regenerate this many health points each 4 ticks. Hence, the healing rate is independent of <speed>.',
4108 root 1.7 name => 'healing rate',
4109     type => 'int'
4110     }
4111     ],
4112     [
4113     'reflect_missile',
4114     {
4115     desc => 'A monster with this flag has the ability to <reflect missiles>, all kinds of projectiles (e.g. arrows, bolts, boulders) will bounce off.',
4116     name => 'reflect missiles',
4117     type => 'bool'
4118     }
4119     ],
4120     [
4121     'hitback',
4122     {
4123     desc => 'Monsters with <hitback> enabled hurt the attacker in proportion to the amount of damage the *attacker* inflicted. This damage is additional to the regular melee damage of the monster. As far as I know, hitback uses acid attacktype, and it only takes effect if the monster actually has acid attacktype at it\'s disposal. Acid spheres for example use this feature.',
4124     name => 'hitback',
4125     type => 'bool'
4126     }
4127     ],
4128     [
4129     'one_hit',
4130     {
4131     desc => 'Monsters with <one hit only> dissapear after one successful hit to a player.',
4132     name => 'one hit only',
4133     type => 'bool'
4134     }
4135     ]
4136     ]
4137     ],
4138     [
4139     'spellcraft',
4140     [
4141     [
4142     'can_cast_spell',
4143     {
4144     desc => 'If <can cast spell> is disabled, the monster cannot cast any spell. Only wands/rods/etc can be used, given the appropriate abilities.',
4145     name => 'can cast spell',
4146     type => 'bool'
4147     }
4148     ],
4149     [
4150     'reflect_spell',
4151     {
4152     desc => 'A monster with this flag has the ability to <reflect spells>, all kinds of spell-bullets and -beams will bounce off. Generally this flag should not be set because it puts wizard-type players at an unfair disadvantage.',
4153     name => 'reflect spells',
4154     type => 'bool'
4155     }
4156     ],
4157     [
4158     'sp',
4159     {
4160     desc => 'Like players, monsters need <spellpoints> to do magic. Monsters use them for both wizard- and prayer-spells. However, this value defines only the amount of *initial* spellpoints the monster starts with. When creating a spellcasting monster, remember that <max spellpoints> and <spellpoint regen.> are more important than just initial <spellpoints>.',
4161     name => 'spellpoints',
4162     type => 'int'
4163     }
4164     ],
4165     [
4166     'maxsp',
4167     {
4168     desc => '<max spellpoints> is the maximum number of spellpoints a monster can hold. Setting this to high values has little effect unless the monster has a decent <spellpoint regen.>, or the spell "regenerate mana" at it\'s disposal.',
4169     name => 'max spellpoints',
4170     type => 'int'
4171     }
4172     ],
4173     [
4174     'Pow',
4175     {
4176 root 1.8 desc => 'Monsters regenerate this many spellpoints each 16 ticks. Hence, the spellpoint regeneration rate is independent of <speed>. To make a real tough spellcasting monster, the rate of spellpoint regeneration is most important. If your monster is still not casting fast enough, give it the spell-ability of "regenerate mana". That, paired with high <max spellpoints>, is the ultimate thing.',
4177 root 1.7 name => 'spellpoint regen.',
4178     type => 'int'
4179     }
4180     ],
4181     [
4182     'path_attuned',
4183     {
4184     desc => 'Click on the <attuned paths> button to select spellpaths. The creature will get attuned to the specified spellpaths.',
4185     name => 'attuned paths',
4186     type => 'bitmask',
4187     value => $BITMASK{spellpath}
4188     }
4189     ],
4190     [
4191     'path_repelled',
4192     {
4193     desc => 'Click on the <repelled paths> button to select spellpaths. The creature will get repelled to the specified spellpaths.',
4194     name => 'repelled paths',
4195     type => 'bitmask',
4196     value => $BITMASK{spellpath}
4197     }
4198     ],
4199     [
4200     'path_denied',
4201     {
4202     desc => 'Click on the <denied paths> button to select spellpaths. The creature won\'t be able to cast spells of the specified paths.',
4203     name => 'denied paths',
4204     type => 'bitmask',
4205     value => $BITMASK{spellpath}
4206     }
4207     ]
4208     ]
4209     ],
4210     [
4211     'ability',
4212     [
4213     [
4214     'Int',
4215     {
4216     desc => 'The <detect hidden> value gives monsters the ablitity to find hidden/invisible creatures. Higher values make for better detection-skills. Enabling <see invisible> makes this value obsolete.',
4217     name => 'detect hidden',
4218     type => 'int'
4219     }
4220     ],
4221     [
4222     'see_invisible',
4223     {
4224     desc => 'A monster with the ability to <see invisible> cannot be fooled with by invisible or hiding players. This flag is a must-have for high-level monsters. When a monster is unable to detect invisible players, it can be killed without fighting back.',
4225     name => 'see invisible',
4226     type => 'bool'
4227     }
4228     ],
4229     [
4230     'can_see_in_dark',
4231     {
4232     desc => 'A monster with the ability to <see in darkness> cannot be fooled by spells of darkness or dark maps. This flag is a "should-have" for high-level monsters. When a monster is unable to see in darkness, players can cast darkness and sneak around it safely.',
4233     name => 'see in darkness',
4234     type => 'bool'
4235     }
4236     ],
4237     [
4238     'can_use_weapon',
4239     {
4240     desc => 'Monster is able to wield weapon type objects.',
4241     name => 'can use weapons',
4242     type => 'bool'
4243     }
4244     ],
4245     [
4246     'can_use_bow',
4247     {
4248     desc => 'Monster is able to use missile-weapon type objects.',
4249     name => 'can use bows',
4250     type => 'bool'
4251     }
4252     ],
4253     [
4254     'can_use_armour',
4255     {
4256     desc => 'Monster is able to wear protective equipment like brestplate armour, shields, helmets etc.',
4257     name => 'can use armour',
4258     type => 'bool'
4259     }
4260     ],
4261     [
4262     'can_use_ring',
4263     {
4264     desc => 'Monster is able to wear rings.',
4265     name => 'can use rings',
4266     type => 'bool'
4267     }
4268     ],
4269     [
4270     'can_use_wand',
4271     {
4272     desc => 'Monster is able to use wands and staves.',
4273     name => 'can use wands',
4274     type => 'bool'
4275     }
4276     ],
4277     [
4278     'can_use_rod',
4279     {
4280     desc => 'Monster is able to use rods.',
4281     name => 'can use rods',
4282     type => 'bool'
4283     }
4284     ],
4285     [
4286     'can_use_scroll',
4287     {
4288     desc => 'Monster is able to read scrolls.',
4289     name => 'can use scrolls',
4290     type => 'bool'
4291     }
4292     ],
4293     [
4294     'can_use_skill',
4295     {
4296     desc => 'Monster is able to use skills from it\'s inventory. For example, you can put a throwing skill object and some boulders into the monster\'s object and set <can use skills>.',
4297     name => 'can use skills',
4298     type => 'bool'
4299     }
4300     ]
4301     ]
4302     ],
4303     [
4304     'behave',
4305     [
4306     [
4307     'monster',
4308     {
4309     desc => 'When <monster behaviour> is enabled, this object will behave like a monster: It can move and attack enemies (which are typically players). This flag should be set for all monsters as-such. Monsters which don\'t move, like guards, should also have <monster behaviour>, but in combination with <stand still>. It should *not* be set for things like immobile generators.',
4310     name => 'monster behaviour',
4311     type => 'bool'
4312     }
4313     ],
4314     [
4315     'unaggressive',
4316     {
4317     desc => '<unaggressive> monsters do not attack players unless attacked first.',
4318     name => 'unaggressive',
4319     type => 'bool'
4320     }
4321     ],
4322     [
4323     'friendly',
4324     {
4325     desc => '<friendly> monsters help the player, attacking any non-friendly monsters in range.',
4326     name => 'friendly',
4327     type => 'bool'
4328     }
4329     ],
4330     [
4331     'stand_still',
4332     {
4333     desc => 'Monsters which <stand still> won\'t move to leave their position. When agressive, they will attack all enemies who get close to them. This behaviour is commonly known from castle guards. In older versions of Crossfire it was possible to eventually push a <stand still>-monster out of position by force. I believe this is no longer possible. Neverthless, you should still be cautious when lining up <stand still>-monster in order to "defend" something: Such monsters are rather easy to kill. It\'s good for low level maps, but not much more.',
4334     name => 'stand still',
4335     type => 'bool'
4336     }
4337     ],
4338     [
4339     'sleep',
4340     {
4341     desc => 'Being <asleep>, a monster won\'t move unless a player enters the <sensing range> of the monster. Usually the sensing range is larger than the players line of sight. Due to that, in most cases the player won\'t ever notice weither a monster was asleep or not.',
4342     name => 'asleep',
4343     type => 'bool'
4344     }
4345     ],
4346     [
4347     'will_apply',
4348     {
4349     desc => 'This entry defines which kinds of environment actions the creature is able to perform.',
4350     name => 'misc. actions',
4351     type => 'bitmask',
4352     value => $BITMASK{will_apply}
4353     }
4354     ],
4355     [
4356     'pick_up',
4357     {
4358     desc => 'Click on the <pick up> button and select which types of objects the creature should try to pick up. Note also that if <can use armor>, <can use weapon>, <can use ring>... etc are set, then the creature will pick up the matching items even if this is not set here.',
4359     name => 'pick up',
4360     type => 'bitmask',
4361     value => $BITMASK{pick_up}
4362     }
4363     ],
4364     [
4365     'Wis',
4366     {
4367     desc => '<sensing range> determines how close a player needs to be before the creature wakes up. This is done as a square, for reasons of speed. Thus, if the <sensing range> is 11, any player that moves within the 11x11 square of the monster will wake the monster up. If the player has stealth, the size of this square is reduced in half plus 1.',
4368     name => 'sensing range',
4369     type => 'int'
4370     }
4371     ],
4372     [
4373 root 1.15 'attack_movement_bits_0_3',
4374 root 1.7 {
4375 root 1.15 desc => 'If this is set to default, the standard mode of movement will be used.',
4376 root 1.7 name => 'attack movement',
4377 root 1.15 type => 'list',
4378     value => $LIST{attack_movement_bits_0_3}
4379     }
4380     ],
4381     [
4382     'attack_movement_bits_4_7',
4383     {
4384     desc => 'This movement is not in effect when the monster has an enemy and should only be used for non agressive monsters.',
4385     name => 'normal movement',
4386     type => 'list',
4387     value => $LIST{attack_movement_bits_4_7}
4388 root 1.7 }
4389     ],
4390     [
4391     'run_away',
4392     {
4393     desc => 'This is a percentage value in the range 0-100. When the monster\'s health points drop below this percentage (relative to max health), it attempts to run away from the attacker.',
4394     name => 'run at % health',
4395     type => 'int'
4396     }
4397     ]
4398     ]
4399     ],
4400     [
4401     'resistance',
4402     [
4403     [
4404     'resist_physical',
4405     {
4406     name => 'resist physical %',
4407     type => 'int'
4408     }
4409     ],
4410     [
4411     'resist_magic',
4412     {
4413     name => 'resist magic %',
4414     type => 'int'
4415     }
4416     ],
4417     [
4418     'resist_fire',
4419     {
4420     name => 'resist fire %',
4421     type => 'int'
4422     }
4423     ],
4424     [
4425     'resist_electricity',
4426     {
4427     name => 'resist electricity %',
4428     type => 'int'
4429     }
4430     ],
4431     [
4432     'resist_cold',
4433     {
4434     name => 'resist cold %',
4435     type => 'int'
4436     }
4437     ],
4438     [
4439     'resist_confusion',
4440     {
4441     name => 'resist confusion %',
4442     type => 'int'
4443     }
4444     ],
4445     [
4446     'resist_acid',
4447     {
4448     name => 'resist acid %',
4449     type => 'int'
4450     }
4451     ],
4452     [
4453     'resist_drain',
4454     {
4455     name => 'resist draining %',
4456     type => 'int'
4457     }
4458     ],
4459     [
4460     'resist_weaponmagic',
4461     {
4462     name => 'resist weaponmagic %',
4463     type => 'int'
4464     }
4465     ],
4466     [
4467     'resist_ghosthit',
4468     {
4469     name => 'resist ghosthit %',
4470     type => 'int'
4471     }
4472     ],
4473     [
4474     'resist_poison',
4475     {
4476     name => 'resist poison %',
4477     type => 'int'
4478     }
4479     ],
4480     [
4481     'resist_slow',
4482     {
4483     name => 'resist slow %',
4484     type => 'int'
4485     }
4486     ],
4487     [
4488     'resist_paralyze',
4489     {
4490     name => 'resist paralyze %',
4491     type => 'int'
4492     }
4493     ],
4494     [
4495     'resist_fear',
4496     {
4497     name => 'resist fear %',
4498     type => 'int'
4499     }
4500     ],
4501     [
4502     'resist_deplete',
4503     {
4504     name => 'resist depletion %',
4505     type => 'int'
4506     }
4507     ],
4508     [
4509     'resist_turn_undead',
4510     {
4511     name => 'resist turn undead %',
4512     type => 'int'
4513     }
4514     ],
4515     [
4516     'resist_death',
4517     {
4518     name => 'resist death-attack %',
4519     type => 'int'
4520     }
4521     ],
4522     [
4523     'resist_chaos',
4524     {
4525     name => 'resist chaos %',
4526     type => 'int'
4527     }
4528     ],
4529     [
4530     'resist_blind',
4531     {
4532     name => 'resist blinding %',
4533     type => 'int'
4534     }
4535     ],
4536     [
4537     'resist_holyword',
4538     {
4539     name => 'resist holy power %',
4540     type => 'int'
4541     }
4542     ],
4543     [
4544     'resist_godpower',
4545     {
4546     name => 'resist godpower %',
4547     type => 'int'
4548     }
4549     ]
4550     ]
4551     ]
4552     ],
4553     use => 'Monsters play a central role in most maps. Choosing the right combination of monsters for your map is vital: <UL> <LI> Place only monsters of slightly varying (increasing) strength. It\'s no fun to play for two hours just to find out the last monster is unbeatable. Similar, it\'s not exciting to fight orcs after passing a room of dragons.<br> This rule applies only for linear maps (one room after the other), with treasure at the end. You can sprinkle the treasure around, or make non-linear maps - That is often more entertaining. <LI> Places with high level monsters must not be easy to reach. Balrogs, Dragonmen and the likes should be at the end of a quest, not at the beginning. <LI> Don\'t stick monsters together that tend to kill each other. Fire- and cold dragons in one room for example is a bad idea. By weakening and killing each other they are easy prey for players, not worth the experience they hold. <LI> Create your own monsters, especially for "boss"-type monsters. Having stage-bosses guarding treasure is a lot of fun when done right. Avoid to create monsters with completely non-intuitive abilities: Don\'t give ice-spells to firedragons or vice versa. Don\'t add draining attack to trolls, etc. Additionally, you should inform the player before he bumps right into some very special/unusual monster. <LI> Last but not least: Always keep an eye on the experience your monsters hold. Design your maps in a way that high experience is always well-defended. Don\'t make large rooms full with only one kind of monster. Keep in mind the different abilities/techniques players can use. </UL> I know it\'s impossible to make the perfectly balanced map. There\'s always some part which is found too easy or too hard for a certain kind of player. Just give it your best shot. And listen to feedback from players if you receive some. :-)'
4554     },
4555 root 1.9 'Monster (Grimreaper)' => {
4556     desc => 'A grimreaper is a monster that vanishes after it did some number of draining attacks.',
4557     ignore => [
4558     'material',
4559     'name_pl',
4560     'nrof',
4561     'value',
4562     'unpaid'
4563     ],
4564     import => [
4565     $TYPE{'Monster & NPC'}
4566     ],
4567     name => 'Monster (Grimreaper)',
4568     section => [
4569     [
4570     'grimreaper',
4571     [
4572     [
4573     'value',
4574     {
4575     desc => 'The object vanishes after this number of draining attacks.',
4576     name => 'attacks',
4577     type => 'int'
4578     }
4579     ]
4580     ]
4581     ]
4582     ]
4583     },
4584 root 1.7 'Mood Floor' => {
4585     attr => [
4586     [
4587     'no_pick',
4588 root 1.4 {
4589 root 1.7 type => 'fixed',
4590     value => 1
4591 root 1.4 }
4592     ],
4593     [
4594 root 1.7 'last_sp',
4595     {
4596     desc => '<mood> is used to determine what will happen to the monster when affected by the mood floor: <mood> \'furious\': Makes all monsters aggressive <mood> \'angry\': As above but pets are unaffected <mood> \'calm\': Makes all monsters unaggressive <mood> \'sleep\': Puts all monsters to sleep <mood> \'charm\': Turns monster into a pet of person who triggers the square. This setting is not enabled for continous operation, you need to insert a <connection> value!',
4597     name => 'mood',
4598     type => 'list',
4599     value => $LIST{mood}
4600     }
4601     ],
4602     [
4603     'connected',
4604     {
4605     desc => 'This should only be set in combination with <mood number> 4. Normally, monsters are affected by the mood floor as soon as they step on it. But charming (monster -> pet) is too powerful, so it needs to be activated. Typically it is connected to an altar, for buying a "hireling". But a powerful pet could as well be the reward for solving a quest. Or even better: It could be *part* of a quest!',
4606     name => 'connection',
4607     type => 'int'
4608     }
4609     ],
4610     [
4611     'no_magic',
4612     {
4613     desc => 'If enabled, it is impossible for players to use (wizard-) spells on that spot.',
4614     name => 'no spells',
4615     type => 'bool'
4616     }
4617     ],
4618     [
4619     'damned',
4620     {
4621     desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving.',
4622     name => 'no prayers',
4623     type => 'bool'
4624     }
4625     ]
4626     ],
4627     desc => 'As the name implies, mood floors can change the "mood" of a monsters/NPC. For example, an unagressive monster could be turned mad to start attacking. Similar, an agressive monster could be calmed.',
4628     ignore => [
4629     $IGNORE_LIST{system_object}
4630     ],
4631     name => 'Mood Floor',
4632     use => 'Mood floors are absolutely cool for NPC interaction. To make an unaggressive monster/NPC attack, put a creator with "other_arch furious_floor" under it. Connect the creator to a magic_ear, so the player speaks a keyword like "stupid sucker" - and the monster attacks. <br><br> To turn an NPC into a pet, put a charm_floor under it and connect it directly to a magic_ear. Then the player speaks a keyword like "help me" - and the NPC joins him as pet. <br><br> (Of course you must always give clear hints about keywords! And there is no reason why you couldn\'t use a button/lever/pedestal etc. instead of a magic_ear.)'
4633     },
4634     Mover => {
4635     attr => [
4636     [
4637     'attacktype',
4638     {
4639     desc => 'If forced movement is enabled, the mover "freezes" anyone it moves (so they are forced to move along a chain). For players there is no way to escape this forced movement, except being pushed by a second player.',
4640     name => 'forced movement',
4641     type => 'bool'
4642     }
4643     ],
4644     [
4645     'maxsp',
4646     {
4647     desc => 'The player will be "frozen" for that many moves. If <freeze duration> is zero, with <forced movement> enabled, then <freeze duration> gets assigned the "default value" 2 automatically.',
4648     name => 'freeze duration',
4649     type => 'int'
4650     }
4651     ],
4652     [
4653     'speed',
4654     {
4655     desc => 'The movement speed value determines how fast a chain of these movers will push a player along (default is -0.2).',
4656     name => 'movement speed',
4657     type => 'float'
4658     }
4659     ],
4660     [
4661 root 1.17 'speed_left',
4662     {
4663     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
4664     name => 'speed left',
4665     type => 'float'
4666     }
4667     ],
4668     [
4669 root 1.7 'sp',
4670     {
4671     desc => 'The mover will push creatures in the specified <direction>. A mover with direction set to <none> will spin clockwise, thus pushing creatures in unpredictable directions.',
4672     name => 'direction',
4673     type => 'list',
4674     value => $LIST{direction}
4675     }
4676     ],
4677     [
4678     'lifesave',
4679     {
4680 root 1.9 desc => 'If enabled, the mover gets "used up" after a certain number of moves (specified by <number of uses>). If disabled, the mover works infinitely.',
4681 root 1.7 name => 'gets used up',
4682     type => 'bool'
4683     }
4684     ],
4685     [
4686     'hp',
4687     {
4688     desc => 'This value has only a meaning if <gets used up> is set: <number of uses> is the number of times minus one, that it will move a creature before disappearing. (It will move someone <number of uses>+1 times, then vanish).',
4689     name => 'number of uses',
4690     type => 'int'
4691     }
4692     ]
4693     ],
4694     desc => 'Movers move the objects above them. However, only living objects are affected (monsters/NPCs always, players optional). Movers have a direction, so players can be made to move in a pattern, and so can monsters. Motion is involuntary. Additionally, players or monsters can be "frozen" while ontop of movers so that they MUST move along a chain of them. <br><br> Multisquare monsters can be moved as well, given enough space. Movers are usually invisible.',
4695     ignore => [
4696     $IGNORE_LIST{non_pickable}
4697     ],
4698     name => 'Mover',
4699     section => [
4700     [
4701     'targets',
4702     [
4703     [
4704     'level',
4705     {
4706     desc => 'If <move players> is enabled, both players and monsters will be moved. In the arches\' default it is disabled - thus ONLY monsters get moved. Remember that "monsters" includes NPCs! This feature provides you with the possibility to make NPCs literally "come to life". Example: The player is talking with an NPC, speaking a certain keyword. This triggers a magic_ear and activates creators, creating (per default: monster-only) movers under the NPC\'s feet. The NPC starts "walking" on a predefined route! Note that it\'s useful to set this NPC immune to everything, preventing the player to push the NPC off his trace.',
4707     name => 'move players',
4708     type => 'bool'
4709     }
4710     ],
4711     [
4712 root 1.14 'move_on',
4713 root 1.7 {
4714 root 1.14 desc => 'Which movement types activate the mover.',
4715     name => 'movement type',
4716     type => 'movement_type'
4717 root 1.7 }
4718     ]
4719     ]
4720     ]
4721     ],
4722     use => 'NEVER EVER consider a mover being unpassable in the backwards direction. Setting "forced movement" makes it seemingly impossible but there is still a trick: One player can push a second player past the mover, in opposite to the mover\'s direction! The more movers, the more players needed. Hence, don\'t make a treasure room that is surrounded by movers instead of solid walls/gates. <br><br> Btw, it does not make a difference putting movers above or below the floor. Moreover, movers that are set to be invisible cannot be discovered with the show_invisible spell. <br><br> Note that Movers and Directors are seperate objects, even though they look and act similar. Directors only do spells/missiles, while movers only do living creatures (depending on how it is set: monsters and players).'
4723     },
4724     Pedestal => {
4725     attr => [
4726     [
4727     'no_pick',
4728 root 1.4 {
4729 root 1.7 type => 'fixed',
4730     value => 1
4731 root 1.4 }
4732     ],
4733     [
4734 root 1.7 'slaying',
4735 root 1.4 {
4736 root 1.7 desc => 'the <match race> defines the object we\'re looking for. If <match race> matches the monster\'s or the player\'s race, we have a match. Yes, pedestals can detect a player\'s race! E.g. you could create a place where only fireborns can enter, by setting "slaying unnatural". If it is set to "player", any player stepping on the pedestal is a match. Very useful if you want to open a gate for players but not for monsters.',
4737     name => 'match race',
4738     type => 'string'
4739 root 1.4 }
4740     ],
4741     [
4742 root 1.7 'connected',
4743 root 1.4 {
4744 root 1.7 desc => 'When the pedestal is triggered, all objects with the same connection value get activated.',
4745     name => 'connection',
4746     type => 'int'
4747 root 1.4 }
4748     ],
4749     [
4750 root 1.14 'move_on',
4751 root 1.4 {
4752 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
4753     name => 'movement type',
4754     type => 'bitmask',
4755     value => $BITMASK{movement_type}
4756 root 1.4 }
4757     ]
4758     ],
4759 root 1.3 desc => 'Pedestals are designed to detect certain types of living objects. When a predefined type of living creature steps on the pedestal, the connected value is triggered.',
4760     ignore => [
4761     $IGNORE_LIST{non_pickable}
4762     ],
4763 root 1.5 name => 'Pedestal',
4764 root 1.3 use => 'If you want to create a place where only players of a certain race can enter, put a teleporter over your pedestal. So the teleporter is only activated for players of the matching race. Do not use gates, because many other players could sneak in. If you put powerful artifacts into such places, generally set "startequip 1", so that they are preserved for that one race and can\'t be traded to others.'
4765     },
4766     Pit => {
4767 root 1.7 attr => [
4768     [
4769     'no_pick',
4770     {
4771     type => 'fixed',
4772     value => 1
4773     }
4774     ],
4775     [
4776     'connected',
4777     {
4778     desc => 'When a <connection> value is set, the pit can be opened/closed by activating the connection.',
4779     name => 'connection',
4780     type => 'int'
4781     }
4782     ],
4783     [
4784 elmex 1.21 'activate_on_push',
4785     {
4786     desc => 'Whether the teleporter should only be activated on push.',
4787     name => 'Activate on push',
4788     type => 'bool'
4789     }
4790     ],
4791     [
4792     'activate_on_release',
4793     {
4794     desc => 'Whether the teleporter should only be activated on release.',
4795     name => 'Activate on release',
4796     type => 'bool'
4797     }
4798     ],
4799     [
4800 root 1.7 'hp',
4801     {
4802     desc => 'The pit will transport creatures (and items) randomly into a two-square radius of the destination coordinates. If the destination square becomes blocked, the pit will act like being filled up and not work anymore!',
4803     name => 'destination X',
4804     type => 'int'
4805     }
4806     ],
4807     [
4808     'sp',
4809     {
4810     desc => 'The pit will transport creatures (and items) randomly into a two-square radius of the destination coordinates. If the destination square becomes blocked, the pit will act like being filled up and not work anymore!',
4811     name => 'destination Y',
4812     type => 'int'
4813     }
4814     ],
4815     [
4816     'wc',
4817     {
4818     desc => 'The <position state> defines the position of the gate: Zero means completely open/down, the "number of animation-steps" (usually about 6 or 7) means completely closed/up state. I suggest you don\'t mess with this value - Leave the default in place.',
4819     name => 'position state',
4820     type => 'int'
4821     }
4822     ],
4823     [
4824 root 1.14 'move_on',
4825 root 1.7 {
4826 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
4827     name => 'movement type',
4828     type => 'bitmask',
4829     value => $BITMASK{movement_type}
4830 root 1.7 }
4831     ]
4832     ],
4833 root 1.3 desc => 'Pits are holes, transporting the player when he walks (and falls) into them. A speciality about pits is that they don\'t transport the player to the exact destination, but within a two-square radius of the destination (never on blocked squares).<br> Optionally, pits can get closed and opened, similar to gates.<br><br> Monsters and items are affected by pits just as well as players. Even multipart monsters can fall through them, given enough space.',
4834     ignore => [
4835     $IGNORE_LIST{non_pickable}
4836     ],
4837 root 1.5 name => 'Pit',
4838 root 1.3 use => 'Pits can add interesting effects to your map. When using them, make sure to use them in a "logical way": Pits should always drop the player to some kind of lower level. They should not be used to randomly interconnect maps like teleporters do.'
4839     },
4840     'Poison Food' => {
4841 root 1.5 desc => 'When eating, the player\'s stomache is drained by 1/4 of food. If his food drops to zero, the player might even die.',
4842     name => 'Poison Food'
4843 root 1.3 },
4844     Potion => {
4845 root 1.7 attr => [
4846     [
4847     'level',
4848     {
4849     desc => 'If the potion contains a spell, the spell is cast at this level. For other potions it should be set at least to 1.',
4850     name => 'potion level',
4851     type => 'int'
4852     }
4853     ],
4854     [
4855     'sp',
4856     {
4857     desc => 'When a player drinks this potion, the selected spell will be casted (once). This should work for any given spell. E.g. heal is "sp 35", magic power is "sp 67".',
4858     name => 'spell',
4859     type => 'spell'
4860     }
4861     ],
4862     [
4863     'attacktype',
4864     {
4865     desc => 'There are two types of special effects for potions: \'life restoration\' - restore the player\'s stats lost by death or draining (this has nothing in common with the restoration spell!) \'improvement\' - increase the player\'s maximum health/mana/grace by a very small amount.',
4866     name => 'special effect',
4867     type => 'list',
4868     value => $LIST{potion_effect}
4869     }
4870     ],
4871     [
4872     'cursed',
4873     {
4874     desc => 'If a potion is cursed, benefits generally turn into penalties. Note that potions can be "uncursed" by praying over an altar, with relative ease. *But* the potion must be identified to notice that it is cursed >:)',
4875     name => 'cursed',
4876     type => 'bool'
4877     }
4878     ],
4879     [
4880     'startequip',
4881     {
4882     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
4883     name => 'godgiven item',
4884     type => 'bool'
4885     }
4886     ]
4887     ],
4888 root 1.3 desc => 'The player can drink these and gain various kinds of benefits (/penalties) by doing so.',
4889 root 1.5 name => 'Potion',
4890 root 1.4 section => [
4891     [
4892     'stats',
4893 root 1.7 [
4894     [
4895     'Str',
4896     {
4897     desc => 'The player\'s strentgh will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4898     name => 'strength',
4899     type => 'int'
4900     }
4901     ],
4902     [
4903     'Dex',
4904     {
4905     desc => 'The player\'s dexterity will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4906     name => 'dexterity',
4907     type => 'int'
4908     }
4909     ],
4910     [
4911     'Con',
4912     {
4913     desc => 'The player\'s constitution will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4914     name => 'constitution',
4915     type => 'int'
4916     }
4917     ],
4918     [
4919     'Int',
4920     {
4921     desc => 'The player\'s intelligence will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4922     name => 'intelligence',
4923     type => 'int'
4924     }
4925     ],
4926     [
4927     'Pow',
4928     {
4929     desc => 'The player\'s power will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4930     name => 'power',
4931     type => 'int'
4932     }
4933     ],
4934     [
4935     'Wis',
4936     {
4937     desc => 'The player\'s wisdom will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4938     name => 'wisdom',
4939     type => 'int'
4940     }
4941     ],
4942     [
4943     'Cha',
4944     {
4945     desc => 'The player\'s charisma will rise/fall by the given value for permanent (of course there is an upper limit). Generally there shouldn\'t be stat potions granting more than one stat. Cursed potions will subtract the stats if positive.',
4946     name => 'charisma',
4947     type => 'int'
4948     }
4949     ]
4950     ]
4951     ],
4952     [
4953     'resistance',
4954     [
4955     [
4956     'resist_physical',
4957     {
4958     desc => 'The player\'s resistance to physical will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4959     name => 'resist physical %',
4960     type => 'int'
4961     }
4962     ],
4963     [
4964     'resist_magic',
4965     {
4966     desc => 'The player\'s resistance to magic will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4967     name => 'resist magic %',
4968     type => 'int'
4969     }
4970     ],
4971     [
4972     'resist_fire',
4973     {
4974     desc => 'The player\'s resistance to fire will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4975     name => 'resist fire %',
4976     type => 'int'
4977     }
4978     ],
4979     [
4980     'resist_electricity',
4981     {
4982     desc => 'The player\'s resistance to electricity will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4983     name => 'resist electricity %',
4984     type => 'int'
4985     }
4986     ],
4987     [
4988     'resist_cold',
4989     {
4990     desc => 'The player\'s resistance to cold will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4991     name => 'resist cold %',
4992     type => 'int'
4993     }
4994     ],
4995     [
4996     'resist_acid',
4997     {
4998     desc => 'The player\'s resistance to acid will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
4999     name => 'resist acid %',
5000     type => 'int'
5001     }
5002     ],
5003     [
5004     'resist_confusion',
5005     {
5006     desc => 'The player\'s resistance to confusion will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5007     name => 'resist confusion %',
5008     type => 'int'
5009     }
5010     ],
5011     [
5012     'resist_weaponmagic',
5013     {
5014     desc => 'The player\'s resistance to weaponmagic will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5015     name => 'resist weaponmagic %',
5016     type => 'int'
5017     }
5018     ],
5019     [
5020     'resist_paralyze',
5021     {
5022     desc => 'The player\'s resistance to paralyze will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5023     name => 'resist paralyze %',
5024     type => 'int'
5025     }
5026     ],
5027     [
5028     'resist_drain',
5029     {
5030     desc => 'The player\'s resistance to draining will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5031     name => 'resist draining %',
5032     type => 'int'
5033     }
5034     ],
5035     [
5036     'resist_deplete',
5037     {
5038     desc => 'The player\'s resistance to depletion will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5039     name => 'resist depletion %',
5040     type => 'int'
5041     }
5042     ],
5043     [
5044     'resist_poison',
5045     {
5046     desc => 'The player\'s resistance to poison will rise by this value in percent (range -100 till +100). The effect is only temporare, and it does NOT add on the values from the player\'s equipment. Cursed potions will make negative resistance.. very nasty in combat!',
5047     name => 'resist poison %',
5048     type => 'int'
5049     }
5050     ]
5051     ]
5052     ]
5053     ],
5054     use => 'One potion should never give multiple benefits at once.'
5055     },
5056     'Power Crystal' => {
5057     attr => [
5058     [
5059     'sp',
5060 root 1.4 {
5061 root 1.7 desc => '<initial mana> is the amount of spellpoints that the crystal holds when the map is loaded.',
5062     name => 'initial mana',
5063     type => 'int'
5064 root 1.4 }
5065     ],
5066     [
5067 root 1.7 'maxsp',
5068 root 1.4 {
5069 root 1.7 desc => 'The <mana capacity> defines how much mana can be stored in the crystal. This is what makes the crystal interesting. Wizard-players will always seek for crystals with large capacities.',
5070     name => 'mana capacity',
5071     type => 'int'
5072 root 1.4 }
5073     ]
5074     ],
5075 root 1.5 desc => 'Power crystals can store a player\'s mana: When the player applies the crystal with full mana, half of it flows into the crystal. When the player applies it with lacking mana, the crystal replenishes the player\'s mana.',
5076     name => 'Power Crystal'
5077 root 1.1 },
5078 root 1.3 Projectile => {
5079 root 1.7 attr => [
5080     [
5081     'attacktype',
5082     {
5083     desc => 'This number is a bitmask, specifying the projectile\'s attacktypes. Attacktypes are: physical, magical, fire, cold.. etc. This works identical to melee weapons. Note that shooting weapons cannot have attacktypes.',
5084     name => 'attacktype',
5085     type => 'bitmask',
5086     value => $BITMASK{attacktype}
5087     }
5088     ],
5089     [
5090     'race',
5091     {
5092     desc => 'Only shooting weapons with matching <ammunition class> can fire these projectiles. For arrows set "arrows", for crossbow bolts set "crossbow bolts" (big surprise). In certain cases, the ammunition class is displayed in the game. Hence, when you create a new ammunition class, choose an intuitive name like "missiles", "spirit bolts" - whatever. You can also make special containers holding these projectiles by setting the <container class> to match your <ammunition class>.',
5093     name => 'ammunition class',
5094     type => 'string'
5095     }
5096     ],
5097     [
5098     'slaying',
5099     {
5100     desc => 'Slaying means the weapon does tripple (3x) damage to monsters of the specified race. If <slaying race> matches an arch name, only monsters of that archtype receive tripple damage. Tripple damage is very effective.',
5101     name => 'slaying race',
5102     type => 'string'
5103     }
5104     ],
5105     [
5106     'dam',
5107     {
5108     desc => 'The projectile <damage> significantly affects the damage done. Damage can be further increased by the shooting weapon\'s attributes.',
5109     name => 'damage',
5110     type => 'int'
5111     }
5112     ],
5113     [
5114     'wc',
5115     {
5116     desc => 'This value is supposed to be the base <weaponclass>, but it seems to have rather little effect. High values are good here, low values bad.',
5117     name => 'weaponclass',
5118     type => 'int'
5119     }
5120     ],
5121     [
5122     'food',
5123     {
5124     desc => 'The <chance to break> defines the breaking probability when this projectile hits an obstacle, e.g. wall or monster. The value is the %-chance to break, ranging from 0 (never breaking) to 100 (breaking at first shot).',
5125     name => 'chance to break',
5126     type => 'int'
5127     }
5128     ],
5129     [
5130     'magic',
5131     {
5132     desc => 'Magic bonus increases chance to hit and damage a little bit.',
5133     name => 'magic bonus',
5134     type => 'int'
5135     }
5136     ],
5137     [
5138     'unique',
5139     {
5140     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
5141     name => 'unique item',
5142     type => 'bool'
5143     }
5144     ],
5145     [
5146     'startequip',
5147     {
5148     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
5149     name => 'godgiven item',
5150     type => 'bool'
5151     }
5152     ],
5153     [
5154     'no_drop',
5155     {
5156     desc => 'When a monster carries a projectile with <don\'t drop>, this item will never drop to the ground but vanish instead. If this object is shot, it can still drop after hitting an obstacle. You can prevent this by setting <chance to break> 100.',
5157     name => 'don\'t drop',
5158     type => 'bool'
5159     }
5160     ],
5161     [
5162     'msg',
5163     {
5164     desc => 'This text may describe the projectile. This could be nice for very special ones.',
5165     end => 'endmsg',
5166     name => 'description',
5167     type => 'text'
5168     }
5169     ]
5170     ],
5171     desc => 'Projectiles like arrows/crossbow bolts are used as ammunition for shooting weapons. <br><br> It\'s very easy to add new pairs of weapons &amp; projectiles. Just set matching &lt;ammunition class&gt; both for shooting weapon and projectile.',
5172     name => 'Projectile',
5173     use => 'If you want to create new kinds of projectiles, you could add an alchemical receipe to create these. Don\'t create new pairs of weapons &amp; projectiles unless they really fullfill a useful purpose. In fact, even bows and crossbows are rarely ever used.'
5174     },
5175     Ring => {
5176     desc => 'Rings are worn on the hands - one ring each. Wearing rings, the object\'s stats will directly be inherited to the player. Usually enhancing his spellcasting potential.',
5177     import => [
5178     $TYPE{Amulet}
5179     ],
5180     name => 'Ring',
5181     use => 'When you create an artifact ring, never forget that players can wear <B>two</B> rings! Due to that it is extremely important to keep rings in balance with the game. <br><br> Also keep in mind that rings are generally the wizard\'s tools. They should primarily grant bonuses to spellcasting abilities and non-physical resistances.'
5182     },
5183     Rod => {
5184     attr => [
5185     [
5186     'sp',
5187     {
5188     desc => 'Sets the <spell> of the rod. Consider twice before handing out special rods to players, since they can be used endlessly without any mana cost! Rods with heal/ restoration/ protection spells, IF available, MUST be very very VERY hard to get!',
5189     name => 'spell',
5190     type => 'spell'
5191     }
5192     ],
5193     [
5194     'level',
5195     {
5196     desc => 'The casting level of the <spell> determines it\'s power. For attack spells, level should be set to something reasonable.',
5197     name => 'casting level',
5198     type => 'int'
5199     }
5200     ],
5201     [
5202     'hp',
5203     {
5204     desc => 'This value represents the initial amount of spellpoints in the rod. Naturally, this is quite unimportant.',
5205     name => 'initial spellpoints',
5206     type => 'int'
5207     }
5208     ],
5209     [
5210     'maxhp',
5211     {
5212     desc => 'When the rod is fully charged up, it will hold this maximum amount of spellpoints. Make sure it is enough to cast the contained spell at least once. But don\'t set the value too high, as that might make the rod too effective.',
5213     name => 'max. spellpoints',
5214     type => 'int'
5215     }
5216     ],
5217     [
5218     'startequip',
5219     {
5220     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
5221     name => 'godgiven item',
5222     type => 'bool'
5223     }
5224     ],
5225     [
5226     'msg',
5227     {
5228     desc => 'This text may contain a description of the rod.',
5229     end => 'endmsg',
5230     name => 'description',
5231     type => 'text'
5232     }
5233     ]
5234     ],
5235     desc => 'A rod contains a spell. The player can use this spell by applying and fireing the rod. Rods need time to regenerate their "internal" spellpoints, lowering the effectiveness in combat. But unlike wands/scrolls, rods can be used endlessly.',
5236     ignore => [
5237     'title'
5238     ],
5239     name => 'Rod',
5240     use => 'Rods with healing/curing spells are extremely powerful. Usually, potions have to be used for that purpose. Though, potions are expensive and only good for one-time-use.<br>'
5241     },
5242     Rune => {
5243     attr => [
5244     [
5245     'no_pick',
5246     {
5247     type => 'fixed',
5248     value => 1
5249     }
5250     ],
5251     [
5252 root 1.14 'move_on',
5253 root 1.7 {
5254 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
5255     name => 'movement type',
5256     type => 'bitmask',
5257     value => $BITMASK{movement_type}
5258 root 1.7 }
5259     ],
5260     [
5261     'level',
5262     {
5263     desc => 'This value sets the level the rune will cast the spell it contains at, if applicable. A level 99 rune casts a very, very mean spell of whatever. (<rune level> 0 runes won\'t detonate at all!) Level Also effects how easily a rune may be found and disarmed, and how much experience the player gets for doing so. Beware: High level runes can be quite a cheap source of experience! So either make them tough, or keep the level low.',
5264     name => 'rune level',
5265     type => 'int'
5266     }
5267     ],
5268     [
5269     'Cha',
5270     {
5271     desc => 'This value determines what fraction of the time the rune is visible: It\'ll be randomly visible 1/<visibility> of the time. Also effects how easily the rune may be found.',
5272     name => 'visibility',
5273     type => 'int'
5274     }
5275     ],
5276     [
5277     'hp',
5278     {
5279     desc => 'The rune will detonate <number of charges> times before disappearing.',
5280     name => 'number of charges',
5281     type => 'int'
5282     }
5283     ],
5284     [
5285     'dam',
5286     {
5287     desc => '<direct damage> specifies how much damage is done by the rune, if it doesn\'t contain a spell. This should be set in reasonable relation to the rune\'s level.',
5288     name => 'direct damage',
5289     type => 'int'
5290     }
5291     ],
5292     [
5293     'attacktype',
5294     {
5295     desc => 'If there isn\'t any spell (and <summon monster> is unset), this attribute defines what attacktype to use for direct damage when the rune detonates.',
5296     name => 'attacktype',
5297     type => 'bitmask',
5298     value => $BITMASK{attacktype}
5299     }
5300     ],
5301     [
5302     'msg',
5303     {
5304     desc => 'When the rune detonates, this text is displayed to the victim. For especially powerful runes, create an appropriate thrilling description. ;)',
5305     end => 'endmsg',
5306     name => 'detonation text',
5307     type => 'text'
5308     }
5309     ]
5310 root 1.3 ],
5311     desc => 'A rune is a magical enscription on the dungeon floor. <br><br> Runes hit any monster or person who steps on them for \'dam\' damage in \'attacktype\' attacktype. Alternatively, the rune could contain any spell, and will cast this spell when it detonates. Yet another kind is the "summoning rune", summoning predefined monsters of any kind, at detonation. <br><br> Many runes are already defined in the archetypes.',
5312     ignore => [
5313     'no_pick',
5314     'title',
5315     'name_pl',
5316     'weight',
5317     'value',
5318     'material',
5319     'unpaid'
5320     ],
5321 root 1.5 name => 'Rune',
5322 root 1.4 section => [
5323     [
5324     'spellcraft',
5325 root 1.7 [
5326     [
5327     'sp',
5328     {
5329     desc => 'The selected <spell> defines the spell in the rune, if any. (Many runes do direct damage).',
5330     name => 'spell',
5331     type => 'spell'
5332     }
5333     ],
5334     [
5335     'slaying',
5336     {
5337     desc => 'Name of the spell in the rune, if any. <spell name> is optional, but if present, overrides the <spell> setting.',
5338     name => 'spell name',
5339     type => 'string'
5340     }
5341     ],
5342     [
5343     'other_arch',
5344     {
5345     desc => 'This string defines the spell in the rune, if any. <spell arch> is optional, but if present, overrides the <spell> setting. You can choose any of the existing arches.',
5346     name => 'spell arch',
5347     type => 'string'
5348     }
5349     ],
5350     [
5351     'maxsp',
5352     {
5353     desc => 'If set, the rune will cast it\'s containing spell (if any) in this <direction>.In most cases this appears useless because the spell directly hits the player.',
5354     name => 'direction',
5355     type => 'list',
5356     value => $LIST{direction}
5357     }
5358     ],
5359     [
5360     'race',
5361     {
5362     desc => 'If this is set to the arch name of any monster, together with <spell name> "summon evil monster", the rune will summon a bunch of those on detonation. (dam and attacktype will still be ignored in this case). Runes are even capable of summoning multi-square monsters, given enough space. You\'d better test it though.',
5363     name => 'summon monster',
5364     type => 'string'
5365     }
5366     ],
5367     [
5368     'maxhp',
5369     {
5370     desc => 'This should only be set to a summoning rune. It will then summon that many creatures of the kind <summon monster>.',
5371     name => 'summon amount',
5372     type => 'int'
5373     }
5374     ]
5375     ]
5376 root 1.4 ]
5377     ],
5378 root 1.3 use => 'Avoid monsters stepping on your runes. For example, summoning runes together with spellcasting- and attack-runes is usually a bad idea.'
5379     },
5380 elmex 1.23 'Safe ground (CF+)' => {
5381     attr => [
5382     [
5383     'no_pick',
5384     {
5385     type => 'fixed',
5386     value => 1
5387     }
5388     ]
5389     ],
5390 elmex 1.24 desc => 'Safe ground is a special object that prevents any effects that might be harmful for the map, other players or items on the map. It blocks all magic and prayers, usage of alchemy, prevents potions from being used and blocks bombs from exploding. Note that altars that do cast spells still work. (This is a Crossfire+ feature, and might not work elsewhere)',
5391 elmex 1.23 ignore => [
5392     $IGNORE_LIST{non_pickable}
5393     ],
5394     name => 'Safe ground (CF+)',
5395 elmex 1.24 use => 'Safe ground can be used to prevents any means of burning or destroying the items in a shop. Put this object below all floor tiles in your map and your shop will be safe. It\'s generally useful for making areas where really no kind of spell should be invoked by a player.'
5396 elmex 1.23 },
5397 root 1.3 Savebed => {
5398 root 1.7 attr => [
5399     [
5400     'no_pick',
5401     {
5402     type => 'fixed',
5403     value => 1
5404     }
5405     ],
5406     [
5407     'no_magic',
5408     {
5409     type => 'fixed',
5410     value => 1
5411     }
5412     ],
5413     [
5414     'damned',
5415     {
5416     type => 'fixed',
5417     value => 1
5418     }
5419     ]
5420     ],
5421 root 1.3 desc => 'When the player applies a savebed, he is not only saved. Both his respawn-after-death and his word-of-recall positions are pointing to the last-applied savebed.',
5422     ignore => [
5423     $IGNORE_LIST{non_pickable}
5424     ],
5425 root 1.5 name => 'Savebed',
5426 root 1.3 use => 'Put savebed locations in towns, do not put them into dungeons. It is absolutely neccessary that a place with savebeds is 100% secure. That means: <UL> <LI> Monsters must not be able to reach the savebeds under any circumstances! <LI> If there are NPCs around, make sure they have the friendly-flag set. <LI> Insert a relyable exit! Make sure there is no possibility that players get trapped in a savebed location. <LI> If possible, mark the whole site as no-spell area (Insert this arch called "dungeon_magic" everywhere). This is not required, but it makes the place much more safe. </UL>'
5427     },
5428     Scroll => {
5429 root 1.7 attr => [
5430     [
5431     'level',
5432     {
5433     desc => 'The spell of the scroll will be casted at this level. This value should always be set, at least to 1.',
5434     name => 'casting level',
5435     type => 'int'
5436     }
5437     ],
5438     [
5439     'sp',
5440     {
5441     desc => 'When a player/monster applies this scroll, the selected <spell> will be casted (once). This should work for any given spell.',
5442     name => 'spell',
5443     type => 'spell'
5444     }
5445     ],
5446     [
5447     'startequip',
5448     {
5449     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
5450     name => 'godgiven item',
5451     type => 'bool'
5452     }
5453     ]
5454     ],
5455 root 1.3 desc => 'Scrolls contain spells (similar to spell-potions). Unlike potions, scrolls require a certain literacy skill to read successfully. Accordingly, for a successful reading, a small amount of experience is gained. Scrolls allow only one time usage, but usually they are sold in bulks.',
5456     ignore => [
5457     'title'
5458     ],
5459 root 1.5 name => 'Scroll',
5460 root 1.3 use => 'For low level quests, scrolls of healing/curing-spells can be a nice reward. At higher levels, scrolls become less and less useful.'
5461     },
5462     Shield => {
5463 root 1.7 attr => [
5464     [
5465     'magic',
5466     {
5467     desc => '<magic bonus> works just like ac, except that it can be improved by "scrolls of Enchant Armour" or reduced by acid. It is less useful than direct armour-class bonus on the shield.',
5468     name => 'magic bonus',
5469     type => 'int'
5470     }
5471     ]
5472     ],
5473 root 1.3 desc => 'Wearing a shield, the object\'s stats will directly be inherited to the player. Shields usually provide good defense, only surpassed by brestplate armour. Resistances on shields aren\'t uncommon either.',
5474     import => [
5475     $TYPE{Amulet}
5476     ],
5477 root 1.5 name => 'Shield',
5478 root 1.3 use => 'Feel free to create your own special artifacts. However, it is very important that you keep your artifact in balance with existing maps.'
5479     },
5480     'Shooting Weapon' => {
5481 root 1.7 attr => [
5482     [
5483     'race',
5484     {
5485     desc => 'Only projectiles with matching <ammunition class> can be fired with this weapon. For normal bows set "arrows", for normal crossbows set "crossbow bolts". In certain cases, the ammunition class is displayed in the game. Hence, when you create a new ammunition class, choose an intuitive name like "missiles", "spirit bolts" - whatever.',
5486     name => 'ammunition class',
5487     type => 'string'
5488     }
5489     ],
5490     [
5491     'sp',
5492     {
5493     desc => 'After shooting a projectile, the player is frozen for a short period of time (to prevent shooting arrows machine-gun-like). The greater <shooting speed>, the shorter this period of time. 1 is minimum (=worst) and 100 is maximum (=best) value. You shouldn\'t set <shooting speed> lower than 10. YOU MUST NOT SET IT TO ZERO! (That would freeze the player for eternety).',
5494     name => 'shooting speed',
5495     type => 'int'
5496     }
5497     ],
5498     [
5499     'dam',
5500     {
5501     desc => 'The <base damage> significantly affects the damage done by using this weapon. This damage is added to the projectile damage and then (if <ignore strength> disabled) a bonus according to the player\'s strength is added.',
5502     name => 'base damage',
5503     type => 'int'
5504     }
5505     ],
5506     [
5507     'wc',
5508     {
5509     desc => 'This value is supposed to be the base <weaponclass>, but it seems to have rather little effect. High values are good here, low values bad.',
5510     name => 'weaponclass',
5511     type => 'int'
5512     }
5513     ],
5514     [
5515     'item_power',
5516     {
5517     desc => 'The <item power> value measures how "powerful" an artifact is. Players will only be able to wear equipment with a certain total amount of <item power>, depending on their own level. This is the only way to prevent low level players to wear "undeserved" equipment (like gifts from other players or cheated items). It is very important to adjust the <item power> value carefully for every artifact you create! If zero/unset, the CF server will calculate a provisional value at runtime, but this is never going to be an accurate measurement of <item power>.',
5518     name => 'item power',
5519     type => 'int'
5520     }
5521     ],
5522     [
5523     'no_strength',
5524     {
5525     desc => 'Usually the player\'s strentgh takes effect on the damage done by the shooting weapon. If <ignore strength> is set, the player\'s strength is ignored.',
5526     name => 'ignore strength',
5527     type => 'bool'
5528     }
5529     ],
5530     [
5531     'damned',
5532     {
5533     desc => 'A damned shooting weapon cannot be unwielded unless the curse is removed. Removing damnations is a tick harder than removing curses.',
5534     name => 'damnation',
5535     type => 'bool'
5536     }
5537     ],
5538     [
5539     'cursed',
5540     {
5541     desc => 'A cursed shooting weapon cannot be unwielded unless the curse is removed.',
5542     name => 'curse',
5543     type => 'bool'
5544     }
5545     ],
5546     [
5547     'unique',
5548     {
5549     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
5550     name => 'unique item',
5551     type => 'bool'
5552     }
5553     ],
5554     [
5555     'startequip',
5556     {
5557     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
5558     name => 'godgiven item',
5559     type => 'bool'
5560     }
5561     ],
5562     [
5563     'msg',
5564     {
5565     desc => 'This text describes the weapons\'s "story". Every decent artifact weapon should have such a description.',
5566     end => 'endmsg',
5567     name => 'description',
5568     type => 'text'
5569     }
5570     ]
5571     ],
5572 elmex 1.22 desc => 'Shooting weapons like bows/crossbows are used to shoot projectiles (arrows/bolts). Shooting weapons and normal (melee) weapons can be wielded both at the same time. Like with any other equipment, stats/bonuses from shooting weapons are directly inherited to the player. <br><br> It\'s very easy to add new pairs of weapons &amp; projectiles. Just set matching &lt;ammunition class&gt; both for shooting weapon and projectile.',
5573 root 1.5 name => 'Shooting Weapon',
5574 root 1.4 section => [
5575     [
5576     'stats',
5577 root 1.7 [
5578     [
5579     'Str',
5580     {
5581     desc => 'The player\'s strentgh will rise/fall by the given value while wearing this shooting weapon.',
5582     name => 'strength',
5583     type => 'int'
5584     }
5585     ],
5586     [
5587     'Dex',
5588     {
5589     desc => 'The player\'s dexterity will rise/fall by the given value while wearing this shooting weapon.',
5590     name => 'dexterity',
5591     type => 'int'
5592     }
5593     ],
5594     [
5595     'Con',
5596     {
5597     desc => 'The player\'s constitution will rise/fall by the given value while wearing this shooting weapon.',
5598     name => 'constitution',
5599     type => 'int'
5600     }
5601     ],
5602     [
5603     'Int',
5604     {
5605     desc => 'The player\'s intelligence will rise/fall by the given value while wearing this shooting weapon.',
5606     name => 'intelligence',
5607     type => 'int'
5608     }
5609     ],
5610     [
5611     'Pow',
5612     {
5613     desc => 'The player\'s power will rise/fall by the given value while wearing this shooting weapon.',
5614     name => 'power',
5615     type => 'int'
5616     }
5617     ],
5618     [
5619     'Wis',
5620     {
5621     desc => 'The player\'s wisdom will rise/fall by the given value while wearing this shooting weapon.',
5622     name => 'wisdom',
5623     type => 'int'
5624     }
5625     ],
5626     [
5627     'Cha',
5628     {
5629     desc => 'The player\'s charisma will rise/fall by the given value while wearing this shooting weapon.',
5630     name => 'charisma',
5631     type => 'int'
5632     }
5633     ]
5634     ]
5635     ],
5636     [
5637     'bonus',
5638     [
5639     [
5640     'luck',
5641     {
5642     desc => 'With positive luck bonus, the player is more likely to succeed in all sorts of things (spellcasting, praying,...). Unless the <luck bonus> is very high, the effect will be barely visible in-game. Luck bonus on one piece of equipment should never exceed 3, and such bonus should not be too frequently available.',
5643     name => 'luck bonus',
5644     type => 'int'
5645     }
5646     ],
5647     [
5648     'magic',
5649     {
5650     desc => '<Magic bonus> improves the quality of the shooting weapon. I\'m not sure what exactly is increased - maybe weaponclass? However, <magic bonus> seems to have a little bit of positive influence on your chance to hit.',
5651     name => 'magic bonus',
5652     type => 'int'
5653     }
5654     ]
5655     ]
5656     ]
5657     ],
5658 elmex 1.22 use => 'Shooting weapons should not add bonuses in general. There\'s already enough "equipment-slots" doing that: swords, rings, amulets, girdles etc. Shooting weapons should especially not add bonuses to the player that have nothing to do with schooting. A Wisdom bonus on a bow is crap for example! A name like "Longbow of great Wisdom" doesn\'t help - still crap.'
5659 root 1.7 },
5660     'Shop Floor' => {
5661     attr => [
5662     [
5663     'is_floor',
5664     {
5665     type => 'fixed',
5666     value => 1
5667     }
5668     ],
5669     [
5670     'no_pick',
5671     {
5672     type => 'fixed',
5673     value => 1
5674     }
5675     ],
5676     [
5677     'no_magic',
5678     {
5679     type => 'fixed',
5680     value => 1
5681     }
5682     ],
5683     [
5684     'auto_apply',
5685 root 1.4 {
5686 root 1.7 desc => 'If enabled, items will appear on this square when the map is loaded. You need to specify a <treasurelist> to define what kinds of items are generated. The items will be unpaid.',
5687     name => 'generate goods',
5688     type => 'bool'
5689 root 1.4 }
5690     ],
5691     [
5692 root 1.7 'randomitems',
5693     {
5694     desc => 'This entry determines what kind of treasure will appear, when <generate goods> is enabled. Look into /crossfire/share/crossfire/treasures for details about existing treasurelists.',
5695     name => 'treasurelist',
5696     type => 'treasurelist'
5697     }
5698     ],
5699     [
5700     'exp',
5701     {
5702     desc => 'The <quality level> will be used for the quality of the generated goods. If zero/unset, <quality level> 5 is used. Usually this value doesn\'t need to be set, unless you want extraordinarily good/bad quality. If you want to make a shop with very high quality, meaybe charge an entrance fee, or make the shop hard-to-come-by. Note that <quality level> mainly affects chance of magic bonus and appearance of artifact-items.',
5703     name => 'quality level',
5704     type => 'int'
5705     }
5706     ],
5707     [
5708     'damned',
5709 root 1.4 {
5710 root 1.7 desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving. (Remember that <no magic> is always set for shop floors.)',
5711     name => 'no prayers',
5712     type => 'bool'
5713 root 1.4 }
5714     ]
5715     ],
5716 root 1.3 desc => 'Shop floor is used for shops. It acts like a combination of the common floor- and the treasure type: When the map is loaded, randomitems (depending on the setings) are generated on it. These items are all flagged as unpaid. When a player drops an item onto shop floor, the item becomes unpaid and the player receives payment according to the item\'s selling-value. Shopfloor always prevents magic (To hinder players from burning or freezing the goods).',
5717     ignore => [
5718     $IGNORE_LIST{non_pickable}
5719     ],
5720 root 1.5 name => 'Shop Floor',
5721 root 1.3 use => 'Tile your whole shop-interior space which shop floor. (That assures players receive payment for dropping items). Place shop mats to enter/leave the shop, and make sure there is no other exit than the shop mat.'
5722     },
5723     'Shop Mat' => {
5724 root 1.7 attr => [
5725     [
5726     'no_pick',
5727     {
5728     type => 'fixed',
5729     value => 1
5730     }
5731     ],
5732     [
5733 root 1.14 'move_on',
5734 root 1.7 {
5735 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
5736     name => 'movement type',
5737     type => 'bitmask',
5738     value => $BITMASK{movement_type}
5739 root 1.7 }
5740     ]
5741     ],
5742 root 1.3 desc => 'Shop mats are used for entering/leaving shops. You should always have exactly TWO shop mats on your shop-map: One inside the "shopping-area" and one outside. Shop mats don\'t use exit paths/ or -destinations. When stepping onto a shopmat the player gets beamed to the nearest other mat. If the player has unpaid items in his inventory, the price gets charged from his coins automatically. If the player has insufficient coins to buy his unpaid items, he is unable to pass any shopmat (So he has to drop unpaid items).',
5743     ignore => [
5744     $IGNORE_LIST{non_pickable}
5745     ],
5746 root 1.5 name => 'Shop Mat',
5747 root 1.3 use => 'As stated above, always place TWO shop mats into your shop. Not more and not less than that.'
5748     },
5749     'Sign & MagicMouth' => {
5750 root 1.7 attr => [
5751     [
5752     'connected',
5753     {
5754     desc => 'When a connection value is set, the message will be printed whenever the connection is triggered. This should be used in combination with <invisible> enabled and <activate by walking/flying> disabled. If activating your magic_mouth this way, the message will not only be printed to one player, but all players on the current map.',
5755     name => 'connection',
5756     type => 'int'
5757     }
5758     ],
5759     [
5760 elmex 1.21 'activate_on_push',
5761     {
5762     desc => 'Whether the teleporter should only be activated on push.',
5763     name => 'Activate on push',
5764     type => 'bool'
5765     }
5766     ],
5767     [
5768     'activate_on_release',
5769     {
5770     desc => 'Whether the teleporter should only be activated on release.',
5771     name => 'Activate on release',
5772     type => 'bool'
5773     }
5774     ],
5775     [
5776 root 1.14 'move_on',
5777 root 1.7 {
5778 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
5779     name => 'movement type',
5780     type => 'bitmask',
5781     value => $BITMASK{movement_type}
5782 root 1.7 }
5783     ],
5784     [
5785     'food',
5786     {
5787     desc => 'If a counter-value is set (greater zero), the sign/magic_mouth can be applied (printing the message) only that many times. For signs this really shouldn\'t be used, while for magic_mouths it is extremely helpful. Monsters walking over the magic_mouth do not decrease the counter. Often, you might want to have a message displayed only one time. For example: The player enters your map and you put a magic_mouth to tell him about the monsters and how dangerous they look and all. Later, when all the monsters are killed and the player leaves the map, displaying the same message a second time would be silly. <counter> 1 does a perfect job in such cases. Otherwise set <counter> zero/unset for infinite use (that is the default).',
5788     name => 'counter',
5789     type => 'int'
5790     }
5791     ],
5792     [
5793     'msg',
5794     {
5795     desc => 'This text will be displayed to the player.',
5796     end => 'endmsg',
5797     name => 'message',
5798     type => 'text'
5799     }
5800     ]
5801     ],
5802     desc => 'The purpose of a sign or magic_mouth is to display a certain message to the player. There are three ways to have the player get this message: The player walking onto it (-&gt; magic_mouth), the player pressing &lt;a&gt;pply (-&gt; sign) or the player triggering a button/handle/etc (-&gt; magic_mouth).',
5803     ignore => [
5804     $IGNORE_LIST{non_pickable}
5805     ],
5806     name => 'Sign & MagicMouth',
5807     use => 'Use signs and magic_mouths, plenty of them! Place magic_mouths to add some true roleplay feeling to your maps, support your storyline or give hints about hidden secrets/dangers. Place signs to provide the player with all kinds of useful information for getting along in your maps.'
5808     },
5809     Skill => {
5810     attr => [
5811     [
5812     'invisible',
5813     {
5814     type => 'fixed',
5815     value => 1
5816     }
5817     ],
5818     [
5819     'no_drop',
5820     {
5821     type => 'fixed',
5822     value => 1
5823     }
5824     ],
5825     [
5826     'skill',
5827     {
5828     desc => 'The <skill name> is used for matchings. When a usable object has an identical <skill name>, players (or monsters) will need this skill to apply/use the object.',
5829     name => 'skill name',
5830     type => 'string'
5831     }
5832     ],
5833     [
5834     'expmul',
5835     {
5836     desc => 'This is the ratio of experience the players total should increase by when this skill is used. If this is zero, then experience only goes to to the skill. Values higher than 1 are allowed. Note that experience rewarded to the players total is in addition to that given to the skill. Eg, if player should get 500 exp for using a skill, and expmul is 1, the player will get 500 added to that skill as well as 500 to their total.',
5837     name => 'exp multiplier',
5838     type => 'float'
5839     }
5840     ],
5841     [
5842     'subtype',
5843     {
5844     desc => 'The <skill type> defines the base functionality of the skill. Skill types are hardcoded in the Crossfire server. It isn\'t hard to create new skill types, but it requires a bit of server-coding.',
5845     name => 'skill type',
5846     type => 'list',
5847     value => $LIST{skill_type}
5848     }
5849     ],
5850     [
5851     'level',
5852     {
5853     name => 'level',
5854     type => 'int'
5855     }
5856     ],
5857     [
5858     'exp',
5859     {
5860     name => 'experience',
5861     type => 'int'
5862     }
5863     ],
5864     [
5865     'can_use_skill',
5866     {
5867     desc => 'The <is native skill> flag has an effect only when this skill object is placed in the inventory of a monster (or player). If it is set, the monster or player knows the skill natively, which means he does not need a skill tool to use it.',
5868     name => 'is native skill',
5869     type => 'bool'
5870     }
5871     ]
5872 root 1.3 ],
5873     desc => 'Skills are objects which exist in the player/monster inventory. Both NPC/monsters and players use the same skill archetypes. Not all skills are enabled for monster use however.',
5874     ignore => [
5875     $IGNORE_LIST{system_object}
5876     ],
5877 root 1.5 name => 'Skill',
5878 root 1.3 use => 'For mapmaking, Skill objects serve two purposes: <p>First, the predefined skill archtypes (in the \'skills\' directory) can be seen as the global skill definitions. A skill which doesn\'t exists as an archtype cannot be learned or used by players. When you want to use skills in your maps, you may need to look up the &lt;skill name&gt;s of defined skill archtypes, because those strings are used as a reference in many skill-related objects. </p><p> Secondly, in order to enable monsters to use skills, you will need to copy default skill archtypes into the monsters\' inventories. You can even customize the skills by changing stats. It is not recommended however, to use skills in your maps which are totally unrelated to any predefined skill archtype.</p>'
5879     },
5880     'Skill Scroll' => {
5881 root 1.7 attr => [
5882     [
5883     'race',
5884     {
5885     type => 'fixed',
5886     value => 'scrolls'
5887     }
5888     ],
5889     [
5890     'skill',
5891     {
5892     desc => 'The <skill name> matches the skill object that can be learned from this scroll.',
5893     name => 'skill name',
5894     type => 'string'
5895     }
5896     ]
5897     ],
5898 root 1.3 desc => 'By reading a skill scroll, a player has a chance to learn the contained skill.',
5899 root 1.5 name => 'Skill Scroll',
5900 root 1.3 use => 'Skill scrolls are very much sought for by players. Currently, all skill scrolls are sold in shops randomly, which is in fact not a good system. It would be nice to have some cool quests with skill scrolls rewarded at the end.'
5901     },
5902     'Special Key' => {
5903 root 1.7 attr => [
5904     [
5905     'slaying',
5906     {
5907     desc => 'This string must be identical with the <key string> in the locked door, then it can be unlocked. It can also be used to trigger inventory checkers.',
5908     name => 'key string',
5909     type => 'string'
5910     }
5911     ],
5912     [
5913     'material',
5914     {
5915     desc => 'For Special Keys, material should always be unset or set to Adamantite. This prevents the key from getting burned or otherwise destroyed.',
5916     name => 'material',
5917     type => 'bitmask',
5918     value => $BITMASK{material}
5919     }
5920     ],
5921     [
5922     'unique',
5923     {
5924     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good. This can be used if you want to sell apartments on your map: Simply sell a unique passport/key, and place an inventory checker at the entrance of your apartment.',
5925     name => 'unique item',
5926     type => 'bool'
5927     }
5928     ],
5929     [
5930     'startequip',
5931     {
5932     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
5933     name => 'godgiven item',
5934     type => 'bool'
5935     }
5936     ],
5937     [
5938     'msg',
5939     {
5940     desc => 'This will add a description to the object. The player can read this text by clicking on the item in his inventory. Use this message to describe what the key/passport is good for. A player might have 50 different keys on his key-ring. Don\'t expect players to recall their purpose just by their names.',
5941     end => 'endmsg',
5942     name => 'description',
5943     type => 'text'
5944     }
5945     ]
5946     ],
5947 root 1.3 desc => 'When carrying the appropriate special key, a locked door can be opened. The key will dissapear. <br><br> This object-type can also be used for "passport"-like items: When walking onto an invetory checker, a gate for example might get opened. The "passport" will stay in the player\'s inventory.',
5948     ignore => [
5949     'material'
5950     ],
5951 root 1.5 name => 'Special Key',
5952 root 1.3 use => 'How to make a "passport": You take the special key arch (archetype name is "key2"), set the face to something like card.111 and the name to "passport" - that\'s all. The &lt;key string&gt; certainly must match with the appropiate inventory checker. <br><br> Of course you can be creative with names and faces of key-objects. A "mysterious crystal" or a "big dragon claw" (with appropriate faces) appear more interesting than just a "strange key", or "passport".'
5953     },
5954     Spell => {
5955 root 1.7 attr => [
5956     [
5957     'no_drop',
5958     {
5959     type => 'fixed',
5960     value => 1
5961     }
5962     ],
5963     [
5964     'invisible',
5965     {
5966     type => 'fixed',
5967     value => 1
5968     }
5969     ],
5970     [
5971     'skill',
5972     {
5973     desc => 'The <skill name> matches the skill which is needed to cast this spell. This should be one out of "sorcery", "pyromancy", "evocation", "summoning" or "praying". If you want to fiddle with these, please take care not to upset the concept and balance of the various skills.',
5974     name => 'skill name',
5975     type => 'string'
5976     }
5977     ],
5978     [
5979     'subtype',
5980     {
5981     desc => 'The <spell type> defines the basic type of spell. Some of these types are of a more generic nature than others.',
5982     name => 'spell type',
5983     type => 'list',
5984     value => $LIST{spell_type}
5985     }
5986     ],
5987     [
5988     'level',
5989     {
5990     name => 'spell level',
5991     type => 'int'
5992     }
5993     ],
5994     [
5995     'casting_time',
5996     {
5997     name => 'casting time',
5998     type => 'int'
5999     }
6000     ],
6001     [
6002     'duration',
6003     {
6004     name => 'duration',
6005     type => 'int'
6006     }
6007     ],
6008     [
6009     'other_arch',
6010     {
6011     name => 'create object',
6012     type => 'string'
6013     }
6014     ],
6015     [
6016     'sp',
6017     {
6018     name => 'cost spellpoints',
6019     type => 'int'
6020     }
6021     ],
6022     [
6023     'grace',
6024     {
6025     name => 'cost grace',
6026     type => 'int'
6027     }
6028     ],
6029     [
6030     'maxsp',
6031     {
6032     name => 'double cost per level',
6033     type => 'int'
6034     }
6035     ]
6036     ],
6037 root 1.3 desc => 'Spell objects define a spell. When a spell is put in a spellbook, players can learn it by reading the book. Once learned, players can use the spell as often as they like. With increasing skill level of the player, spells may gain power but also increase cost.<br> Monsters can use spells which are put in their inventory (provided that certain "enabling" settings are correct). The monster\'s &lt;treasurelist&gt; can also be used to provide it with spells.',
6038     ignore => [
6039     $IGNORE_LIST{system_object}
6040     ],
6041 root 1.5 name => 'Spell',
6042 root 1.3 use => 'A lot of the spells\' settings can be tuned and customized. When creating new spells which are accessible to players, it is important to think about balance. A single spell which is too powerful and/or too easy to use can eventually toss the whole skill and magic school system out of whack. Testing new spells is quite important therefore.'
6043     },
6044     Spellbook => {
6045 root 1.7 attr => [
6046     [
6047     'skill',
6048     {
6049     type => 'fixed',
6050     value => 'literacy'
6051     }
6052     ],
6053     [
6054     'randomitems',
6055     {
6056     desc => 'There are two ways to put spells into a spellbook: 1. Put a spell object in the books inventory. In this case, treasurelist must be set to <none>. 2. Choose a treasurelist which contains spells. In that way, a spell will be chosen randomly from the list.',
6057     name => 'treasurelist',
6058     type => 'treasurelist'
6059     }
6060     ],
6061     [
6062     'startequip',
6063     {
6064     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
6065     name => 'godgiven item',
6066     type => 'bool'
6067     }
6068     ],
6069     [
6070     'msg',
6071     {
6072     desc => 'This text may contain a nice description of the spellbook\'s cover or something.',
6073     end => 'endmsg',
6074     name => 'description',
6075     type => 'text'
6076     }
6077     ]
6078     ],
6079 root 1.3 desc => 'By reading a spellbook, the player has a chance of learning the contained spell. Once learned from a book, the spell is available forever. Spellbooks with high level spells require some skill-level to read.<br><br> You can create widely customized spells only by adjusting the spell object in the spellbooks inventory. Refer to the description of spell objects for detailed information how to customize spells.<br> If you want to have a random spellbook instead, choose a &lt;treasurelist&gt; with a compilation of spells that the book may contain.',
6080 root 1.5 name => 'Spellbook',
6081 root 1.3 use => 'Don\'t put any of the godgiven spells into a spellbook! These are reserved for the followers of the appropriate cults. Handing them out in a spellbook would violate the balance between different religions. <br><br> Note that there is no fundamental difference between the spellbooks of varying schools (pyromancy, sorcery, evocation, summoning, and even praying). The difference lies only in the spells they contain. It is up to you, the mapmaker, to pick the right type of book for your spells.'
6082     },
6083     Spinner => {
6084 root 1.7 attr => [
6085     [
6086     'sp',
6087     {
6088     desc => 'The spinner will change the direction of flying objects by 45 degrees per <direction number>. Negative values spin clockwise, positive values counter clockwise. Example: <direction number> -2 means spin 90 degrees clockwise.',
6089     name => 'direction number',
6090     type => 'int'
6091     }
6092     ],
6093     [
6094 root 1.14 'move_on',
6095 root 1.7 {
6096 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
6097     name => 'movement type',
6098     type => 'bitmask',
6099     value => $BITMASK{movement_type}
6100 root 1.7 }
6101     ]
6102     ],
6103 root 1.3 desc => 'Spinners change the direction of spell objects and other projectiles that fly past. Unlike directors, it does make a difference from what angle you shoot into the spinner. The direction of objects flying past is always changed by a certain degree.',
6104     ignore => [
6105     $IGNORE_LIST{non_pickable}
6106     ],
6107 root 1.5 name => 'Spinner',
6108 root 1.3 use => 'Spinners are very rarely used. I believe they are quite confusing and pointless. The only use I can think of is building some puzzle about where to shoot into spinners to shoot somewhere you otherwise couldn\'t. When placing spinners on a map with magic walls, make sure the spell- projectiles from magic walls don\'t get to fly in loops.'
6109     },
6110     Swamp => {
6111 root 1.7 attr => [
6112     [
6113     'is_floor',
6114     {
6115     type => 'fixed',
6116     value => 1
6117     }
6118     ],
6119     [
6120     'is_wooded',
6121     {
6122     type => 'fixed',
6123     value => 1
6124     }
6125     ],
6126     [
6127     'speed',
6128     {
6129     desc => 'The higher the <drowning speed>, the faster will players and items sink into the swamp. Swamp with very high <drowning speed> can be a nasty and unexpected death-trap. Players should get a warning before such areas.',
6130     name => 'drowning speed',
6131     type => 'float'
6132     }
6133     ],
6134     [
6135 root 1.17 'speed_left',
6136     {
6137     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
6138     name => 'speed left',
6139     type => 'float'
6140     }
6141     ],
6142     [
6143 root 1.14 'move_on',
6144     {
6145     desc => 'Which movement types automatically (as opposed to manually) activate this object.',
6146     name => 'movement type',
6147     type => 'bitmask',
6148     value => $BITMASK{movement_type}
6149     }
6150     ],
6151     [
6152     'move_block',
6153 root 1.7 {
6154 root 1.14 desc => 'Objects using these movement types cannot move over this space.',
6155     name => 'blocked movement',
6156     type => 'bitmask',
6157     value => $BITMASK{movement_type}
6158     }
6159     ],
6160     [
6161     'move_allow',
6162     {
6163     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
6164     name => 'allowed movement',
6165     type => 'bitmask',
6166     value => $BITMASK{movement_type}
6167     }
6168     ],
6169     [
6170     'move_slow',
6171     {
6172     desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
6173     name => 'slowed movement',
6174     type => 'bitmask',
6175     value => $BITMASK{movement_type}
6176     }
6177     ],
6178     [
6179     'move_slow_penalty',
6180     {
6181     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
6182     name => 'slow movement penalty',
6183 root 1.7 type => 'int'
6184     }
6185     ],
6186     [
6187     'no_magic',
6188     {
6189     desc => 'If enabled, it is impossible for players to use (wizard-) spells on that spot.',
6190     name => 'no spells',
6191     type => 'bool'
6192     }
6193     ],
6194     [
6195     'damned',
6196     {
6197     desc => 'If enabled, it is impossible for players to use prayers on that spot. It also prevents players from saving.',
6198     name => 'no prayers',
6199     type => 'bool'
6200     }
6201     ]
6202     ],
6203 root 1.3 desc => 'Swamp areas show a special behaviour: When a player stands still on a swamp-square for too long, he will start to sink in and eventually drown and die. Items dropped on the swamp sink in and dissapear. Players with knowledge of the woodsman skill are a lot less likely to die in the swamp.',
6204     ignore => [
6205     $IGNORE_LIST{non_pickable}
6206 root 1.5 ],
6207     name => 'Swamp'
6208 root 1.3 },
6209     Teleporter => {
6210 root 1.7 attr => [
6211     [
6212     'slaying',
6213     {
6214     desc => 'The exit path specifies the map that the player is transferred to. <exit path> can be an absolute path, beginning with \'/\' (for example "/peterm/FireTemple/fire1"). It can also be a relative path, not beginning with \'/\' (On the map "/peterm/FireTemple/Fire2" for example I could use the relative path "Fire1"). Use relative paths whenever possible! Note that upper/lower case must always be set correctly. However, please use lower case only. If the <exit path> is set, ONLY players can get teleported. If the <exit path> is unset (empty), anything can get teleported: Players, monsters and items. In this case, the destined map is automatically the same map the teleporter is on.',
6215     name => 'exit path',
6216     type => 'string'
6217     }
6218     ],
6219     [
6220     'hp',
6221     {
6222     desc => 'The exit destinations define the (x, y)-coordinates where the exit leads to. If both are set to zero and <exit path> is empty, the player will get teleported to another, randomly chosen teleporter on the same map (Slightly confusing for the player though). Make sure there actually *is* a second one in that case. If both are set to zero and <exit path> is set, the player will be transferred to the "default enter location" of the destined map. The latter can be set in the map-properties as "Enter X/Y". Though, please DO NOT use that. It turned out to be a source for numerous map-bugs.',
6223     name => 'destination X',
6224     type => 'int'
6225     }
6226     ],
6227     [
6228     'sp',
6229     {
6230     desc => 'The exit destinations define the (x, y)-coordinates where the exit leads to. If both are set to zero and <exit path> is empty, the player will get teleported to another, randomly chosen teleporter on the same map (Slightly confusing for the player though). Make sure there actually *is* a second one in that case. If both are set to zero and <exit path> is set, the player will be transferred to the "default enter location" of the destined map. The latter can be set in the map-properties as "Enter X/Y". Though, please DO NOT use that. It turned out to be a source for numerous map-bugs.',
6231     name => 'destination Y',
6232     type => 'int'
6233     }
6234     ],
6235     [
6236     'connected',
6237     {
6238     desc => 'If a connection value is set, the teleporter will be activated whenever the connection is triggered. To use this properly, <activation speed> must be zero.',
6239     name => 'connection',
6240     type => 'int'
6241     }
6242     ],
6243     [
6244 elmex 1.21 'activate_on_push',
6245     {
6246     desc => 'Whether the teleporter should only be activated on push.',
6247     name => 'Activate on push',
6248     type => 'bool'
6249     }
6250     ],
6251     [
6252     'activate_on_release',
6253     {
6254     desc => 'Whether the teleporter should only be activated on release.',
6255     name => 'Activate on release',
6256     type => 'bool'
6257     }
6258     ],
6259     [
6260 root 1.7 'speed',
6261     {
6262     desc => 'If the <activation speed> is nonzero, the teleporter will automatically be activated in regular time-intervals. Hence, the player can just step on it and gets teleported sooner or later. The duration between two activates depends on the given value. Default in the teleporter arch is <activation speed> 0.1. VERY IMPORTANT: If you want to have your teleporter activated via button/handle/magic_ear/etc, you must set <activation speed> to zero!',
6263     name => 'activation speed',
6264     type => 'float'
6265     }
6266 root 1.17 ],
6267     [
6268     'speed_left',
6269     {
6270     desc => 'The speed left to the object. On every tick, if this value is higher than 0, the object acts/triggers/moves etc. and the value gets decremented by 1. Otherwise, it is incremented by <speed> on every tick.',
6271     name => 'speed left',
6272     type => 'float'
6273     }
6274 root 1.7 ]
6275     ],
6276 root 1.3 desc => 'When the player walks into a teleporter, he is transferred to a different location. The main difference to the object-type exit is the possibility to have teleporters connected to levers/buttons/etc. Sometimes teleporters are activated even against the players will. <br><br> Unlike exits, teleporters can also transfer items and monsters to different locations on the same map.',
6277     ignore => [
6278     $IGNORE_LIST{non_pickable}
6279     ],
6280 root 1.5 name => 'Teleporter',
6281 root 1.3 use => 'When creating maps, I guess sooner or later you\'ll want to have an invisible teleporter. If using "invisible 1", the teleporter can still be discovered with the show_invisible spell. And in some cases you can\'t place it under the floor to prevent this. <br><br> Fortunately, there is a cool trick to make a perfectly invisible teleporter: You simply add teleporter functionality to the floor itself. That means: You take the floor arch (e.g. "flagstone"), set "type 41", and add slaying/hp/sp/connected... everything you need.'
6282     },
6283 root 1.8 'Timed Gate' => {
6284     attr => [
6285     [
6286     'no_pick',
6287     {
6288     type => 'fixed',
6289     value => 1
6290     }
6291     ],
6292     [
6293     'connected',
6294     {
6295     desc => 'Whenever the inventory checker is triggered, all objects with identical <connection> value get activated. This only makes sense together with <blocking passage> disabled. If unset, the gate opens automatically after some time.',
6296     name => 'connection',
6297     type => 'int'
6298     }
6299     ],
6300     [
6301 elmex 1.21 'activate_on_push',
6302     {
6303     desc => 'Whether the teleporter should only be activated on push.',
6304     name => 'Activate on push',
6305     type => 'bool'
6306     }
6307     ],
6308     [
6309     'activate_on_release',
6310     {
6311     desc => 'Whether the teleporter should only be activated on release.',
6312     name => 'Activate on release',
6313     type => 'bool'
6314     }
6315     ],
6316     [
6317 root 1.8 'wc',
6318     {
6319     desc => 'The <position state> defines the position of the gate: Zero means completely open/down, the "number of animation-steps" (usually about 6 or 7) means completely closed/up state. I suggest you don\'t mess with this value - Leave the default in place.',
6320     name => 'position state',
6321     type => 'int'
6322     }
6323     ],
6324     [
6325 root 1.14 'move_block',
6326     {
6327     desc => 'Objects using these movement types cannot move over this space.',
6328     name => 'blocked movement',
6329     type => 'bitmask',
6330     value => $BITMASK{movement_type}
6331     }
6332     ],
6333     [
6334     'move_allow',
6335     {
6336     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
6337     name => 'allowed movement',
6338     type => 'bitmask',
6339     value => $BITMASK{movement_type}
6340     }
6341     ],
6342     [
6343     'move_slow',
6344 root 1.8 {
6345 root 1.14 desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
6346     name => 'slowed movement',
6347     type => 'bitmask',
6348     value => $BITMASK{movement_type}
6349     }
6350     ],
6351     [
6352     'move_slow_penalty',
6353     {
6354     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
6355     name => 'slow movement penalty',
6356     type => 'int'
6357 root 1.8 }
6358     ],
6359     [
6360     'no_magic',
6361     {
6362     desc => 'Restricting the use of spells to pass this gate. This has an effect only if <block view> is disabled.',
6363     name => 'restrict spells',
6364     type => 'bool'
6365     }
6366     ],
6367     [
6368     'damned',
6369     {
6370     desc => 'Restricting the use of prayers to pass this door. This has an effect only if <block view> is disabled.',
6371     name => 'restrict prayers',
6372     type => 'bool'
6373     }
6374     ],
6375     [
6376     'hp',
6377     {
6378     desc => 'Defines the duration the gate remains closed. This only takes effect if the gate is not connected.',
6379     name => 'open duration',
6380     type => 'int'
6381     }
6382     ]
6383     ],
6384     desc => 'Gates play an important role in Crossfire. Gates can be opened by activating a button/trigger, by speaking passwords (-> magic_ear) or carrying special key-objects (-> inventory checker). Unlike locked doors, gates can get shut again after a player has passed, which makes them more practical in many cases. Unlike normal gates, timed gates open when triggered but automatically close again after some time.',
6385     ignore => [
6386     $IGNORE_LIST{non_pickable}
6387     ],
6388     name => 'Timed Gate',
6389     use => 'Use gates to divide your maps into separated areas. After solving area A, the player gains access to area B, and so on. Make your maps more complex than "one-way".'
6390     },
6391 root 1.3 Trap => {
6392 root 1.7 attr => [
6393     [
6394     'no_pick',
6395     {
6396     type => 'fixed',
6397     value => 1
6398     }
6399     ],
6400     [
6401 root 1.14 'move_on',
6402 root 1.7 {
6403 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
6404     name => 'movement type',
6405     type => 'bitmask',
6406     value => $BITMASK{movement_type}
6407 root 1.7 }
6408     ],
6409     [
6410     'level',
6411     {
6412     desc => 'Level effects how easily a trap may be found and disarmed, and how much experience the player gets for doing so. Beware: High level traps can be quite a cheap source of experience! So either make them tough, or keep the level low.',
6413     name => 'trap level',
6414     type => 'int'
6415     }
6416     ],
6417     [
6418     'Cha',
6419     {
6420     desc => 'This value determines what fraction of the time the trap is visible: It\'ll be randomly visible 1/<visibility> of the time. Also effects how easily the trap may be found.',
6421     name => 'visibility',
6422     type => 'int'
6423     }
6424     ],
6425     [
6426     'hp',
6427     {
6428     desc => 'The trap will detonate <number of charges> times before disappearing.',
6429     name => 'number of charges',
6430     type => 'int'
6431     }
6432     ],
6433     [
6434     'dam',
6435     {
6436     desc => '<direct damage> specifies how much damage is done by the trap. This should be set in reasonable relation to the trap\'s level.',
6437     name => 'direct damage',
6438     type => 'int'
6439     }
6440     ],
6441     [
6442     'attacktype',
6443     {
6444     desc => 'This attribute defines what attacktype to use for direct damage when the trap detonates.',
6445     name => 'attacktype',
6446     type => 'bitmask',
6447     value => $BITMASK{attacktype}
6448     }
6449     ],
6450     [
6451     'connected',
6452     {
6453     desc => 'When the trap is detonated, all objects with the same connection value get activated.',
6454     name => 'connection',
6455     type => 'int'
6456     }
6457     ],
6458     [
6459     'msg',
6460     {
6461     desc => 'When the trap detonates, this text is displayed to the victim. For especially powerful or complex traps, create an appropriate and thrilling description. ;)',
6462     end => 'endmsg',
6463     name => 'detonation text',
6464     type => 'text'
6465     }
6466     ]
6467     ],
6468 root 1.3 desc => 'A trap is a object that can either do damage or trigger another connected object when detonated. Traps are like runes except they are not magical in nature, and generally have either a physical attack or trigger a reaction. <br><br> Traps hit any monster or person who steps on them for \'dam\' damage in \'attacktype\' attacktype and/or trigger a reaction. <br><br> Many traps are already defined in the archetypes.',
6469     ignore => [
6470     'no_pick',
6471     'title',
6472     'name_pl',
6473     'weight',
6474     'value',
6475     'material',
6476     'unpaid'
6477     ],
6478 root 1.5 name => 'Trap',
6479 root 1.3 use => 'Avoid monsters stepping on your traps. For example, a party of orcs setting off your lightning wall and pit trap is usually a bad idea.'
6480     },
6481     Trapdoor => {
6482 root 1.7 attr => [
6483     [
6484     'no_pick',
6485     {
6486     type => 'fixed',
6487     value => 1
6488     }
6489     ],
6490     [
6491 root 1.14 'move_on',
6492 root 1.7 {
6493 root 1.14 desc => 'Which movement types automatically (as opposed to manually) activate this object.',
6494     name => 'movement type',
6495     type => 'bitmask',
6496     value => $BITMASK{movement_type}
6497 root 1.7 }
6498     ],
6499     [
6500     'weight',
6501     {
6502     desc => 'This value defines how much weight the trapdoor can hold. Once items or creatures are gathered on the trapdoor, with a total weight surpassing this value, then the trapdoor will open and things start falling through.',
6503     name => 'hold weight',
6504     type => 'int'
6505     }
6506     ],
6507     [
6508     'hp',
6509     {
6510     desc => 'The trapdoor will transport creatures (and items) randomly into a two-square radius of the destination coordinates. If the destination square becomes blocked, the trapdoor will act like being filled up and not work anymore!',
6511     name => 'destination X',
6512     type => 'int'
6513     }
6514     ],
6515     [
6516     'sp',
6517     {
6518     desc => 'The trapdoor will transport creatures (and items) randomly into a two-square radius of the destination coordinates. If the destination square becomes blocked, the trapdoor will act like being filled up and not work anymore!',
6519     name => 'destination Y',
6520     type => 'int'
6521     }
6522     ]
6523     ],
6524 root 1.3 desc => 'Trapdoors are very similar to pits. The difference is that they can not be closed. Instead, the weight of the object on the trapdoor determines weither it slams the trapdoor open and falls through or not.<br> Once a trapdoor has been opened (by a creature or items of sufficient weight,) it remains open, acting like an opened pit.',
6525     ignore => [
6526     $IGNORE_LIST{non_pickable}
6527     ],
6528 root 1.5 name => 'Trapdoor',
6529 root 1.3 use => 'Trapdoors should be used in the same fashion as pits: They should always drop the victims to some kind of lower level. They are not supposed to be used to randomly interconnect maps like teleporters.'
6530     },
6531     Treasure => {
6532 root 1.7 attr => [
6533     [
6534     'randomitems',
6535     {
6536     desc => 'This entry determines what kind of treasure will appear. Look into /crossfire/share/crossfire/treasures for details about existing treasurelists.',
6537     name => 'treasurelist',
6538     type => 'treasurelist'
6539     }
6540     ],
6541     [
6542     'auto_apply',
6543     {
6544     desc => '"Auto-generate" must be set in order to have the treasure be created when the map is loaded. If you want to create a random treasure chest, you unset this flag. That way, the player has to apply the object (the chest), then the treasure is generated.',
6545     name => 'auto-generate',
6546     type => 'bool'
6547     }
6548     ],
6549     [
6550     'hp',
6551     {
6552     desc => '"Create number" specifies how many pieces of the given treasurelist will appear. Note that for every piece there is a chance that nothing is generated. Also, sometimes there can be stacks of items generated, like for gems/money.',
6553     name => 'create number',
6554     type => 'int'
6555     }
6556     ],
6557     [
6558     'exp',
6559     {
6560     desc => 'The <quality level> will be used for the quality of the generated treasure instead of the map difficulty (as was done with shops). If zero/unset, the map difficulty will instead be used. (Example for comparison: Shop floors generate treasure of <quality level> 5 per default).',
6561     name => 'quality level',
6562     type => 'int'
6563     }
6564     ]
6565     ],
6566 root 1.3 desc => 'A treasure-object turns into certain randomitems when the map is loaded into the game.',
6567     ignore => [
6568     'nrof',
6569     'title',
6570     'name_pl',
6571     'weight',
6572     'value',
6573     'material'
6574     ],
6575 root 1.5 name => 'Treasure',
6576 root 1.3 use => 'About usage of the "random-artifact" treasurelist: This will generate powerful stuff like girdles, xray helmets, special swords etc. If you put this as reward to your quest, players might be motivated to do it more than once. BUT, by doing so they will get a huge number of different artifacts! Besides, players will always seek the place with the most easy-to-get random artifact and ignore all others. My advice: Don\'t use it! Attract players with good fighting experience (from monsters), potions, spellbooks, money, and non-random artifacts.'
6577     },
6578     'Trigger Marker' => {
6579 root 1.7 attr => [
6580     [
6581     'no_pick',
6582     {
6583     type => 'fixed',
6584     value => 1
6585     }
6586     ],
6587     [
6588     'slaying',
6589     {
6590     desc => 'The <key string> can be detected by inv. checkers/detectors. If the player already has a force with that <key string>, there won\'t be inserted a second one.',
6591     name => 'key string',
6592     type => 'string'
6593     }
6594     ],
6595     [
6596     'connected',
6597     {
6598     desc => 'Unlike a regular marker this is the connection that triggers this marker to activate.',
6599     name => 'connection',
6600     type => 'int'
6601     }
6602     ],
6603     [
6604     'food',
6605     {
6606     desc => 'This value defines the duration of the force it inserts. If nonzero, the duration of the player\'s mark is finite: about 1 food per 10 seconds. <mark duration> zero/unset means the mark will stay on the player forever.',
6607     name => 'mark duration',
6608     type => 'int'
6609     }
6610     ],
6611     [
6612     'name',
6613     {
6614     desc => 'When the player steps onto the marker, all existing forces in the players inventory with a <key string> matching <delete mark> will be removed. If you don\'t want to remove any marks, leave this textfield empty. Note that the string <delete mark> is set as the name of this marker. So don\'t be confused, and remember changing the name will take effect on the marker\'s functionality.',
6615     name => 'delete mark',
6616     type => 'string'
6617     }
6618     ],
6619     [
6620     'msg',
6621     {
6622     desc => 'In the moment when the player gets marked, this text is displayed to him. You should really set a message in any marker you create, because it\'s the only way for the player to notice what\'s going on.',
6623     end => 'endmsg',
6624     name => 'marking message',
6625     type => 'text'
6626     }
6627     ]
6628     ],
6629 root 1.3 desc => 'A trigger marker is an object that inserts an invisible force (a mark) into a player stepping on it WHEN TRIGGERED. This force does nothing except containing a &lt;key string&gt; which can be discovered by detectors or inventory checkers. It is also possible to use markers for removing marks again. <br><br> Note that the player has no possibility to "see" his own marks, except by the effect that they cause on the maps.',
6630     ignore => [
6631     $IGNORE_LIST{system_object}
6632     ],
6633 root 1.5 name => 'Trigger Marker',
6634 root 1.3 use => 'Markers hold real cool possibilities for map-making. I encourage you to use them frequently. However there is one negative point about markers: Players don\'t "see" what\'s going on with them. It is your task, as map-creator, to make sure the player is always well informed and never confused. <br><br> Please avoid infinite markers when they aren\'t needed. They\'re using a little space in the player file after all, so if there is no real purpose, set an expire time.'
6635     },
6636     Wall => {
6637 root 1.7 attr => [
6638     [
6639 root 1.14 'move_block',
6640     {
6641     desc => 'Objects using these movement types cannot move over this space.',
6642     name => 'blocked movement',
6643     type => 'bitmask',
6644     value => $BITMASK{movement_type}
6645     }
6646     ],
6647     [
6648     'move_allow',
6649     {
6650     desc => 'Objects using these movement types are allowed to move over this space. Takes precedence over \'blocked movements\'.',
6651     name => 'allowed movement',
6652     type => 'bitmask',
6653     value => $BITMASK{movement_type}
6654     }
6655     ],
6656     [
6657     'move_slow',
6658 root 1.7 {
6659 root 1.14 desc => 'The types of movement that should by slowed down by the \'slow movement penalty\'.',
6660     name => 'slowed movement',
6661     type => 'bitmask',
6662     value => $BITMASK{movement_type}
6663     }
6664     ],
6665     [
6666     'move_slow_penalty',
6667     {
6668     desc => 'If <slow movement> is set to a value greater zero, all creatures matching \'slow move\' will be slower than normal on this spot. <slow movement> 1 - rough terrain <slow movement> 2 - very rough terrain ... <slow movement> 5 - default for deep swamp ... <slow movement> 7 - spider web (sticky as hell)',
6669     name => 'slow movement penalty',
6670     type => 'int'
6671 root 1.7 }
6672     ],
6673     [
6674     'can_roll',
6675     {
6676     desc => 'If set, the object is able to "roll", so it can be pushed around. This setting is used for boulders and barrels.',
6677     name => 'moveable',
6678     type => 'bool'
6679     }
6680     ],
6681     [
6682     'no_magic',
6683     {
6684     desc => 'This takes effect only with <blocksview> disabled. Restricting the use of spells to pass this wall.',
6685     name => 'restrict spells',
6686     type => 'bool'
6687     }
6688     ],
6689     [
6690     'damned',
6691     {
6692     desc => 'This takes effect only with <blocksview> disabled. Restricting the use of spells to pass this wall.',
6693     name => 'restrict prayers',
6694     type => 'bool'
6695     }
6696     ]
6697     ],
6698 root 1.3 desc => 'Walls usually block passage and sight.',
6699     ignore => [
6700     'nrof',
6701     'title',
6702     'name_pl',
6703     'value',
6704     'unpaid'
6705     ],
6706 root 1.19 name => 'Wall'
6707 root 1.3 },
6708     'Wand & Staff' => {
6709 root 1.7 attr => [
6710     [
6711     'sp',
6712     {
6713     desc => 'The <spell> specifies the contained spell.',
6714     name => 'spell',
6715     type => 'spell'
6716     }
6717     ],
6718     [
6719     'level',
6720     {
6721     desc => 'The <casting level> of the wand determines it\'s power. An average level for wands in shops is about 10.',
6722     name => 'casting level',
6723     type => 'int'
6724     }
6725     ],
6726     [
6727     'food',
6728     {
6729     desc => 'The wand can be used <number of charges> times before it is used up. It can be recharged with scrolls of charging.',
6730     name => 'number of charges',
6731     type => 'int'
6732     }
6733     ],
6734     [
6735     'startequip',
6736     {
6737     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
6738     name => 'godgiven item',
6739     type => 'bool'
6740     }
6741     ],
6742     [
6743     'msg',
6744     {
6745     desc => 'This text may contain a description of the wand.',
6746     end => 'endmsg',
6747     name => 'description',
6748     type => 'text'
6749     }
6750     ]
6751     ],
6752 root 1.3 desc => 'Wands contain a certain spell. The player can apply (ready) and fire the wand. After a defined number of casts, the wand is "used up". It is possible to recharge a wand with scrolls of charging, but usually that isn\'t worth the cost.',
6753 root 1.5 name => 'Wand & Staff',
6754 root 1.9 use => 'Wands are quite seldomly used. The reason prolly is that they\'re generally not cost-efficient. Handing out high-level wands with powerful special spells isn\'t a good idea either, because of the recharge ability. <br><br> For low levels, staffs of healing/cure and word of recall are quite desirable though. Ideal rewards for low level quests.'
6755 root 1.3 },
6756     'Weak Wall' => {
6757 root 1.7 attr => [
6758     [
6759     'alive',
6760     {
6761     type => 'fixed',
6762     value => 1
6763     }
6764     ],
6765     [
6766     'no_pick',
6767     {
6768     type => 'fixed',
6769     value => 1
6770     }
6771     ],
6772     [
6773     'tear_down',
6774     {
6775     type => 'fixed',
6776     value => 1
6777     }
6778     ],
6779     [
6780     'race',
6781     {
6782     desc => 'For weak walls, <race> should always be set to "wall", unless you create something fancy like a building which is in fact meant to be a huge animal. Note that shovels slay walls, so they do tripple damage against weak walls.',
6783     name => 'race',
6784     type => 'string'
6785     }
6786     ],
6787     [
6788     'level',
6789     {
6790     desc => 'The <level> of a weak wall works similar to monster levels. Due to the fact that weak walls cannot attack, the level is much less important though.',
6791     name => 'level',
6792     type => 'int'
6793     }
6794     ],
6795     [
6796     'hp',
6797     {
6798     desc => 'The <health points> of a weak wall define how long it takes to tear it down. With every successful hit from an opponent, <health points> get drained.',
6799     name => 'health points',
6800     type => 'int'
6801     }
6802     ],
6803     [
6804     'maxhp',
6805     {
6806     desc => '<max health> is the maximum amount of <health points> this weak wall can have. Since walls generally don\'t heal, I doubt this has much real effect.',
6807     name => 'max health',
6808     type => 'int'
6809     }
6810     ],
6811     [
6812     'ac',
6813     {
6814     desc => 'Weak walls of high <armour class> are less likely to get hit. <armour class> can be considered the "counterpiece" to <weapon class>.',
6815     name => 'armour class',
6816     type => 'int'
6817     }
6818     ]
6819     ],
6820 root 1.3 desc => 'A weak wall is a breakable spot amidsts a solid wall. Typically these weak walls look similar to their solid "relatives" except for a small crack or little chunks of wall on the ground.',
6821     ignore => [
6822     $IGNORE_LIST{non_pickable}
6823     ],
6824 root 1.5 name => 'Weak Wall',
6825 root 1.4 section => [
6826     [
6827     'resistance',
6828 root 1.7 [
6829     [
6830     'resist_physical',
6831     {
6832     name => 'resist physical %',
6833     type => 'int'
6834     }
6835     ],
6836     [
6837     'resist_magic',
6838     {
6839     name => 'resist magic %',
6840     type => 'int'
6841     }
6842     ],
6843     [
6844     'resist_fire',
6845     {
6846     name => 'resist fire %',
6847     type => 'int'
6848     }
6849     ],
6850     [
6851     'resist_electricity',
6852     {
6853     name => 'resist electricity %',
6854     type => 'int'
6855     }
6856     ],
6857     [
6858     'resist_cold',
6859     {
6860     name => 'resist cold %',
6861     type => 'int'
6862     }
6863     ],
6864     [
6865     'resist_confusion',
6866     {
6867     name => 'resist confusion %',
6868     type => 'int'
6869     }
6870     ],
6871     [
6872     'resist_acid',
6873     {
6874     name => 'resist acid %',
6875     type => 'int'
6876     }
6877     ],
6878     [
6879     'resist_drain',
6880     {
6881     name => 'resist draining %',
6882     type => 'int'
6883     }
6884     ],
6885     [
6886     'resist_weaponmagic',
6887     {
6888     name => 'resist weaponmagic %',
6889     type => 'int'
6890     }
6891     ],
6892     [
6893     'resist_ghosthit',
6894     {
6895     name => 'resist ghosthit %',
6896     type => 'int'
6897     }
6898     ],
6899     [
6900     'resist_poison',
6901     {
6902     name => 'resist poison %',
6903     type => 'int'
6904     }
6905     ],
6906     [
6907     'resist_slow',
6908     {
6909     name => 'resist slow %',
6910     type => 'int'
6911     }
6912     ],
6913     [
6914     'resist_paralyze',
6915     {
6916     name => 'resist paralyze %',
6917     type => 'int'
6918     }
6919     ],
6920     [
6921     'resist_fear',
6922     {
6923     name => 'resist fear %',
6924     type => 'int'
6925     }
6926     ],
6927     [
6928     'resist_deplete',
6929     {
6930     name => 'resist depletion %',
6931     type => 'int'
6932     }
6933     ],
6934     [
6935     'resist_turn_undead',
6936     {
6937     name => 'resist turn undead %',
6938     type => 'int'
6939     }
6940     ],
6941     [
6942     'resist_death',
6943     {
6944     name => 'resist death-attack %',
6945     type => 'int'
6946     }
6947     ],
6948     [
6949     'resist_chaos',
6950     {
6951     name => 'resist chaos %',
6952     type => 'int'
6953     }
6954     ],
6955     [
6956     'resist_blind',
6957     {
6958     name => 'resist blinding %',
6959     type => 'int'
6960     }
6961     ],
6962     [
6963     'resist_holyword',
6964     {
6965     name => 'resist holy power %',
6966     type => 'int'
6967     }
6968     ],
6969     [
6970     'resist_godpower',
6971     {
6972     name => 'resist godpower %',
6973     type => 'int'
6974     }
6975     ]
6976     ]
6977 root 1.4 ]
6978     ],
6979 root 1.3 use => 'If you want to create hidden rooms, using weak walls is alot better than completely indiscernible passages in a wall.<br> Anyways, there can be a lot more to weak walls than just finding them: Rising their defensive stats, weak walls can become a serious obstacle. An ice wall might only be torn down by a fire attack for example. A granite wall for instance might be very hard to destroy.'
6980     },
6981     Weapon => {
6982 root 1.7 attr => [
6983     [
6984     'attacktype',
6985     {
6986     desc => 'This number is a bitmask, specifying the weapon\'s attacktypes. Attacktypes are: physical, magical, fire, cold.. etc. Most artifact weapons have no more than one or two attacktypes. Keep in mind that all weapons can be blessed by the player\'s diety, thus adding an additional attacktype. When a player hits a monster with a weapon that has more than one attacktype, then he will do as much damage as the "best" of his attacktypes does. So, the more attacktypes you\'ve got, the better your chance to take advantage of a monster\'s vulnerabilities. (Btw: Same rule applies for monster vs. player.). Attacktypes "magic" and "chaos" are somehow exceptions.',
6987     name => 'attacktype',
6988     type => 'bitmask',
6989     value => $BITMASK{attacktype}
6990     }
6991     ],
6992     [
6993     'weapontype',
6994     {
6995     desc => 'The <weapontype> characterizes the weapon\'s type of physical attack. It could best be considered a "subclassification" of the physical attacktype. For now, this is only used for attack messages! You should always set this correctly when creating new weapons for your maps.',
6996     name => 'weapontype',
6997     type => 'list',
6998     value => $LIST{weapon_type}
6999     }
7000     ],
7001     [
7002     'skill',
7003     {
7004     desc => 'Matching <skill name> of the skill that is required to use this weapon.',
7005     name => 'skill name',
7006     type => 'string'
7007     }
7008     ],
7009     [
7010     'dam',
7011     {
7012     desc => 'The damage value is used as base value for how much damage the weapon does per hit. The actual damage involves more dependencies, like wielder\'s level and defender\'s level. Look at existing weapons to get a feel for the range of weapon damage values.',
7013     name => 'damage',
7014     type => 'int'
7015     }
7016     ],
7017     [
7018     'slaying',
7019     {
7020     desc => 'Slaying means the weapon does tripple (3x) damage to monsters of the specified race. If <slaying race> matches an arch name (e.g. "big_dragon"), only monsters of that archtype are hit with tripple damage. No god blessings are possible for weapons with a race set in this entry (That\'s because god blessings add tripple damage against their own enemy races). Tripple damage is very effective.',
7021     name => 'slaying race',
7022     type => 'string'
7023     }
7024     ],
7025     [
7026     'last_sp',
7027     {
7028     desc => 'The weapon speed determines how often the wielder can swing the weapon during a certain period of time. The lower the faster, <weapon speed> 1 is best (that is lightning- fast). A typical average value is 8. Speed and damage should be kept in reasonable relation.',
7029     name => 'weapon speed',
7030     type => 'int'
7031     }
7032     ],
7033     [
7034     'wc',
7035     {
7036     desc => 'The weapon class value adds to the overall weapon class of the wielder\'s melee attacks. Weapon class improves the chance of hitting the opponent.',
7037     name => 'weapon class',
7038     type => 'int'
7039     }
7040     ],
7041     [
7042     'magic',
7043     {
7044     desc => 'For a weapon, magic bonus works just like weapon class, except that magic bonus can be improved by the gods or reduced by acid. Hence, it is less useful than direct weapon class value on a weapon.',
7045     name => 'magic bonus',
7046     type => 'int'
7047     }
7048     ],
7049     [
7050     'item_power',
7051     {
7052     desc => 'The <item power> value measures how "powerful" an artifact is. Players will only be able to wear equipment with a certain total amount of <item power>, depending on their own level. This is the only way to prevent low level players to wear "undeserved" equipment (like gifts from other players or cheated items). It is very important to adjust the <item power> value carefully for every artifact you create! If zero/unset, the CF server will calculate a provisional value at runtime, but this is never going to be an accurate measurement of <item power>.',
7053     name => 'item power',
7054     type => 'int'
7055     }
7056     ],
7057     [
7058     'damned',
7059     {
7060     desc => 'A damned weapon cannot be unwielded unless the curse is removed. Removing damnations is a tick harder than removing curses.',
7061     name => 'damnation',
7062     type => 'bool'
7063     }
7064     ],
7065     [
7066     'cursed',
7067     {
7068     desc => 'A cursed weapon cannot be unwielded unless the curse is removed.',
7069     name => 'curse',
7070     type => 'bool'
7071     }
7072     ],
7073     [
7074     'lifesave',
7075     {
7076 root 1.9 desc => 'An item with this flag enabled will save the players life for one time: When the player is wearing this item and his health points reach zero, the item disappears, replenishing half of the player\'s health. An item with <save life> should not have any decent additional bonuses!',
7077 root 1.7 name => 'save life',
7078     type => 'bool'
7079     }
7080     ],
7081     [
7082     'unique',
7083     {
7084     desc => 'Unique items exist only one time on a server. If the item is taken, lost or destroyed - it\'s gone for good.',
7085     name => 'unique item',
7086     type => 'bool'
7087     }
7088     ],
7089     [
7090     'startequip',
7091     {
7092     desc => 'A godgiven item vanishes as soon as the player drops it to the ground.',
7093     name => 'godgiven item',
7094     type => 'bool'
7095     }
7096     ],
7097     [
7098     'msg',
7099     {
7100     desc => 'This text describes the weapons\'s "story". Every decent artifact weapon should have such a description.',
7101     end => 'endmsg',
7102     name => 'description',
7103     type => 'text'
7104     }
7105     ]
7106     ],
7107 root 1.3 desc => 'Wielding a weapon, the object\'s stats will directly be inherited to the player. Usually enhancing his fighting-abilities. Non-magical weapons can be improved with scrolls.',
7108 root 1.5 name => 'Weapon',
7109 root 1.4 section => [
7110     [
7111     'resistance',
7112 root 1.7 [
7113     [
7114     'resist_physical',
7115     {
7116     desc => 'This adds physical resistance to the weapon (= armour value). The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7117     name => 'resist physical %',
7118     type => 'int'
7119     }
7120     ],
7121     [
7122     'resist_magic',
7123     {
7124     desc => 'This adds magic resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7125     name => 'resist magic %',
7126     type => 'int'
7127     }
7128     ],
7129     [
7130     'resist_fire',
7131     {
7132     desc => 'This adds fire resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7133     name => 'resist fire %',
7134     type => 'int'
7135     }
7136     ],
7137     [
7138     'resist_electricity',
7139     {
7140     desc => 'This adds electricity resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7141     name => 'resist electricity %',
7142     type => 'int'
7143     }
7144     ],
7145     [
7146     'resist_cold',
7147     {
7148     desc => 'This adds fire resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7149     name => 'resist cold %',
7150     type => 'int'
7151     }
7152     ],
7153     [
7154     'resist_confusion',
7155     {
7156     desc => 'This adds confusion resistance to the weapon. The number is a percent-value in the range 0-100. Confusion resistance is not very effective unless the value comes close to 100 (= perfect immunity).',
7157     name => 'resist confusion %',
7158     type => 'int'
7159     }
7160     ],
7161     [
7162     'resist_acid',
7163     {
7164     desc => 'This adds acid resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7165     name => 'resist acid %',
7166     type => 'int'
7167     }
7168     ],
7169     [
7170     'resist_drain',
7171     {
7172     desc => 'This adds draining resistance to the weapon. The number is a percent-value in the range 0-100. Draining resistance is little effective unless the value is 100 (= perfect immunity).',
7173     name => 'resist draining %',
7174     type => 'int'
7175     }
7176     ],
7177     [
7178     'resist_weaponmagic',
7179     {
7180     desc => 'This adds weaponmagic resistance to the weapon. The number is a percent-value in the range 0-100. Weaponmagic resistance generally should not exist on equipment at all. Spells/Monsters doing weaponmagic damage (e.g. comet spell) are not meant to be easily resisted.',
7181     name => 'resist weaponmagic %',
7182     type => 'int'
7183     }
7184     ],
7185     [
7186     'resist_ghosthit',
7187     {
7188     desc => 'This adds ghosthit resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7189     name => 'resist ghosthit %',
7190     type => 'int'
7191     }
7192     ],
7193     [
7194     'resist_poison',
7195     {
7196     desc => 'This adds poison resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7197     name => 'resist poison %',
7198     type => 'int'
7199     }
7200     ],
7201     [
7202     'resist_slow',
7203     {
7204     desc => 'This adds fear resistance to the weapon. The number is a percent-value in the range 0-100. Resistance to fear is pretty useless.',
7205     name => 'resist slow %',
7206     type => 'int'
7207     }
7208     ],
7209     [
7210     'resist_paralyze',
7211     {
7212     desc => 'This adds paralyze resistance to the weapon. The number is a percent-value in the range 0-100. Paralyze resistance is little effective unless the value is 100 (= perfect immunity).',
7213     name => 'resist paralyze %',
7214     type => 'int'
7215     }
7216     ],
7217     [
7218     'resist_fear',
7219     {
7220     desc => 'This adds fear resistance to the weapon. The number is a percent-value in the range 0-100. Resistance to fear is pretty useless.',
7221     name => 'resist fear %',
7222     type => 'int'
7223     }
7224     ],
7225     [
7226     'resist_deplete',
7227     {
7228     desc => 'This adds depletion resistance to the weapon. The number is a percent-value in the range 0-100. Depletion resistance is little effective unless the value is 100 (= perfect immunity).',
7229     name => 'resist depletion %',
7230     type => 'int'
7231     }
7232     ],
7233     [
7234     'resist_death',
7235     {
7236     desc => 'This adds death-attack resistance to the weapon. The number is a percent-value in the range 0-100. Death-attack resistance is little effective unless the value is 100 (= perfect immunity). Generally, resistance to death-attack is not supposed to be available to players!',
7237     name => 'resist death-attack %',
7238     type => 'int'
7239     }
7240     ],
7241     [
7242     'resist_chaos',
7243     {
7244     desc => 'This adds chaos resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact. Note that chaos is not a stand-alone attacktype. Chaos "contains" a combination of other attacktypes.',
7245     name => 'resist chaos %',
7246     type => 'int'
7247     }
7248     ],
7249     [
7250     'resist_blind',
7251     {
7252     desc => 'This adds blinding resistance to the weapon. The number is a percent-value in the range 0-100. Treat this with CARE. Look at other maps and what they require to do for getting this-and-that artifact.',
7253     name => 'resist blinding %',
7254     type => 'int'
7255     }
7256     ],
7257     [
7258     'resist_holyword',
7259     {
7260     desc => 'This adds holy power resistance to the weapon. The number is a percent-value in the range 0-100. Holy power is the attacktype that holyword-type spells use to hurt undead creatures. This kind of resistance is only reasonable for undead players (wraith or devourer cult). Generally, resistance to holy word should not be available for players.',
7261     name => 'resist holy power %',
7262     type => 'int'
7263     }
7264     ]
7265     ]
7266 root 1.4 ],
7267     [
7268     'stats',
7269 root 1.7 [
7270     [
7271     'Str',
7272     {
7273     desc => 'The player\'s strentgh will rise/fall by the given value while wearing this weapon.',
7274     name => 'strength',
7275     type => 'int'
7276     }
7277     ],
7278     [
7279     'Dex',
7280     {
7281     desc => 'The player\'s dexterity will rise/fall by the given value while wearing this weapon.',
7282     name => 'dexterity',
7283     type => 'int'
7284     }
7285     ],
7286     [
7287     'Con',
7288     {
7289     desc => 'The player\'s constitution will rise/fall by the given value while wearing this weapon.',
7290     name => 'constitution',
7291     type => 'int'
7292     }
7293     ],
7294     [
7295     'Int',
7296     {
7297     desc => 'The player\'s intelligence will rise/fall by the given value while wearing this weapon.',
7298     name => 'intelligence',
7299     type => 'int'
7300     }
7301     ],
7302     [
7303     'Pow',
7304     {
7305     desc => 'The player\'s power will rise/fall by the given value while wearing this weapon.',
7306     name => 'power',
7307     type => 'int'
7308     }
7309     ],
7310     [
7311     'Wis',
7312     {
7313     desc => 'The player\'s wisdom will rise/fall by the given value while wearing this weapon.',
7314     name => 'wisdom',
7315     type => 'int'
7316     }
7317     ],
7318     [
7319     'Cha',
7320     {
7321     desc => 'The player\'s charisma will rise/fall by the given value while wearing this weapon.',
7322     name => 'charisma',
7323     type => 'int'
7324     }
7325     ]
7326     ]
7327 root 1.4 ],
7328     [
7329     'misc',
7330 root 1.7 [
7331     [
7332     'luck',
7333     {
7334     desc => 'With positive luck bonus, the player is more likely to succeed in all sorts of things (spellcasting, praying,...). Unless the <luck bonus> is very high, the effect will be barely visible in-game. Luck bonus on one piece of equipment should never exceed 3, and such bonus should not be too frequently available.',
7335     name => 'luck bonus',
7336     type => 'int'
7337     }
7338     ],
7339     [
7340     'hp',
7341     {
7342     desc => 'Positive <health regen.> bonus speeds up the player\'s healing process. Negative values slow it down.',
7343     name => 'health regen.',
7344     type => 'int'
7345     }
7346     ],
7347     [
7348     'sp',
7349     {
7350     desc => 'Positive <mana regen.> bonus speeds up the player\'s mana regeneration. Negative values slow it down.',
7351     name => 'mana regen.',
7352     type => 'int'
7353     }
7354     ],
7355     [
7356     'grace',
7357     {
7358     desc => 'Positive <grace regen.> bonus speeds up the player\'s grace regeneration. Negative values slow it down. Since grace can be regenerated rather easy with praying, additional <grace regen.> bonus should be VERY RARE!!',
7359     name => 'grace regen.',
7360     type => 'int'
7361     }
7362     ],
7363     [
7364     'food',
7365     {
7366     desc => 'Positive <food bonus> slows down the player\'s digestion, thus he consumes less food. Negative values speed it up. Note that food is consumed not only for "being alive", but also for healing and mana-regeneration. <food bonus> only affects the amount of food consumed for "being alive". Hence, even with high <food bonus>, during a fight a player can run out of food quickly.',
7367     name => 'food bonus',
7368     type => 'int'
7369     }
7370     ],
7371     [
7372     'xrays',
7373     {
7374 root 1.9 desc => 'Xray vision allows the player to see through obstacles in a two-square-wide radius. This is extremely helpful and desirable, so don\'t give it away for cheap on equipment.',
7375 root 1.7 name => 'xray vision',
7376     type => 'bool'
7377     }
7378     ],
7379     [
7380     'stealth',
7381     {
7382     desc => 'Stealth allows the player to move silently. This comes to effect if a player turns himself invisible and tries to sneak around monsters. (At least that was the idea behind it)',
7383     name => 'stealth',
7384     type => 'bool'
7385     }
7386     ],
7387     [
7388     'reflect_spell',
7389     {
7390     desc => 'If a player is wearing any piece of equipment with the ability to <reflect spells>, all kinds of spell-bullets and -beams will bounce off him. This works only about 90% of all times, to avoid players being completely immune to certain types of attacks. This is a very powerful ability and it shouldn\'t be handed out cheap!',
7391     name => 'reflect spells',
7392     type => 'bool'
7393     }
7394     ],
7395     [
7396     'reflect_missile',
7397     {
7398     desc => 'If a player is wearing any piece of equipment with the ability to <reflect missiles>, all kinds of projectiles (e.g. arrows, bolts, boulders) will bounce off him. This works only about 90% of all times, to avoid players being completely immune to certain types of attacks.',
7399     name => 'reflect missiles',
7400     type => 'bool'
7401     }
7402     ],
7403     [
7404     'path_attuned',
7405     {
7406     desc => 'Click on the <attuned paths> button to select spellpaths. The player will get attuned to the specified spellpaths while wearing this weapon.',
7407     name => 'attuned paths',
7408     type => 'bitmask',
7409     value => $BITMASK{spellpath}
7410     }
7411     ],
7412     [
7413     'path_repelled',
7414     {
7415     desc => 'Click on the <repelled paths> button to select spellpaths. The player will get repelled to the specified spellpaths while wearing this weapon.',
7416     name => 'repelled paths',
7417     type => 'bitmask',
7418     value => $BITMASK{spellpath}
7419     }
7420     ],
7421     [
7422     'path_denied',
7423     {
7424     desc => 'Click on the <denied paths> button to select spellpaths. The specified spellpaths will be denied to the player while wearing this weapon.',
7425     name => 'denied paths',
7426     type => 'bitmask',
7427     value => $BITMASK{spellpath}
7428     }
7429     ]
7430     ]
7431 root 1.4 ]
7432     ],
7433 root 1.3 use => 'If you create artifacts (equipment) with stats- or resistance-bonus: Keep playbalance in mind! Such items mustn\'t be reachable without hard fighting AND questing.'
7434 root 1.1 }
7435     );
7436    
7437 root 1.3 our %ATTR = (
7438     3 => $TYPE{Rod},
7439     4 => $TYPE{Treasure},
7440     5 => $TYPE{Potion},
7441     6 => $TYPE{Food},
7442     7 => $TYPE{'Poison Food'},
7443     8 => $TYPE{Book},
7444     9 => $TYPE{Clock},
7445     13 => $TYPE{Projectile},
7446     14 => $TYPE{'Shooting Weapon'},
7447     15 => $TYPE{Weapon},
7448     16 => $TYPE{'Brestplate Armour'},
7449     17 => $TYPE{Pedestal},
7450     18 => $TYPE{Altar},
7451     20 => $TYPE{'Locked Door'},
7452     21 => $TYPE{'Special Key'},
7453 root 1.9 23 => $TYPE{Door},
7454     24 => $TYPE{Key},
7455 root 1.8 26 => $TYPE{'Timed Gate'},
7456 root 1.3 27 => $TYPE{'Handle Trigger'},
7457 root 1.9 28 => $TYPE{'Monster (Grimreaper)'},
7458 root 1.3 29 => $TYPE{'Magic Ear'},
7459 root 1.9 30 => $TYPE{'Button Trigger'},
7460 root 1.3 31 => $TYPE{'Altar Trigger'},
7461     33 => $TYPE{Shield},
7462     34 => $TYPE{Helmet},
7463     35 => $TYPE{Horn},
7464     36 => $TYPE{Money},
7465 root 1.9 37 => $TYPE{'Class Changer'},
7466 root 1.3 39 => $TYPE{Amulet},
7467     40 => $TYPE{Mover},
7468     41 => $TYPE{Teleporter},
7469     42 => $TYPE{Creator},
7470     43 => $TYPE{Skill},
7471     51 => $TYPE{Detector},
7472     52 => $TYPE{'Trigger Marker'},
7473     55 => $TYPE{Marker},
7474     56 => $TYPE{'Holy Altar'},
7475     58 => $TYPE{Battleground},
7476     60 => $TYPE{Jewel},
7477     62 => $TYPE{'Magic Wall'},
7478     64 => $TYPE{'Inventory Checker'},
7479     65 => $TYPE{'Mood Floor'},
7480     66 => $TYPE{Exit},
7481     67 => $TYPE{'Floor (Encounter)'},
7482     68 => $TYPE{'Shop Floor'},
7483     69 => $TYPE{'Shop Mat'},
7484     70 => $TYPE{Ring},
7485     72 => $TYPE{Flesh},
7486     73 => $TYPE{Inorganic},
7487     83 => $TYPE{Duplicator},
7488     85 => $TYPE{Spellbook},
7489     87 => $TYPE{Cloak},
7490     88 => $TYPE{'Hazard Floor'},
7491     90 => $TYPE{Spinner},
7492     91 => $TYPE{Gate},
7493     92 => $TYPE{Button},
7494     93 => $TYPE{Handle},
7495     94 => $TYPE{Pit},
7496     95 => $TYPE{Trapdoor},
7497     98 => $TYPE{'Sign & MagicMouth'},
7498     99 => $TYPE{Boots},
7499     100 => $TYPE{Gloves},
7500     101 => $TYPE{Spell},
7501     103 => $TYPE{Converter},
7502     104 => $TYPE{Bracers},
7503     106 => $TYPE{Savebed},
7504     109 => $TYPE{'Wand & Staff'},
7505     110 => $TYPE{Ability},
7506     111 => $TYPE{Scroll},
7507     112 => $TYPE{Director},
7508     113 => $TYPE{Girdle},
7509 root 1.10 116 => $TYPE{'Event Connector'},
7510 root 1.3 122 => $TYPE{Container},
7511     130 => $TYPE{'Skill Scroll'},
7512     138 => $TYPE{Swamp},
7513     154 => $TYPE{Rune},
7514     155 => $TYPE{Trap},
7515     156 => $TYPE{'Power Crystal'},
7516 root 1.8 158 => $TYPE{Disease},
7517 elmex 1.23 163 => $TYPE{'Item Transformer'},
7518     165 => $TYPE{'Safe ground (CF+)'}
7519 root 1.1 );
7520    
7521 root 1.3 our %TYPENAME = (
7522     0 => '*NONE*',
7523     1 => 'PLAYER',
7524 root 1.9 2 => 'TRANSPORT',
7525 root 1.3 3 => 'ROD',
7526     4 => 'TREASURE',
7527     5 => 'POTION',
7528     6 => 'FOOD',
7529     7 => 'POISON',
7530     8 => 'BOOK',
7531     9 => 'CLOCK',
7532     12 => 'LIGHTNING',
7533     13 => 'ARROW',
7534     14 => 'BOW',
7535     15 => 'WEAPON',
7536     16 => 'ARMOUR',
7537     17 => 'PEDESTAL',
7538     18 => 'ALTAR',
7539     20 => 'LOCKED_DOOR',
7540     21 => 'SPECIAL_KEY',
7541     22 => 'MAP',
7542     23 => 'DOOR',
7543     24 => 'KEY',
7544     26 => 'TIMED_GATE',
7545     27 => 'TRIGGER',
7546     28 => 'GRIMREAPER',
7547     29 => 'MAGIC_EAR',
7548     30 => 'TRIGGER_BUTTON',
7549     31 => 'TRIGGER_ALTAR',
7550     32 => 'TRIGGER_PEDESTAL',
7551     33 => 'SHIELD',
7552     34 => 'HELMET',
7553     35 => 'HORN',
7554     36 => 'MONEY',
7555     37 => 'CLASS',
7556     38 => 'GRAVESTONE',
7557     39 => 'AMULET',
7558     40 => 'PLAYERMOVER',
7559     41 => 'TELEPORTER',
7560     42 => 'CREATOR',
7561     43 => 'SKILL',
7562     44 => 'EXPERIENCE',
7563     45 => 'EARTHWALL',
7564     46 => 'GOLEM',
7565     48 => 'THROWN_OBJ',
7566     49 => 'BLINDNESS',
7567     50 => 'GOD',
7568     51 => 'DETECTOR',
7569     52 => 'TRIGGER_MARKER',
7570     53 => 'DEAD_OBJECT',
7571     54 => 'DRINK',
7572     55 => 'MARKER',
7573     56 => 'HOLY_ALTAR',
7574     57 => 'PLAYER_CHANGER',
7575     58 => 'BATTLEGROUND',
7576     59 => 'PEACEMAKER',
7577     60 => 'GEM',
7578     62 => 'FIREWALL',
7579     63 => 'ANVIL',
7580     64 => 'CHECK_INV',
7581     65 => 'MOOD_FLOOR',
7582     66 => 'EXIT',
7583     67 => 'ENCOUNTER',
7584     68 => 'SHOP_FLOOR',
7585     69 => 'SHOP_MAT',
7586     70 => 'RING',
7587     71 => 'FLOOR',
7588     72 => 'FLESH',
7589     73 => 'INORGANIC',
7590     74 => 'SKILL_TOOL',
7591     75 => 'LIGHTER',
7592     76 => 'TRAP_PART',
7593     77 => 'WALL',
7594     78 => 'LIGHT_SOURCE',
7595     79 => 'MISC_OBJECT',
7596     80 => 'MONSTER',
7597     81 => 'SPAWN_GENERATOR',
7598     82 => 'LAMP',
7599     83 => 'DUPLICATOR',
7600     84 => 'TOOL',
7601     85 => 'SPELLBOOK',
7602     86 => 'BUILDFAC',
7603     87 => 'CLOAK',
7604     90 => 'SPINNER',
7605     91 => 'GATE',
7606     92 => 'BUTTON',
7607     93 => 'CF_HANDLE',
7608     94 => 'HOLE',
7609     95 => 'TRAPDOOR',
7610     98 => 'SIGN',
7611     99 => 'BOOTS',
7612     100 => 'GLOVES',
7613     101 => 'SPELL',
7614     102 => 'SPELL_EFFECT',
7615     103 => 'CONVERTER',
7616     104 => 'BRACERS',
7617     105 => 'POISONING',
7618     106 => 'SAVEBED',
7619     107 => 'POISONCLOUD',
7620     108 => 'FIREHOLES',
7621     109 => 'WAND',
7622     111 => 'SCROLL',
7623     112 => 'DIRECTOR',
7624     113 => 'GIRDLE',
7625     114 => 'FORCE',
7626     115 => 'POTION_EFFECT',
7627 root 1.11 116 => 'EVENT_CONNECTOR',
7628 root 1.3 121 => 'CLOSE_CON',
7629     122 => 'CONTAINER',
7630     123 => 'ARMOUR_IMPROVER',
7631     124 => 'WEAPON_IMPROVER',
7632     130 => 'SKILLSCROLL',
7633     138 => 'DEEP_SWAMP',
7634     139 => 'IDENTIFY_ALTAR',
7635     150 => 'MENU',
7636     154 => 'RUNE',
7637     155 => 'TRAP',
7638     156 => 'POWER_CRYSTAL',
7639     157 => 'CORPSE',
7640     158 => 'DISEASE',
7641     159 => 'SYMPTOM',
7642     160 => 'BUILDER',
7643 root 1.9 161 => 'MATERIAL',
7644     162 => 'GPS',
7645     163 => 'ITEM_TRANSFORMER',
7646     164 => 'QUEST'
7647 root 1.1 );
7648    
7649     our %SPELL = (
7650 root 1.3 0 => 'magic bullet',
7651     1 => 'small fireball',
7652     2 => 'medium fireball',
7653     3 => 'large fireball',
7654     4 => 'burning hands',
7655     5 => 'small lightning',
7656     6 => 'large lightning',
7657     7 => 'magic missile',
7658     8 => 'create bomb',
7659     9 => 'summon golem',
7660     10 => 'summon fire elemental',
7661     11 => 'summon earth elemental',
7662     12 => 'summon water elemental',
7663     13 => 'summon air elemental',
7664     14 => 'dimension door',
7665     15 => 'create earth wall',
7666     16 => 'paralyze',
7667     17 => 'icestorm',
7668     18 => 'magic mapping',
7669     19 => 'turn undead',
7670     20 => 'fear',
7671     21 => 'poison cloud',
7672     22 => 'wonder',
7673     23 => 'destruction',
7674     24 => 'perceive self',
7675     25 => 'word of recall',
7676     26 => 'invisible',
7677     27 => 'invisible to undead',
7678     28 => 'probe',
7679     29 => 'large bullet',
7680     30 => 'improved invisibility',
7681     31 => 'holy word',
7682     32 => 'minor healing',
7683     33 => 'medium healing',
7684     34 => 'major healing',
7685     35 => 'heal',
7686     36 => 'create food',
7687     37 => 'earth to dust',
7688     38 => 'armour',
7689     39 => 'strength',
7690     40 => 'dexterity',
7691     41 => 'constitution',
7692     42 => 'charisma',
7693     43 => 'create fire wall',
7694     44 => 'create frost wall',
7695     45 => 'protection from cold',
7696     46 => 'protection from electricity',
7697     47 => 'protection from fire',
7698     48 => 'protection from poison',
7699     49 => 'protection from slow',
7700     50 => 'protection from paralysis',
7701     51 => 'protection from draining',
7702     52 => 'protection from magic',
7703     53 => 'protection from attack',
7704     54 => 'levitate',
7705     55 => 'small speedball',
7706     56 => 'large speedball',
7707     57 => 'hellfire',
7708     58 => 'dragonbreath',
7709     59 => 'large icestorm',
7710     60 => 'charging',
7711     61 => 'polymorph',
7712     62 => 'cancellation',
7713     63 => 'confusion',
7714     64 => 'mass confusion',
7715     65 => 'summon pet monster',
7716     66 => 'slow',
7717     67 => 'regenerate spellpoints',
7718     68 => 'cure poison',
7719     69 => 'protection from confusion',
7720     70 => 'protection from cancellation',
7721     71 => 'protection from depletion',
7722     72 => 'alchemy',
7723     73 => 'remove curse',
7724     74 => 'remove damnation',
7725     75 => 'identify',
7726     76 => 'detect magic',
7727     77 => 'detect monster',
7728     78 => 'detect evil',
7729     79 => 'detect curse',
7730     80 => 'heroism',
7731     81 => 'aggravation',
7732     82 => 'firebolt',
7733     83 => 'frostbolt',
7734     84 => 'shockwave',
7735     85 => 'color spray',
7736     86 => 'haste',
7737     87 => 'face of death',
7738     88 => 'ball lightning',
7739     89 => 'meteor swarm',
7740     90 => 'comet',
7741     91 => 'mystic fist',
7742     92 => 'raise dead',
7743     93 => 'resurrection',
7744     94 => 'reincarnation',
7745     95 => 'immunity to cold',
7746     96 => 'immunity to electricity',
7747     97 => 'immunity to fire',
7748     98 => 'immunity to poison',
7749     99 => 'immunity to slow',
7750     100 => 'immunity to paralysis',
7751     101 => 'immunity to draining',
7752     102 => 'immunity to magic',
7753     103 => 'immunity to attack',
7754     104 => 'invulnerability',
7755     105 => 'defense',
7756     106 => 'rune of fire',
7757     107 => 'rune of frost',
7758     108 => 'rune of shocking',
7759     109 => 'rune of blasting',
7760     110 => 'rune of death',
7761     111 => 'marking rune',
7762     112 => 'build director',
7763     113 => 'create pool of chaos',
7764     114 => 'build bullet wall',
7765     115 => 'build lightning wall',
7766     116 => 'build fireball wall',
7767     117 => 'magic rune',
7768     118 => 'rune of magic drain',
7769     119 => 'antimagic rune',
7770     120 => 'rune of transferrence',
7771     121 => 'transferrence',
7772     122 => 'magic drain',
7773     123 => 'counterspell',
7774     124 => 'disarm',
7775     125 => 'cure confusion',
7776     126 => 'restoration',
7777     127 => 'summon evil monster',
7778     128 => 'counterwall',
7779     129 => 'cause light wounds',
7780     130 => 'cause medium wounds',
7781     131 => 'cause serious wounds',
7782     132 => 'charm monsters',
7783     133 => 'banishment',
7784     134 => 'create missile',
7785     135 => 'show invisible',
7786     136 => 'xray',
7787     137 => 'pacify',
7788     138 => 'summon fog',
7789     139 => 'steambolt',
7790     140 => 'command undead',
7791     141 => 'holy orb',
7792     142 => 'summon avatar',
7793     143 => 'holy possession',
7794     144 => 'bless',
7795     145 => 'curse',
7796     146 => 'regeneration',
7797     147 => 'consecrate',
7798     148 => 'summon cult monsters',
7799     149 => 'cause critical wounds',
7800     150 => 'holy wrath',
7801     151 => 'retributive strike',
7802     152 => 'finger of death',
7803     153 => 'insect plague',
7804     154 => 'call holy servant',
7805     155 => 'wall of thorns',
7806     156 => 'staff to snake',
7807     157 => 'light',
7808     158 => 'darkness',
7809     159 => 'nightfall',
7810     160 => 'daylight',
7811     161 => 'sunspear',
7812     162 => 'faery fire',
7813     163 => 'cure blindness',
7814     164 => 'dark vision',
7815     165 => 'bullet swarm',
7816     166 => 'bullet storm',
7817     167 => 'cause many wounds',
7818     168 => 'small snowstorm',
7819     169 => 'medium snowstorm',
7820     170 => 'large snowstorm',
7821     171 => 'cure disease',
7822     172 => 'cause red death',
7823     173 => 'cause flu',
7824     174 => 'cause black death',
7825     175 => 'cause leprosy',
7826     176 => 'cause smallpox',
7827     177 => 'cause white death',
7828     178 => 'cause anthrax',
7829     179 => 'cause typhoid',
7830     180 => 'mana blast',
7831     181 => 'small manaball',
7832     182 => 'medium manaball',
7833     183 => 'large manaball',
7834     184 => 'mana bolt',
7835     185 => 'dancing sword',
7836     186 => 'animate weapon',
7837     187 => 'cause cold',
7838     188 => 'divine shock',
7839     189 => 'windstorm',
7840     190 => 'sanctuary',
7841     191 => 'peace',
7842     192 => 'spiderweb',
7843     193 => 'conflict',
7844     194 => 'rage',
7845     195 => 'forked lightning',
7846     196 => 'poison fog',
7847     197 => 'flaming aura',
7848     198 => 'vitriol',
7849     199 => 'vitriol splash',
7850     200 => 'ironwood skin',
7851     201 => 'wrathful eye',
7852     202 => 'town portal',
7853     203 => 'missile swarm',
7854     204 => 'cause rabies',
7855     205 => 'glyph'
7856 root 1.1 );
7857    
7858    
7859     =head1 AUTHOR
7860    
7861     Marc Lehmann <schmorp.de>
7862     http://home.schmorp.de/
7863    
7864     The source files are part of the CFJavaEditor.
7865    
7866     =cut
7867    
7868     1