Ticket #1544: playing.txt

File playing.txt, 16.8 KB (added by PowerWyrm, 8 years ago)

Updated command list for both keysets.

Line 
1================
2Playing the Game
3================
4
5Most of your interaction with Angband will take the form of "commands".
6Every Angband command consists of an "underlying command" plus a variety of
7optional or required arguments, such as a repeat count, a direction, or the
8index of an inventory object. Commands are normally specified by typing a
9series of keypresses, from which the underlying command is extracted, along
10with any encoded arguments. You may choose how the standard "keyboard keys"
11are mapped to the "underlying commands" by choosing one of the two standard
12"keysets", the "original" keyset or the "roguelike" keyset.
13
14The original keyset is very similar to the "underlying" command set, with a
15few additions (such as the ability to use the numeric "directions" to
16"walk" or the ``5`` key to "stay still"). The roguelike keyset provides
17similar additions, and also allows the use of the
18``h``/``j``/``k``/``l``/``y``/``u``/``b``/``n`` keys to "walk" (or, in
19combination with the shift or control keys, to run or alter), which thus
20requires a variety of key mappings to allow access to the underlying
21commands used for walking/running/altering. In particular, the "roguelike"
22keyset includes many more "capital" and "control" keys, as shown below.
23
24Note that any keys that are not required for access to the underlying
25command set may be used by the user to extend the "keyset" which is being
26used, by defining new "keymaps". To avoid the use of any "keymaps", press
27backslash (``\``) plus the "underlying command" key. You may enter
28"control-keys" as a caret (``^``) plus the key (so ``^`` + ``p`` yields
29``^p``).
30
31Some commands allow an optional "repeat count", which allows you to tell
32the game that you wish to do the command multiple times, unless you press a
33key or are otherwise disturbed. To enter a "repeat count", type ``0``,
34followed by the numerical count, followed by the command. You must type
35``space`` before entering certain commands. Skipping the numerical count
36yields a count of 99. An option allows certain commands (open, disarm,
37alter, etc) to auto-repeat.
38
39Some commands will prompt for extra information, such as a direction, an
40inventory or equipment item, a spell, a textual inscription, the symbol of
41a monster race, a sub-command, a verification, an amount of time, a
42quantity, a file name, or various other things. Normally you can hit return
43to choose the "default" response, or escape to cancel the command entirely.
44
45Some commands will prompt for a spell or an inventory item. Pressing pace
46(or ``*``) will give you a list of choices. Pressing ``-`` (minus) selects
47the item on the floor. Pressing a lowercase letter selects the given item.
48Pressing a capital letter selects the given item after verification.
49Pressing a numeric digit ``#`` selects the first item (if any) whose
50inscription contains ``@#`` or ``@x#``, where ``x`` is the current
51"underlying command". You may only specify items which are "legal" for the
52command. Whenever an item inscription contains ``!*`` or ``!x`` (with ``x``
53as above) you must verify its selection.
54
55Some commands will prompt for a direction. You may enter a "compass"
56direction using any of the "direction keys" shown below. Sometimes, you may
57specify that you wish to use the current "target", by pressing ``t`` or
58``5``, or that you wish to select a new target, by pressing ``*`` (see
59"Target" below).
60
61        Original Keyset Directions
62                 =  =  =                           
63                 7  8  9
64                 4     6
65                 1  2  3
66                 =  =  =
67
68        Roguelike Keyset Directions
69                 =  =  =
70                 y  k  u
71                 h     l
72                 b  j  n
73                 =  =  =
74
75Each of the standard keysets provides some short-cuts over the "underlying
76commands". For example, both keysets allow you to "walk" by simply pressing
77an "original" direction key (or a "roguelike" direction key if you are
78using the roguelike keyset), instead of using the "walk" command plus a
79direction. The roguelike keyset allows you to "run" or "alter" by simply
80holding the shift or control modifier key down while pressing a "roguelike"
81direction key, instead of using the "run" or "alter" command plus a
82direction. Both keysets allow the use of the ``5`` key to "stand still",
83which is most convenient when using the original keyset.
84
85Original Keyset Command Summary
86===============================
87
88======== =============================  ====== ============================
89 ``a``   Aim a wand                     ``A``  Activate an artifact
90 ``b``   Browse a book                  ``B``  Bash a door
91 ``c``   Close a door                   ``C``  Character description
92 ``d``   Drop an item                   ``D``  Disarm a trap or lock a door
93 ``e``   Equipment list                 ``E``  Eat some food
94 ``f``   Fire an item                   ``F``  Fuel your lantern/torch
95 ``g``   Get objects on floor           ``G``  Gain new spells/prayers
96 ``h``   Fire at nearest target         ``H``  (unused)
97 ``i``   Inventory list                 ``I``  Observe an item
98 ``j``   Jam a door                     ``J``  (unused)
99 ``k``   Ignore/unignore items          ``K``  Toggle ignoring of items
100 ``l``   Look around                    ``L``  Locate player on map
101 ``m``   Cast a spell                   ``M``  Full dungeon map
102 ``n``   (unused)                       ``N``  (unused)
103 ``o``   Open a door or chest           ``O``  (unused)
104 ``p``   Pray a prayer                  ``P``  (unused)
105 ``q``   Quaff a potion                 ``Q``  Quit (commit suicide)
106 ``r``   Read a scroll                  ``R``  Rest for a period
107 ``s``   Search for traps/doors         ``S``  Toggle search mode
108 ``t``   Take off equipment             ``T``  Dig a tunnel
109 ``u``   Use a staff                    ``U``  (unused)
110 ``v``   Throw an item                  ``V``  Version info
111 ``w``   Wear/wield equipment           ``W``  Walk into a trap
112 ``x``   (unused)                       ``X``  (unused)
113 ``y``   (unused)                       ``Y``  (unused)
114 ``z``   Zap a rod                      ``Z``  (unused)
115 ``!``   Interact with system           ``^A``  (special - debug command)
116 ``@``   (unused)                       ``^B``  (unused)
117 ``#``   (unused)                       ``^C``  (special - break)
118 ``$``   (unused)                       ``^D``  (unused)
119 ``%``   (unused)                       ``^E``  Toggle choice window
120 ``^``   (special - control key)        ``^F``  Repeat level feeling
121 ``&``   (unused)                       ``^G``  (unused)
122 ``*``   Target monster or location     ``^H``  (unused)
123 ``(``   Load screen dump               ``^I``  (special - tab)
124 ``)``   Dump screen dump               ``^J``  (special - linefeed)
125 ``{``   Inscribe an object             ``^K``  (unused)
126 ``}``   Uninscribe an object           ``^L``  (unused)
127 ``[``   Display visible monster list   ``^M``  (special - return)
128 ``]``   Display visible object list    ``^N``  (unused)
129 ``-``   Walk (flip pickup)             ``^O``  (unused)
130 ``_``   Enter store                    ``^P``  Show previous messages
131 ``+``   Alter grid                     ``^Q``  (unused)
132 ``=``   Set options                    ``^R``  Redraw the screen
133 ``;``   Walk (with pickup)             ``^S``  Save and don't quit
134 ``:``   Take notes                     ``^T``  (unused)
135 ``'``   Target closest monster         ``^U``  (unused)
136 ``"``   Enter a user pref command      ``^V``  Repeat last command
137 ``,``   Stay still (with pickup)       ``^W``  (special - wizard mode)
138 ``<``   Go up staircase                ``^X``  Save and quit
139 ``.``   Run                            ``^Y``  (unused)
140 ``>``   Go down staircase              ``^Z``  (special - borg command)
141 ``\``   (special - bypass keymap)      ``|``  (unused)
142  |`|    (special - escape)             ``~``  Check knowledge
143 ``/``   Identify symbol                ``?``  Help
144======== =============================  ====== ============================
145
146.. |`| replace:: \ `````
147
148Roguelike Keyset Command Summary
149================================
150
151======= =============================  ======= ============================
152 ``a``  Zap a rod (Activate)            ``A``  Activate an artifact
153 ``b``  (walk - south west)             ``B``  (run - south west)
154 ``c``  Close a door                    ``C``  Character description
155 ``d``  Drop an item                    ``D``  Disarm a trap or lock a door
156 ``e``  Equipment list                  ``E``  Eat some food
157 ``f``  Bash a door (Force)             ``F``  Fuel your lantern/torch
158 ``g``  Get objects on floor            ``G``  Gain new spells/prayers
159 ``h``  (walk - west)                   ``H``  (run - west)
160 ``i``  Inventory list                  ``I``  Observe an item
161 ``j``  (walk - south)                  ``J``  (run - south)
162 ``k``  (walk - north)                  ``K``  (run - north)
163 ``l``  (walk - east)                   ``L``  (run - east)
164 ``m``  Cast a spell                    ``M``  Full dungeon map
165 ``n``  (walk - south east)             ``N``  (run - south east)
166 ``o``  Open a door or chest            ``O``  (unused)
167 ``p``  Pray a prayer                   ``P``  Browse a book (Peruse)
168 ``q``  Quaff a potion                  ``Q``  Quit (commit suicide)
169 ``r``  Read a scroll                   ``R``  Rest for a period
170 ``s``  Search for traps/doors          ``S``  Jam a door (Spike)
171 ``t``  Fire an item                    ``T``  Take off equipment
172 ``u``  (walk - north east)             ``U``  (run - north east)
173 ``v``  Throw an item                   ``V``  Version info
174 ``w``  Wear/wield equipment            ``W``  Locate player on map (Where)
175 ``x``  Look around (Examine)           ``X``  (unused)
176 ``y``  (walk - north west)             ``Y``  (run - north west)
177 ``z``  Aim a wand (Zap)                ``Z``  Use a staff (Zap)
178 ``!``  Interact with system            ``^A`` (special - debug command)
179 ``@``  (unused)                        ``^B`` (alter - south west)
180 ``#``  Toggle search mode              ``^C`` (special - break)
181 ``$``  (unused)                        ``^D`` Ignore/unignore items
182 ``%``  (unused)                        ``^E`` Toggle choice window
183 ``^``  (special - control key)         ``^F`` Repeat level feeling
184 ``&``  (unused)                        ``^G`` Toggle ignoring of items
185 ``*``  Target monster or location      ``^H`` (alter - west)
186 ``(``  Load screen dump                ``^I`` (special - tab)
187 ``)``  Dump screen dump                ``^J`` alter - south)
188 ``{``  Inscribe an object              ``^K`` (alter - north)
189 ``}``  Uninscribe an object            ``^L`` (alter - east)
190 ``[``  Display visible monster list    ``^M`` (special - return)
191 ``]``  Display visible object list     ``^N`` (alter - south east)
192 ``-``  Walk (flip pickup)              ``^O`` (unused)
193 ``_``  Enter store                     ``^P`` Show previous messages
194 ``+``  Alter grid                      ``^Q`` (unused)
195 ``=``  Set options                     ``^R`` Redraw the screen
196 ``;``  Walk (with pickup)              ``^S`` Save and don't quit
197 ``:``  Take notes                      ``^T`` Dig a tunnel
198 ``'``  Target closest monster          ``^U`` (alter - north east)
199 ``"``  Enter a user pref command       ``^V`` Repeat last command
200 ``,``  Run                             ``^W`` (special - wizard mode)
201 ``<``  Go up staircase                 ``^X`` Save and quit
202 ``.``  Stay still (with pickup)        ``^Y`` (alter - north west)
203 ``>``  Go down staircase               ``^Z`` (special - borg command)
204 ``\``  (special - bypass keymap)       ``|``  (unused)
205  |`|   (special - escape)              ``~``  Check knowledge
206 ``/``  Identify symbol                 ``?``  Help
207======= =============================  ======= ============================
208
209Special Keys
210============
211 
212Certain special keys may be intercepted by the operating system or the host
213machine, causing unexpected results. In general, these special keys are
214control keys, and often, you can disable their special effects.
215
216If you are playing on a UNIX or similar system, then ``Ctrl-C`` will
217interrupt Angband. The second and third interrupt will induce a warning
218bell, and the fourth will induce both a warning bell and a special message,
219ince the fifth will quit the game, after killing your character. Also,
220``Ctrl-Z`` will suspend the game, and return you to the original command
221shell, until you resume the game with the ``fg`` command. There is now a
222compilation option to force the game to prevent the "double ``ctrl-z``
223escape death trick". The |``Ctrl-\``| and ``Ctrl-D`` and ``Ctrl-S`` keys
224should not be intercepted.
225 
226It is often possible to specify "control-keys" without actually pressing
227the control key, by typing a caret (``^``) followed by the key. This is
228useful for specifying control-key commands which might be caught by the
229operating system as explained above.
230
231Pressing backslash (``\``) before a command will bypass all keymaps, and
232the next keypress will be interpreted as an "underlying command" key,
233unless it is a caret (``^``), in which case the keypress after that will be
234turned into a control-key and interpreted as a command in the underlying
235angband keyset. The backslash key is useful for creating actions which are
236not affected by any keymap definitions that may be in force, for example,
237the sequence ``\`` + ``.`` + ``6`` will always mean "run east", even if the
238``.`` key has been mapped to a different underlying command.
239
240The ``0`` and ``^`` and ``\`` keys all have special meaning when entered at
241the command prompt, and there is no "useful" way to specify any of them as
242an "underlying command", which is okay, since they would have no effect.
243
244For many input requests or queries, the special character ``ESCAPE`` will
245abort the command. The ``[y/n]`` prompts may be answered with ``y`` or
246``n``, or ``escape``. The ``-more-`` message prompts may be cleared (after
247reading the displayed message) by pressing ``ESCAPE``, ``SPACE``,
248``RETURN``, ``LINEFEED``, or by any keypress, if the ``quick_messages``
249option is turned on.
250 
251Command Counts
252==============
253 
254Some commands can be executed a fixed number of times by preceding them
255with a count. Counted commands will execute until the count expires, until
256you type any character, or until something significant happens, such as
257being attacked. Thus, a counted command doesn't work to attack another
258creature. While the command is being repeated, the number of times left to
259be repeated will flash by on the line at the bottom of the screen.
260
261To give a count to a command, type 0, the repeat count, and then the
262command. If you want to give a movement command and you are using the
263original command set (where the movement commands are digits), press space
264after the count and you will be prompted for the command.
265 
266Counted commands are very useful for time consuming commands, as they
267automatically terminate on success, or if you are attacked. You may also
268terminate any counted command (or resting or running), by typing any
269character. This character is ignored, but it is safest to use a ``SPACE``
270or ``ESCAPE`` which are always ignored as commands in case you type the
271command just after the count expires.
272
273You can tell Angband to automatically use a repeat count of 99 with
274commands you normally want to repeat (open, disarm, tunnel, bash, alter,
275etc) by setting the ``always_repeat`` option.
276 
277Selection of Objects
278====================
279 
280Many commands will also prompt for a particular object to be used.
281For example, the command to read a scroll will ask you which of the
282scrolls that you are carrying that you wish to read.  In such cases, the
283selection is made by typing a letter of the alphabet.  The prompt will
284indicate the possible letters, and will also allow you to type the key
285``*``, which causes all of the available options to be described.  The list
286of choices will also be shown in the Choice window, if you are using a
287windows environment and windows are turned on.  Often you will be able to
288press ``/`` to select an object from your equipment instead of your
289inventory.  Pressing ``space`` once will have the same effect as ``*``, and
290the second time will cancel the command and run the ``i`` or ``e`` command.
291 
292The particular object may be selected by an upper case or a lower case
293letter. If lower case is used, the selection takes place immediately. If
294upper case is used, then the particular option is described, and you are
295given the option of confirming or retracting that choice. Upper case
296selection is thus safer, but requires an extra key stroke. Also see the
297``!*`` and ``!x`` inscriptions, below.
298
299For many commands, you can also use ``-`` to select an object on the floor
300where you are standing. This lets you read scrolls or quaff potions, for
301example, off the dungeon floor without picking them up.
302
303If you enter a number between 0 and 9, the first item engraved with ``@#``
304where ``#`` is the number you entered will be selected. See the section
305"Using Inscriptions" for more detail.
306
307.. |``Ctrl-``| replace:: ``Ctrl-\\``
308   I am not sure what is happening, but this yields the correct result
309