Commands

Commands are entered using the keyboard by pressing a single key that 
is mapped to an underlying command interpreted by the game. This 
mapping of keystrokes to game commands proceeds by using one of two 
standard keysets: the Original Keyset and the Roguelike Keyset. The 
Original Keyset, which is the default, is generally recommended to new 
players since it is more intuitive (for example, you move with the 
numpad keys). However, many strong players use the Roguelike keyset, 
and it is likely your best option if you lack a numpad on your keyboard 
(trying to just substitute the arrow keys for the numpad stops being a 
great idea when you have to move diagonally). You can toggle the 
keysets through the = options menu.

This file contains the command mappings for the two keysets mentioned 
above. For a detailed overview of the various commands, see [a]. Also, 
for beginners, pressing ENTER opens a unified command menu that lists 
all commands and the corresponding keystrokes; this menu is intended 
for learning the commands on the go, and is much clumsier than just 
remembering the right key, so you want to grow out of it as soon as 
possible. (You may enable/disable the menu with the 'command_menu' 
input option; see [b] for more on setting options.)

Don't be overwhelmed by the sheer number of commands. Many are not 
often used or required, and I have tried to highlight the most common 
commands below in yellow. You should try to memorize those; note that 
many commands use a mnemonic just like the Eat command discussed above. 
The caret (^) in the tables below indicates pressing the CTRL key (so 
^S means Ctrl-S), though it is also possible to treat these commands as 
literal two-key sequences beginning with the ^ key.

Once you have chosen a game command, you may be prompted for additional 
input; for example, if you get hungry and decide to eat some food 
(eating is E in both keysets), the game will give you a list of choices 
(which might include rations of food, various mushrooms, and whatever 
other edibles you happen to have in your pack). You can cancel the 
command with the ESC key at this point.

Note in particular the multi-purpose + command; often, if you forget 
what the regular command for interacting with something in an adjacent 
square is, you can just substitute + instead. You can tunnel with +, 
open doors with +, disarm traps with +, even fight a monster with +... 
and the list continues.

Press ? for commands to use in the help interface itself.

