ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/pod/command_help.pod
Revision: 1.7
Committed: Sun Mar 18 03:05:40 2007 UTC (17 years, 3 months ago) by root
Branch: MAIN
Changes since 1.6: +8 -4 lines
Log Message:
- reduce default output-sync to less than a second
- output-sync command now uses seconds as unit, not
  something users cannot even know.
- lots of useless const adjustments.

File Contents

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