ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/pod/command_help.pod
Revision: 1.32
Committed: Wed Nov 21 10:28:52 2012 UTC (11 years, 6 months ago) by root
Branch: MAIN
CVS Tags: rel-3_1, HEAD
Changes since 1.31: +2 -0 lines
Log Message:
avoid misparsing pod as comment

File Contents

# User Rev Content
1 root 1.3 =begin comment
2 root 1.32
3 root 1.3 ***
4 root 1.4 *** WARNING: THIS IS A GENERATED FILE - CHANGES WILL BE LOST
5     *** The source for this file is in CFPlus/pod/command_help.pod
6     *** Make any changes there and then run ./copy_doc
7 root 1.3 ***
8 root 1.32
9 root 1.4 =end comment
10 root 1.3
11 root 1.28 =encoding utf-8
12    
13 root 1.14 =head1 Deliantra Command ListingX<command>
14 pippijn 1.1
15     =head2 accept-invitation
16    
17     Accepts an invitation previously issued by another player using the invite
18     command. This will transfer you to the location you were invited to.
19    
20     =head2 afk
21    
22     Puts you into AFK (Away From Keyboard) mode. This can be used when you
23     are away for some time but not long enough to log off. It will not save
24     you from starvation and will merely list you as AFK in the user list.
25    
26 root 1.29 An argument of C<0> disables and C<1> enables this option, no argument
27     toggles the setting.
28    
29 pippijn 1.1 =head2 apply
30    
31     Apply applies an object.
32    
33     If no options are given, it applies an object you are standing on.
34    
35     If an object name is given, it will apply/unapply that object (toggle)
36    
37     Extra options to apply:
38    
39     -a Always applies the object
40     -u Always unapplies the object.
41    
42     These two options disable the toggling feature.
43    
44     =head2 X<applymode>applymode (nochoice|never|always)
45    
46 root 1.17 the C<applymode> controls what happens when you are equipping something that would
47 pippijn 1.1 require something else to be unequipped.
48    
49     The options are:
50    
51     =over 4
52    
53     =item B<nochoice>
54    
55     In this case, if there is no choice for the item(s) being removed in order
56     to equip your new item. An example of this is a wand - there can only be
57     one other item needed to be unequipped for the new item to be equipped.
58     Note that in the case of two handed objects, like bows, it can result in
59     two (or more) items being unequipped to equip your new item.
60    
61     =item B<never>
62    
63     In this case, it will never unequip something for you. It will instead
64     tell you want you need to unequip - this can be a list of many objects.
65    
66     =item B<always>
67    
68     This will unequip whatever is needed to equip your new item.
69    
70     =back
71    
72     An example of how the above works:
73    
74     If your character currently has two rings, and tries to equip a third, the
75     B<nochoice> mode will print the two rings you currently have equipped. The
76     B<always> mode will unequip one of the rings in your inventory. The ring
77     unequipped is fairly indeterminate - it depends on how the server has
78     ordered your inventory (which is not the same as the order your window
79     displays).
80    
81     If your character is currently wearing a suit of armor, and you try to
82     equip another suit, both B<nochoice> and B<always> will cause the new suit
83     to get equipped.
84    
85     See L<apply|command/apply>.
86    
87     =head2 body
88    
89 root 1.22 Shows how much (and what) you are wielding on certain body parts.
90    
91     For example as fireborn, you have 4 fingers to put rings on. If you have
92     3 rings on it will say: "on your finger 3 1", meaning you have 3 fingers
93     full and one free.
94    
95     Both items as well as skills and other more esoteric objects can use those
96     body parts.
97 pippijn 1.1
98     =head2 X<bowmode>bowmode (normal|threewide|spreadshot|bestarrow|.*)
99    
100 root 1.17 The C<bowmode> controls how you will fire arrows and bolts.
101 pippijn 1.1
102     The options are:
103    
104     =over 4
105    
106     =item B<normal>
107    
108     As you would expect.
109    
110     =item B<threewide>
111    
112     Fires three arrows in parallel.
113    
114     =item B<spreadshot>
115    
116     Fires three arrows which spread out over distance.
117    
118     =item B<fire>I<direction>
119    
120     Locks in the direction the missiles will fire, specify by compass position:
121     B<firenorth>, B<firene>, B<fireeast>, B<firese>, B<firesouth>, B<firesw>, B<firewest>, B<firenw>.
122    
123     =item B<bestarrow>
124    
125     Selects and fires the probable best arrow from your inventory.
126    
127     =back
128    
129     =head2 brace
130    
131     When you enter the B<brace> command to brace your character, your
132     character will no longer move. It can still attack adjoining
133     spaces. Bracing can be useful to hold a location.
134    
135 root 1.17 When you are braced, you lose your Dex bonus and incur a 2 point
136     ac penalty beyond that (if you have a negative Dex bonus, you may in
137 pippijn 1.1 fact come out ahead. You also only get 20% of the normal experience
138 root 1.17 for killing creatures, and incur a 4 point WC (to hit) penalty.
139 pippijn 1.1
140 root 1.29 An argument of C<0> disables and C<1> enables this option, no argument
141     toggles the setting.
142    
143     =head2 bumpmsg
144    
145     Toggles between wall bump messages (and sound) enabled and disabled. This
146     greatly improves navigation experience in text-only clients, but works in
147     any client.
148    
149     An argument of C<0> disables and C<1> enables this option, no argument
150     toggles the setting.
151    
152 pippijn 1.1 =head2 chat
153    
154     chat <message>
155    
156 root 1.16 Sends a message to all players on the server. This is the normal way to
157     chat with others.
158 pippijn 1.1
159     =head2 cast
160    
161 root 1.17 You use the cast command to set your range-action-slot to the spell you
162 pippijn 1.1 want. Example:
163    
164     cast burning hands
165    
166 root 1.17 sets your I<range> slot to B<spell: burning hands>.
167 pippijn 1.1
168 root 1.30 Some spells take an extra argument after their name, for example, B<cast
169     dimension door 5> limits the maximum jump distance to 5 spaces.
170    
171     If you don't enter a spell name, shows which spells you do know.
172 pippijn 1.1
173     It is helpful to bind string like B<cast burning hands> to keys.
174    
175 root 1.17 See C<help range> for more information on range weapons.
176 pippijn 1.1
177     =head2 X<drop>drop (all|unpaid|cursed|unlocked|.*)
178    
179     drop [number] name
180    
181     B<name> is the name of the item(s) to drop. It may match multiple items.
182     The name is matched against the start of the objects in your inventory.
183     The name matching is case insensitive.
184    
185     There are a few special name values:
186    
187     =over 4
188    
189 root 1.17 =item B<all>: matches any item.
190 pippijn 1.1
191 root 1.17 =item B<unpaid>: matches unpaid items.
192 pippijn 1.1
193 root 1.17 =item B<cursed>: drops items known to be cursed or damned.
194 pippijn 1.1
195 root 1.17 =item B<unlocked>: drops items not locked in your inventory.
196 pippijn 1.1
197     =back
198    
199     B<number> is optional. This acts as the number of the object to drop. The
200     objects number must be at least the number for it to be dropped. For
201     example, if you do B<drop 10 scroll>, only groupings of 10 or more scrolls
202     will be dropped. A collection of 5 scrolls will not be dropped.
203    
204     See also B<dropall> and mouse button control within client for dropping
205     objects.
206    
207 root 1.12
208     =head2 cointoss
209    
210     Tosses a coin and reports the outcome to you and other players on the same
211     map, much like the say command does.
212    
213    
214     =head2 orcknuckle
215    
216     Throws your orcknuckle set and reports the outcome to you and other
217     players on the same map, much like the say command does. Your first
218     three orcknuckle throws can report I<beholder>, I<ghost>, I<knight>,
219     I<princess>, I<dragon>, while the fourth can additionally roll up to
220     I<orc>.
221    
222    
223 pippijn 1.1 =head2 dropall
224    
225     dropall [type]
226    
227     B<dropall> drops all items in your inventory to the ground, excepting
228     locked items. The type parameter will also control what is dropped:
229    
230     =over 4
231    
232     =item nothing specified
233    
234     Drops all objects except food, money, keys, and containers.
235    
236     =item B<weapons>
237    
238     Drops weapons, bows, and arrows.
239    
240     =item B<armor> (armour)
241    
242     Drops armor, shield, and helmets.
243    
244     =item B<misc>
245    
246     Drops horns, books, girdles, amulets, rings, cloaks, boots, gloves,
247     bracers, scrolls, wands, rods, and potions.
248    
249     =back
250    
251     See also 'drop' and mouse button control for dropping objects.
252    
253     =head2 examine
254    
255     Without arguments, this will give some information on the item below you,
256     with arguments it will give information on a matching item in your inventory.
257     For example:
258    
259     examine rucksack
260    
261     This will show you something like:
262    
263     That is rucksack
264     Its weight limit is 647.1 kg.
265     It is made of: cloth.
266     It weighs 0.100 kg.
267    
268     =head2 follow
269    
270     This enables the follow mode (cf+ only).
271    
272     The player issuing the follow
273     command is required to stand
274     on a space right next to the
275     player that is to be followed.
276    
277     To start following a player,
278     use:
279    
280     follow <playername>
281    
282     To stop following, use:
283    
284     follow
285    
286     Without arguments.
287    
288     =head2 get
289    
290     get [item]
291    
292     This will pick up an item from the floor with the name [item]. If there is
293     more than one unique item with that name, they are all picked up.
294    
295     =head2 gsay
296    
297     If you are in a party (party join or party form), you will be able to message
298     only your party. Even people standing right next to you can't hear it.
299    
300     =head2 help
301    
302     Gives you online help for the command or help topic specified.
303    
304 root 1.11 =head2 hintmode (show|mark|hide)
305 root 1.10
306     hintmode show|mark|hide
307    
308     Sets the I<hint mode> to the given value: Throughout the game you can find
309     hints that sometimes help you to solve a puzzle or manage a situation
310     better than without. You can change the display of these hints with this
311     command:
312    
313     =over 4
314    
315     =item show
316    
317     Show the hints (the default mode).
318    
319     =item mark
320    
321     Do not show the hints themselves, but notify you when a hint would have
322     been available.
323    
324     =item hide
325    
326 root 1.17 Hide all hints: You will not be able to tell whether there is a hint
327 root 1.10 available or not.
328    
329     =back
330    
331 pippijn 1.1 =head2 hiscore
332    
333     Shows a list of the highest level players in the game.
334    
335     =head2 ignore
336    
337 root 1.2 ignore list
338    
339     Lists all players that you currently ignore.
340    
341 pippijn 1.1 ignore <player> <tell|shout|all> [timeout]
342    
343     This command ignores the specified messages (B<tell> ignores tells,
344 root 1.17 B<shout> ignores chat and shout and B<all> ignores everything from the given
345 pippijn 1.1 user).
346    
347 root 1.17 The optional timeout (specified in hours) specifies when the ignore entry
348     expires. The default is 24 (one day). The reason why all ignore entries
349     expire after a day by default is that most troublemakers stop soon after
350     they are being ignored.
351 pippijn 1.1
352     To revoke an ignore, use the B<unignore> command.
353    
354     =head2 inventory
355    
356     Lists all items in your inventory along with their locked/applied/wielded
357     status. Example:
358    
359     inventory
360    
361     Inventory:
362 root 1.17 - arrow 0.1
363     - Knife * 2
364     - long sword (wielded) 15
365 pippijn 1.1
366     This shows that you have one arrow which weighs 0.1kg and one Knife which you
367     protected from dropping by locking it as well as a long sword which you are
368     currently using to attack.
369    
370     =head2 invite
371    
372     This command invites another player to where you are currently located.
373     There are four levels of inviting that can be earned by doing quests.
374     Quest descriptions can be found in a house in scorn.
375    
376     =over 4
377    
378     =item Level 1 can invite only into private rooms such as apartments.
379    
380     =item Level 2 can invite into private rooms and unique maps such as guilds.
381    
382     =item Level 3 can invite to anywhere in the world if there are no monsters on
383     the map.
384    
385     =item Level 4 can invite any player to any map with or without monsters. This is
386     a very dangerous skill and should be used wisely.
387    
388     =back
389    
390     In any of these levels, the invited player is required to acknowledge and
391     allow the transport.
392    
393     One can never transport from nor to an unholy place. That means, one can
394     not be saved out of jail using invite.
395    
396     =head2 invoke
397    
398 root 1.8 The invoke command is used to cast a spell immediately, or when it is
399     necessary to give a parameter to the spell. Invoke will not set the range
400     weapon.
401 pippijn 1.1
402     Examples:
403    
404 root 1.8 invoke restoration
405     invoke magic rune of large fireball
406     invoke reincarnation of Iamdead
407     invoke create food of waybread
408    
409     It is very helpful to bind healing spells to keys, for example go to your
410 root 1.17 I<playerbook>, tab I<spells>, the press the right mouse button on the
411 root 1.8 spell I<medium healing> and choose C<bind invoke ... to a key>. It is
412     recommended to bind a healing spell or potion to an easily-accessible-key,
413     such as '1'.
414 pippijn 1.1
415    
416     =head2 killpets
417    
418 root 1.4 killpets [name]
419    
420 pippijn 1.1 The killpets command is a quick and convenient way
421     to get rid of all your pets when they are no longer
422     useful or are getting in the way. Any equipment
423     they had will be left behind, but you will get no
424     experience for their death. However, it kills them
425     instantaneously.
426    
427     If a name is specified then only pets with that
428 root 1.17 name will be killed, e.g. killpets bat will kill bats
429 pippijn 1.1 but not bees. If a number is specified, the pet
430     corresponding to that number is killed.
431    
432 elmex 1.25 =head2 lock
433    
434     lock [object]
435    
436     The lock command is a quick and convenient way to
437     lock items in your inventory.
438    
439     If a object name is specified then only the
440     objects that match that name are locked.
441     e.g. lock materials will lock any materials
442     in your inventory and not touch anything else.
443    
444     lock by itself will lock everything in your
445     inventory.
446    
447 pippijn 1.1 =head2 mapinfo
448    
449     Shows some information about the map like this:
450    
451     world_105_115 (/world/world_105_115) in scorn
452     Creator: Gnat the Gnu
453     Email: gnu@foo.bar
454     Date: Sun Dec 16 20:53:13 2001
455    
456     world_105_115: The map name
457     /world/world_105_115: The relative map path
458     scorn: Region the map is in
459    
460     The rest is information the mapper may or may not provide. Often, this is
461     the mapper's name, email and map creation date as this example shows.
462    
463     =head2 maps
464    
465 root 1.5 maps <mapname>
466    
467     Shows a list of maps matching the regex <mapname> that are currently being
468     known to the server. The different fields are Pl, I, Svd, Reset and Path:
469    
470     =over 4
471    
472     =item Pl: the number of players on that map currently.
473    
474     =item I: B<I>n memory, B<S>wapped out or B<L>oading.
475    
476     The server keeps maps in memory only for a short time (by default about
477     40 seconds). After that time, it saves them to disk. As the server loads
478     most maps in the background it is possible that you can see a map that is
479 pippijn 1.19 currently being loaded, but that's rare, as loading a map is fast.
480 root 1.5
481 root 1.24 =item Svd: the amount of seconds since the map was last saved (++ means >99).
482 root 1.5
483     The server by default tries to save each map at least every 20 seconds if
484     it changed, so in case of a disastrous crash (one where the server cannot
485     emergency save), at most 20 seconds of gameplay are lost.
486    
487     =item Reset: the minimum number of seconds the map will stay as is (will not reset).
488    
489     Most maps will not reset as long as players are on it, and usually the
490 root 1.12 reset counter only starts going down when all players left the map. Some
491     maps will never reset in the common sense, these are usually marked with a
492 root 1.17 very high number (such as C<1e+99>).
493 root 1.5
494     =item Path: the name that uniquely identifies the map, can be used for goto etc.
495    
496     =back
497 pippijn 1.1
498    
499     =head2 mark
500    
501     B<mark> is used to mark items for items that apply other items. Examples of
502     these are flint & steel marked for apply torches, a weapon marked for
503     improve weapon scrolls.
504    
505     B<mark> without options shows your currently marked item.
506    
507     Usage examples:
508    
509     mark sword +3
510     mark three torches
511     mark sword
512    
513     B<mark> will look for best match first, and then look for matches based
514     on shortened name, object name, archetype name. It prints the match it
515     finds.
516    
517 root 1.23 =head2 me
518    
519     me <message>
520    
521     Sends a message to all players on the server, similar to chat, but instead
522     of using C<name chats: message>, the form C<* name message> is used, which
523     is useful to describe yourself, such as:
524    
525     me feels lonely
526     =>
527     * schmorp feels lonely
528    
529    
530 pippijn 1.1 =head2 motd
531    
532     Shows the message of the day. It takes no arguments.
533    
534     =head2 output-count
535    
536 root 1.7 output-count [lines]
537 pippijn 1.1
538     output-count sets after how many messages of the same type, they are
539     then printed out. If the value was 10, then after killing ten orcs, the
540     message '10 times you kill orc' would be printed out. The default value is
541     1 - this means that all messages get printed out as they are requested -
542     buffering is disabled in this regard.
543    
544 root 1.7 output-sync controls how often information is sent to the screen. Each
545 root 1.17 buffer has its own time value, and will be flushed independently. The
546 root 1.7 default value is usually less than a second.
547    
548 pippijn 1.1 See also L<output-sync>.
549    
550 root 1.13 =head2 output-rate
551    
552     output-rate [bytes per second]
553 root 1.6
554     Show the current setting of the output-rate, or set it to the provided
555 root 1.13 value. The server will try very hard not to send more than this many bytes
556 root 1.6 per second to your client. If the rate is exceeded, the server tries to
557 root 1.13 hold back less important information (such as new images) to increase
558     responsiveness.
559    
560     The server-side default is usually quite high, around 100000. If the
561     server is running on a Linux kernel, it will adjust to the actual
562     bandwidth available, and output-rate only sets an upper bound. That is,
563     the server will automatically set an optimal send rate and adjusting your
564     output-rate is not required.
565 root 1.6
566 pippijn 1.1 =head2 output-sync
567    
568 root 1.7 output-sync [seconds]
569    
570 pippijn 1.1 output-sync controls how often information is sent to the screen. Each
571 root 1.17 buffer has its own time value, and will be flushed independently. The
572 root 1.7 default value is usually less than a second.
573 pippijn 1.1
574     output-count sets after how many messages of the same type, they are
575     then printed out. If the value was 10, then after killing ten orcs, the
576     message '10 times you kill orc' would be printed out. The default value is
577     1 - this means that all messages get printed out as they are requested -
578     buffering is disabled in this regard.
579    
580     See also L<output-count>.
581    
582     =head2 party
583    
584     party join partyname
585     Puts you in a party, prompts you for a passwd if there is
586     one
587    
588     party form partyname
589     Forms a party and puts you as leader, 32 character max.
590     At the moment, being party leader does nothing. May be used in
591     the future.
592    
593     party list
594     Lists currently formed parties and their 'leader'
595    
596     party passwd <password>
597     Changes the passwd for the party you are in, 8 character max.
598    
599     party who
600     lists the members of the party you are in
601    
602     party say <msg>
603     sends messsage to party members
604    
605     party leave
606     takes you out of current party
607    
608     =head2 peaceful
609    
610 root 1.15 TODO: rework for deliantra, intended future behaviour is to toggle
611 pippijn 1.1 peaceful mode with regards to npc and monsters only, not with regards to
612     players (which will be controlled by priests).
613    
614     The B<peaceful> command will switch you between peaceful and hostile attack
615     modes.
616    
617     When peaceful is on you will not automatically attack other player when
618     bumping into them and will do reduced damage against other players if
619     you do attack them (friendly fire). Having peaceful mode on only lowers
620     damage against other players, it has no effect on damage done to monsters
621     or other NPCs, so it is generally advisable to remain in peaceful mode
622     unless you are looking for trouble. It is still entirely possible to kill
623     other players when in peaceful mode so you should still be careful when
624     interacting with other players. Hostile mode (peaceful off) will enable
625     melee combat when bumping into other players and does normal damage for
626     other attacks as well.
627    
628     Damage done by area effect attacks like cone spells, explosive
629     detonations, fireballs, poisons, cloud or swarm attacks, runes or disease
630     are not modified by peaceful/hostile mode.
631    
632     =head2 X<petmode>petmode (normal|sad|defend|arena)
633    
634     B<petmode> controls how your pets (charmed monsters) will behave.
635    
636     The options are:
637    
638     =over 4
639    
640     =item B<normal>
641    
642 root 1.22 Monsters behave normally, i.e. according to their own character.
643 pippijn 1.1
644     =item B<sad> (search and destroy)
645    
646     Pets will roam and seek out things to attack.
647    
648     =item B<defend>
649    
650     Pets will try to stay close and defend you.
651    
652     =item B<arena>
653    
654     Like B<normal>, except that pets will attack other players in the arena.
655    
656     =back
657    
658     =head2 pickup
659    
660 root 1.20 pickup +mode
661     pickup -mode
662     pickup density
663    
664     B<pickup> changes whether you pick up items when you step on them. To
665     pickup an item manually, use the ',' key.
666    
667     The B<Pickup> tab in the playerbook is usually a better way to modify your
668     autopickup settings than using this command.
669    
670     Mode can be one of:
671    
672     "debug", "inhibit", "stop", "food", "drink", "valuables", "bow",
673     "arrow", "helmet", "shield", "armour", "boots", "gloves", "cloak",
674     "key", "missile", "allweapon", "magical", "potion", "spellbook",
675     "skillscroll", "readables", "magicdevice", "notcursed", "jewels",
676     "flesh"
677    
678 root 1.21 If a number (C<density>, must be 0..15) is specified, then items of at
679     least the specified value density are picked up. Value density is given as
680 root 1.20 gold/weight in kilograms.
681 pippijn 1.1
682     The value in gold is what the item is worth if you sold it in the shop.
683    
684     =head2 prepare
685    
686     The same as cast. Usage:
687    
688     prepare <spell>
689    
690    
691     =head2 quit
692    
693     Deletes your character from the server. If you want to quit the session
694     without deleting your character, you must use a I<Bed to Reality>. Find a
695     bed (probably in a building close to where you entered the game), get on
696     top of it, and apply it using B<Tab> ro the B<apply> command.
697    
698 root 1.13
699 pippijn 1.1 =head2 range
700    
701     Your range weapon can be one of several weapons, a spell you cast, a
702     bow-and-arrow, a rod, or a wand, to name a few.
703    
704     Your range weapon is fired when you press SHIFT-direction, and will be
705     fired in that direction.
706    
707 root 1.13
708 pippijn 1.1 =head2 ready_skill
709    
710     ready_skill <name of skill>
711    
712     Readies the given L<skill|pod/skill_help> by putting it in your L<range
713     slot|glossary/range slot>. Some skills are used automatically when
714     readied, some need to be actively used by "firing" them.
715    
716     If you just want to invoke a skill once, leaving your range slot
717     untouched, use L<use_skill> instead.
718    
719 root 1.13
720 pippijn 1.1 =head2 rename
721    
722 root 1.3 Changes/removes the custom name of given item (or the marked one).
723 pippijn 1.1
724 root 1.3 rename oldname to newname
725     rename "old item name" to "new item name"
726 pippijn 1.1
727 root 1.3 If either of the names contain spaces, you have to use the C<">-form,
728     otherwise you can just write the name as-is. If you omit the old name, the
729     marked item will be used instead.
730 pippijn 1.1
731 root 1.17 If the new name is empty (i.e. C<"">), then the original (before the
732     rename) name will be restored.
733 pippijn 1.1
734     Note: maximum allowed name length is 127 characters.
735    
736    
737     =head2 resistances
738    
739     This shows you the resistances you have to specific attack types.
740     If you have for example "cold +20", it means you get 20% damage done
741     by cold attacks. If you have "ghost hit -50", you will get 50% more
742     damage by ghost hits.
743    
744     If you are a dragon, you will also get your natural skin resistances
745     appened to the list. These will never lower, only rise.
746    
747     =head2 rotateshoottype
748    
749     Switches between spell, skill and weapon. Example:
750    
751     cast burning hands
752     ready_skill disarm traps
753     apply wand of medium fireball
754    
755     rotateshoottype # Switches to the spell (burning hands)
756     rotateshoottype # Switches to the wand (of medium fireball)
757     rotateshoottype # Switches to the skill (disarm traps)
758     rotateshoottype # Disables the range slot (won't use anything)
759     rotateshoottype # Switches back to the spell.. and so on
760    
761     =head2 say
762    
763     Will tell all players on the same map as yourself a message.
764    
765     =head2 save
766    
767     Updates players status to disk. This can be useful for making backup
768     copies if you fear the server is about to crash.
769    
770     The server saves your character automatically in certain intervals,
771     and also on clean shutdowns, so there is little practical use for this
772     command.
773    
774     WARNING - if you want to leave the game without destroying your player,
775     you must find a I<Bed to Reality> and hit B<Tab> on the bed to apply
776     it. Doing B<save> and then B<quit>ing will still delete your character.
777    
778     =head2 search-items
779    
780     search-items <word>
781    
782 root 1.20 Automatically picks up all items with <word> in their name. C<search-items
783     rod> will pick up all rods and heavy rods. C<search-items of Fire> will
784     pick up all bolts, arrows, swords, etc. of Fire, C<search-items magic+1>
785     will pick up all items with magic+1, and so on, and so on.
786    
787     While this mode is active, you will be slower and the normal autopickup is
788     disabled. To disable search mode again, execute C<search-items> without
789     any arguments.
790 pippijn 1.1
791     =head2 seen
792    
793     seen <login>
794    
795     Tells you when the player named <login> was last seen on the server (cf+
796     only).
797    
798     =head2 shout
799    
800     shout <message>
801    
802 root 1.16 Sends a message to all players on the server. It is mainly useful for
803 pippijn 1.1 emergency messages ("I am trapped on xxx, can somebody help me?") and
804     should not be used for general chat. Use L<chat|command/chat> instead.
805    
806     =head2 showpets
807    
808     showpets <number>
809    
810     Shows a numbered list of the pets owned by the player. If a number is
811     specified, instead shows a detailed printout about that pet.
812    
813     =head2 skills
814    
815     Lists all skills you have along with the experience you have in those skills.
816     Example:
817    
818     skills
819    
820     literacy................................lvl: 4 (xp:9944/16000/25%)
821     one handed weapons......................lvl: 4 (xp:15059/16000/25%)
822    
823     This shows you that you have two skills, literacy and one handed weapons. You
824     are level 4 in both skills and in literacy, you have 9944 experience points.
825     You need to reach 16000 to gain another level. The 25% at the end show you what
826     percentage of your experience is permanent, which means you cannot lose it if
827     you die.
828    
829     =head2 sound
830    
831     Toggles between sound enabled and disabled. This has no relevance to the
832 root 1.17 sound settings of the client, it only governs whether the server will send
833 pippijn 1.1 sound effect command to the client and is enabled if the client supports
834 root 1.17 sound (i.e. always for the deliantra client).
835 pippijn 1.1
836 root 1.29 An argument of C<0> disables and C<1> enables this option, no argument
837     toggles the setting.
838    
839 root 1.10 =head2 sourcecode
840    
841 root 1.17 This command displays the means to download the source code (server code,
842 root 1.10 maps and archetypes) used to implement this version of the game.
843    
844     Every player has the right to download and modify the source code of the
845     server, as required by both the GNU General Public License and the GNU
846     Affero General Public license.
847    
848     If you modify your version of the server, you will have to provide a means
849     to download the modified sources (and resources) via this command. If you
850     run an unmodified version of the server, the default will do.
851    
852 pippijn 1.1 =head2 statistics
853    
854     B<statistics> shows various useful information about your character.
855     None of the information it shows is stuff that is not contained in the
856     documentation.
857    
858     As of now, it shows how much experience you need for your next level. It
859     also shows natural, real, and maximum statistic values.
860    
861     Your natural stat is the stat without any items/spells applied.
862    
863     Real is what the current value is (same as in the stat window.)
864    
865     Maximum is the maximum value for your natural stat.
866    
867     =head2 suicide
868    
869     Kills yourself. No, really.
870    
871     This command might not look useful at first, but sometimes you can get
872     yourself into a corner you can't escape anymore, either due to a map
873     bug or your own stupidity. Killing oneself can be difficult and time
874 pippijn 1.19 consuming, that's why this command is provided. It is fast, painless,
875 pippijn 1.1 effective, humane.
876    
877     =head2 take
878    
879     The take commands take object(s) on the space the player is standing on,
880     and inserts them into the players inventory.
881    
882     If no parameter is given, take will get the top object that can be taken
883     and put it in the players inventory. If no object can be taken, that will
884     be stated.
885    
886     A parameter can be given to take. In this case, all object that have names
887     that match the parameter will be picked up. Thus, if there is a 'sword of
888     WOE', and 'sword +1' and a 'sword -3' on the ground, 'take sword' will
889     pick all of them up.
890    
891     By default, take is bound to the comma key, with no parameters. To change
892     this, look at the bind command.
893    
894     =head2 tell
895    
896     tell <playername> <message>...
897    
898     Sends a private message to the given player I<only>.
899    
900     =head2 throw
901    
902     Throws an unlocked item in your inventory, be it applied or not, into the
903     direction you are looking. If you mark an item in your inventory, this item
904     is thrown first. If there is more than one copy of an item, only one of it is
905     thrown away. God-given items can not be thrown. You need the skill throwing
906     for this to work.
907    
908     =head2 time
909    
910 root 1.14 Shows the Deliantra in-game time, not the server time. It looks like this:
911 pippijn 1.1
912 root 1.18 It is 52 minutes past 8 o'clock am, on the Day of the Bull,
913     the 2nd Day of the Month of the Frost Giant, Year 63.
914     Time of Year: The Season of New Year.
915    
916     An hour of game time passes in 3 minutes of real time. The time and
917     calendar uses 60 minutes per hour, 28 hours per day, seven days per week,
918     five weeks per month, and 17 months per year. The year is additionally
919     split into four seasons of 4 months each, except the season of the
920     Blizzard, which is 5 months long.
921 pippijn 1.1
922 root 1.18 The number "zero" is unknown, which is why the minutes go from 1 to 60.
923    
924     Seasons and the time of the day affect the overall outdoor daylight.
925 pippijn 1.1
926     =head2 title
927    
928 root 1.17 title <new title>
929     title clear # Sets your title back to your race.
930    
931 pippijn 1.1 Players can change their title. For example you called yourself Gandalf and
932     your race is elf, you can use the title command to change your name from
933 root 1.17 "Gandalf the elf" to "Gandalf the white" by using C<title the white>.
934 pippijn 1.1
935     Dragons cannot set their title because it changes during the game.
936    
937     =head2 unignore
938    
939     unignore <login>
940    
941     Cancels all ignores set for the specified login. See B<ignore>.
942    
943 elmex 1.25 =head2 unlock
944    
945     unlock [object]
946    
947     The unlock command is a quick and convenient way
948     to unlock items in your inventory.
949    
950     If a object name is specified then only the
951     objects that match that name are unlocked.
952    
953     e.g. unlock materials will unlock any materials
954     in your inventory and not touch anything else.
955    
956     unlock by itself will unlock everything in your
957     inventory.
958    
959 root 1.4 =head2 uptime
960    
961     Tells you something about the time the server was started and how long ago
962     that was.
963    
964 pippijn 1.1 =head2 use_skill
965    
966     use_skill <name of skill>
967    
968     Uses the given L<skill|pod/skill_help> immediately, once. See also
969     L<ready_skill>.
970    
971     =head2 usekeys (inventory|keyrings|containers)
972    
973     The B<usekeys> option determines the behaviour of using keys.
974    
975     Values are:
976    
977 root 1.17 =over 4
978 pippijn 1.1
979 root 1.17 =item B<inventory>: Only keys in the top level inventory are used (default)
980 pippijn 1.1
981 root 1.17 =item B<keyrings>: Only keys in active key rings are used.
982    
983     =item B<containers>: Only keys in active containers are used.
984    
985     =back
986 pippijn 1.1
987 root 1.17 Note that key rings are just a specialized container, so the containers
988     will also find keys in key rings.
989 pippijn 1.1
990     Only active containers are used - keys will not jump out of closed
991     containers, but hints will be given if you have keys in such containers.
992    
993     =head2 version
994    
995     Shows what version of the software the server is running on and what people
996     have contributed what to the game.
997    
998     =head2 weather
999    
1000     Gives you information about the current weather of outside areas, if the
1001     server has weather support (which is unlikely, as it is very broken).
1002    
1003     =head2 whereabouts
1004    
1005     The whereabouts command gives a summary about the
1006     regions in which players are currently staying.
1007    
1008     =head2 whereami
1009    
1010     Tells you some historical information on the region you are currently in.
1011    
1012     =head2 who
1013    
1014     Shows what players are playing in the world and where they are. It may also
1015     show their levels and race or title. (See the L<title|command/title> command)
1016    
1017     B<who> optionally takes an argument that limits the players shown to
1018     the specified region, e.g. B<who brest> will show all players playing
1019     somewhere in Brest.
1020    
1021     =head2 wimpy
1022    
1023     The wimpy level is the amount of health points (hp) that may be left before you
1024     automatically run away. This may be useful in hand-to-hand combats but should
1025     not be used when the opponent attacks with spells.
1026    
1027 root 1.8
1028 pippijn 1.1 =head1 Authors
1029    
1030     Parts of this document were originally taken from the crossfire server
1031 root 1.16 help files with unknown authors.
1032 pippijn 1.1
1033 root 1.14 Adapted for use by I<deliantra>, enhanced and corrected by Pippijn van
1034 pippijn 1.1 Steenhoven and Marc A. Lehmann.
1035