Original Keyset

       Movement
       7  8  9
       4  5  6
       1  2  3

   a  Aim a wand                           A  Activate equipment
   b  Browse magic list                    B  Bash a door
   c  Close a door                         C  Character description
   d  Drop an item                         D  Disarm a trap
   e  Equipment list                       E  Eat some food
   f  Fire an arrow etc.                   F  Fuel your lantern/torch
   g  Pick up objects (Get)                G  Gain new spells/prayers
   h  (unused)                             H  Travel to interesting item
   i  Inventory list                       I  Inspect an item
   j  Jam a door                           J  Resume travelling
   k  Destroy an item                      K  (unused)
   l  Look around                          L  Locate player on map
   m  Cast a spell / use mental power      M  Full dungeon map
   n  Repeat last command                  N  (unused)
   o  Open a door or chest                 O  Display object list
   p  Command your pets                    P  (unused)
   q  Quaff a potion                       Q  Quit (commit suicide)
   r  Read a scroll                        R  Rest for a period
   s  Search for traps/doors               S  Toggle search mode
   t  Take off equipment                   T  Dig a tunnel
   u  Use a staff                          U  Use racial/bonus power
   v  Throw an item                        V  Version info
   w  Wear/wield equipment                 W  Switch ring fingers
   x  (unused)                             X  (unused)
   y  (unused)                             Y  Display monster list
   z  Zap a rod                            Z  Inscribe an object
   !  Enter a user pref command           ^A  (special - wizard command)
   @  Interact with macros                ^B  (unused)
   #  (unused)                            ^C  (special - break)
   $  Reload Mogaminator prefs            ^D  (unused)
   %  Interact with visuals               ^E  Interact with macros
   ^  (special - control key)             ^F  Repeat level feeling
   &  Interact with colors                ^G  Auto-Get nearby objects
   *  Target monster or location          ^H  (unused)
   (  (unused)                            ^I  Toggle choice window
   )  Create screen dump                  ^J  (special - linefeed)
   {  Inscribe an object                  ^K  (unused)
   }  Uninscribe an object                ^L  (unused)
   [  Display monster list                ^M  (special - return)
   ]  Display object list                 ^N  (unused)
   -  Walk (flip pickup)                  ^O  Display object list
   _  Edit/activate Mogaminator prefs     ^P  Show previous messages
   +  Alter adjacent grid                 ^Q  Display quest info
   =  Set options                         ^R  Redraw the screen
   ;  Walk                                ^S  Save and don't quit
   :  Take notes                          ^T  Display game time
   '  Playback recorded command           ^U  (unused)
   "  Record command                      ^V  Recenter Viewport
   ,  Stay still                          ^W  (special - wizard mode)
   <  Go up staircase/Toggle global map   ^X  Save and quit
   .  Run                                 ^Y  (special - wizard mode)
   >  Go down staircase/Enter normal map  ^Z  (special - borg command)
   \  (special - bypass keymap)            |  (unused)
   `  Travel to location                   ~  Knowledge menu
   /  Identify symbol                      ?  Help


Roguelike Keyset

       Movement
       y  k  u
       h  .  l
       b  j  n

   a  Zap a rod (Activate)                 A  Activate equipment
   b  (walk - south west)                  B  (run - south west)
   c  Close a door                         C  Character description
   d  Drop an item                         D  Disarm a trap or chest
   e  Equipment list                       E  Eat some food
   f  Bash a door (Force)                  F  Fuel your lantern/torch
   g  Pick up objects (Get)                G  Gain new spells/prayers
   h  (walk - west)                        H  (run - west)
   i  Inventory list                       I  Inspect an item
   j  (walk - south)                       J  (run - south)
   k  (walk - north)                       K  (run - north)
   l  (walk - east)                        L  (run - east)
   m  Cast a spell / use mental power      M  Full dungeon map
   n  (walk - south east)                  N  (run - south east)
   o  Open a door or chest                 O  Use racial/bonus power
   p  Command your pets                    P  Browse magic list (Peruse)
   q  Quaff a potion                       Q  Quit (commit suicide)
   r  Read a scroll                        R  Rest for a period
   s  Search for traps/doors               S  Jam a door (Spike)
   t  Fire an arrow etc.                   T  Take off equipment
   u  (walk - north east)                  U  (run - north east)
   v  Throw an item                        V  Version info
   w  Wear/wield equipment                 W  Locate player on map
   x  Look around                          X  Repeat last command
   y  (walk - north west)                  Y  (run - north west)
   z  Aim a wand (Zap)                     Z  Use a staff (Zap)
   !  Enter a user pref command           ^A  (special - wizard command)
   @  Interact with macros                ^B  (tunnel - south west)
   #  Toggle search mode                  ^C  (special - break)
   $  Reload Mogaminator prefs            ^D  Destroy item
   %  Interact with visuals               ^E  Travel to interesting item
   ^  (special - control key)             ^F  Repeat level feeling
   &  Interact with colors                ^G  Auto-Get nearby objects
   *  Target monster or location          ^H  (tunnel - west)
   (  Resume travelling                   ^I  Toggle choice window
   )  Create screen dump                  ^J  (tunnel - south)
   {  Inscribe an object                  ^K  (tunnel - north)
   }  Uninscribe an object                ^L  (tunnel - east)
   [  Display monster list                ^M  (tunnel - south)
   ]  Display object list                 ^N  (tunnel - south east)
   -  Walk (flip pickup)                  ^O  (unused)
   _  Edit/activate Mogaminator prefs     ^P  Show previous messages
   +  Alter adjacent grid                 ^Q  Display quest info
   =  Set options                         ^R  Redraw the screen
   ;  Walk                                ^S  Save and don't quit
   :  Take notes                          ^T  Dig a Tunnel
   '  Playback recorded command           ^U  (tunnel - north east)
   "  Record command                      ^V  Recenter Viewport
   ,  Run                                 ^W  (special - wizard mode)
   <  Go up staircase/Toggle global map   ^X  Save and quit
   .  Stay still                          ^Y  (tunnel - north west)
   >  Go down staircase/Enter normal map  ^Z  (unused)
   \  (special - bypass keymap)            |  (unused)
   `  Travel to location                   ~  Knowledge menu
   /  Identify symbol                      ?  Help


Command Counts

Some commands can be executed a fixed number of times by preceding them 
with a count. Counted commands will repeat until the count expires or 
until the repetition is disturbed. A successful use of the command 
(e.g. successful tunnelling) disturbs the repetition, as does any 
attack from a monster, or any new command from the player.

The always_repeat option, which is on by default, automatically gives 
commonly repeated commands (open, disarm, tunnel, bash, etc.) a repeat 
count of 99. This means you usually don't need to specify repeat counts 
manually; but you can do so by typing 0, then the repeat count, and 
then the command.

Command Arguments

As already seen in the Eat example, some commands will prompt for extra 
information; depending on the command, this could be a direction, an 
inventory or equipment item, a spell, the symbol of a monster race, a 
sub-command, a verification, a count, a quantity, text, or various 
other things. Often, you can hit ENTER to choose the "default" response 
and ESC to cancel the command entirely.

Commands which prompt for a direction always accept compass directions, 
which you can enter using the direction keys shown above. Commands with 
the potential to affect distant squares or monsters usually also accept 
targets, which you can set (either beforehand or when prompted) with 
the * key. If you had previously specified a target, pressing 5 repeats 
the old target; or if you turned on the use_old_target option, the old 
target is repeated automatically. Some players really like 
use_old_target, others dislike it equally much; see [c] for more 
details on selecting a target.

Item Labels

Many commands prompt for an item. These commands always display a list 
of all applicable items, where each item has a distinct single-key 
label; you then select the right item by pressing the label key.

Item labels usually run from 'a' for the first applicable item to 'z' 
for the 26th item, and are not necessarily the same in every menu. In 
the example below, the drop command simply offers every item in the 
inventory as a possibility, so Scrolls of Genocide are labeled 'l':

Inventory | Equipment | Quiver                                                  
 a) ? a Law Book [Obstacle Coursebook] {25% off, @mb!k}      3.0 lb LEVEL     50
 b) ? a Law Book [Building Alternative Realities] {@mc!sd    3.0 lb EXP ********
 c) ? a Law Book [Acquiris Quodcumque Rapis] {@md!sdk}       3.0 lb AU      462k
 d) , 23 Mushrooms of Restoring {!E}                         2.3 lb |)}~=="~((]]
 e) ! 15 Potions of Speed {25% off, !kq}                     6.0 lb STR!: 18/160
 f) ! 15 Potions of Heroism                                  6.0 lb INT!: 18/160
 g) ! 41 Potions of Healing {!kq}                           16.4 lb WIS!: 18/160
 h) ! 8 Potions of *Healing* {!kq}                           3.2 lb DEX : 18/***
 i) ! 5 Potions of Life {!kq}                                2.0 lb CON : 18/217
 j) ! 18 Potions of Restore Mana {!kq}                       7.2 lb CHR!: 18/150
 k) ? 12 Scrolls of Destruction {@r7!*}                      6.0 lb AC       156
 l) ? 9 Scrolls of Genocide {!*}                             4.5 lb HP  950/ 951
 m) ? 8 Scrolls of Mass Genocide {!*}                        4.0 lb SP  141/ 402
 n) - a Rod: Clairvoyance (2/2 charges) {47%}                1.5 lb             
 o) - a Rod: Detection (7/7 charges) {1%, @zb!sdk}           1.5 lb             
 p) - a Rod: Recall (5/5 charges) {1%, @zc!sdk}              1.5 lb             
 q) - a Wand of Resistance: Teleport Other (29/29 charges    0.2 lb             
 r) - a Wand of Regeneration: Annihilation (8/8 charges)     0.2 lb             
 s) - a Wand of Regeneration: Tsunami (14/14 charges) (+5    0.2 lb             
 t) _ a Staff: Teleport (17/28 charges) {1%, @ua!sdk}        5.0 lb             
 u) _ a Staff: Destruction (2/8 charges) {1%, @ud!sdk}       5.0 lb Fast (+33)  
 v) _ a Staff of Resistance: Telepathy (3/9 charges) {1%,    5.0 lb Cursed      
 w) _ a Staff: Cure Wounds (8/18 charges) {1%, @uu!sdk}      5.0 lb Study (4)   
 x) _ a Staff of Holding: Confusing Lights (7/7 charges)     5.0 lb             
 y) [ Metal Scale Mail {special}                            25.0 lb             
 z) ( Soft Leather Armour {excellent}                        8.0 lb             
                                                           129.7 lb             
Drop which item?                                                                
Angband: L100                           Telepa DTrap


But if instead of the drop command we use the read command, Scrolls of 
Genocide become 'b' since only scrolls are now offered as options:

Inventory                                                     Fail              
 7) ? 12 Scrolls of Destruction {@r7!*}                        2.8%
 b) ? 9 Scrolls of Genocide {!*}                               2.8%
 c) ? 8 Scrolls of Mass Genocide {!*}                          3.3%

Read which scroll? 


You might notice something odd, though: while Scrolls of Genocide are 
expectedly labeled 'b' as the second item listed and Scrolls of Mass 
Genocide are 'c' as the third item, Scrolls of Destruction are not 
labeled 'a' but rather '7'. This is because the Scrolls of Destruction 
have been inscribed with the inscription @r7, which simply tells the 
game to label them '7' in the 'r' Read a Scroll menu.

The advantage of inscribing items in this way is that they retain their 
label even when items are added to or removed from the list. Note, for 
instance, that three books in the example inventory are inscribed @mb 
through @md; this allows them to keep their usual, "expected" labels in 
the m spellcasting menu even though the first book, book 'a', is 
missing.

Inscriptions are added with the Z/{ command, and can be used for many 
other purposes besides item labeling (see [d] for more detail). The 
Mogaminator often automatically applies standard inscriptions to items; 
the three books of the above example were inscribed by the Mogaminator. 
Note that inscriptions are always based on the underlying keyset, which 
for the most part is the same as the original keyset; so if you want a 
staff to be labeled 'y' in the "Use a Staff" prompt, you should 
inscribe it @uy rather than @Zy even if you use the roguelike keyset.

    Note: Many object selection menus allow you to select 
    items from any of several inventories, which you can 
    toggle between by pressing /. In the drop example 
    above, the default inventory is your backpack, but you 
    can use / to select an item from your equipment or 
    quiver instead.


Original   : Alexander Cutler and Andy Astrand
Updated    : (2.7.6) by Russ Allbery ([email protected])
Updated    : (2.7.9) by Ben Harrison ([email protected])
Updated    : Zangband 2.2.0 through 2.2.6c by Robert Ruehlmann
Updated    : Zangband DevTeam
Updated    : Hengband 1.0.11
Updated    : PosChengband 6.0.0
Updated    : FrogComposband 7.1.liquorice