List of Keys and Commands


Problems running or configuring the software, commands & options, compiling, different platforms, using the interface, documentation, etc.

Halls Hopper

Posts: 60

Joined: Friday, 17th December 2010, 02:30

Post Wednesday, 22nd December 2010, 18:59

List of Keys and Commands

To avoid threads for all the different commands I hope this will come in handy.

?? gives you a list of Commands.

Pressing ?4 gives a detailed description same as in the crawl_manual.txt in your crawl/docs directory.

I copied the section:
  Code:
------------------------------------------------------------------------
4.                      LIST OF KEYS AND COMMANDS
------------------------------------------------------------------------

Main screen
-----------
Crawl has many commands to be issued by single key strokes. This can
become confusing, since there are also several modes; here is the full
list. Some commands are particularly useful in combination with certain
interface options; such options are mentioned in the list. For a
description of them, please look into options_guide.txt. For a more
terse list of all commands, use '??' in-game. Most modes (targeting,
level map, interlevel travel) also have help menus via '?' on their own.

Saving games:
    S                   Save game with query and exit.
    Ctrl-S              Save game without query and exit.
    Ctrl-Q              Quit without saving (you're asked before).

Movement:
    direction           Moves one square, direction is either one of
                        the numpad cursor keys (try both Numlock on and
                        off) or  one of the Rogue vi keys (hjklyubn).
    Shift-direction     This moves straight until something interesting
    or  / direction     is found (like a monster). If the first square
                        is a trap, movement starts nonetheless.
    o                   Auto-explore. Setting the option explore_greedy
                        to true makes auto-explore run to interesting
                        items (those that get picked up automatically)
                        or piles (checking the contents).
                        Autoexploration will open doors on its own
                        except if you set easy_open to false.
    Ctrl-G              Interlevel travel (to arbitrary dungeon levels
    or   G              or waypoints). Remembers old destinations if
                        interrupted. This command has its own set of
                        shortcuts; use ? for help on them.
    Ctrl-W              Set waypoint (a digit between 0 and 9). Check
                        the option show_waypoints. You can go to a
                        waypoint by pressing Ctrl-G or G and the digit.

Resting and Searching:
    s, Del, . or        Rests and searches (these are not distinguished)
    Numpad 5            for one turn. This is most often used tactically
                        for waiting a few turns. Serious resting or
                        searching should be done with the 5 command.
    5 or                Long resting/searching (until both health and
    Shift-Numpad 5      magic  points are full or something is found or
                        100 turns are over).

Dungeon interaction:
    O                   Open door. This is usually done automatically by
                        walking into the door, unless you set the option
                        easy_open to false.
    C                   Close door.
    Ctrl-direction      Tries to untrap a known trap on the specified
    or * direction      square, else opens/closes door if there is one,
                        else attacks without move (even if no monster is
                        seen).
    <                   Use staircase to go higher, also enters shops.
    >                   Use staircase to go deeper, also enters branch.
    ;                   Examine occupied tile, also causes auto-pickup.
    x                   Examine surroundings, see below. Has '?' help.
    X                   Examine level map, see below. Has '?' help.
    Ctrl-X              Lists all monsters, items and features in sight.
                        You may read their descriptions and travel to
                        an item or feature.
    Ctrl-O              Show dungeon overview (branches, shops, etc.).
    !                   Annotate current level: you can enter any text.
                        This annotation is then listed in the dungeon
                        overview (Ctrl-O) and also shown whenever you
                        enter that level again. If you use this command
                        when standing on a staircase, you may also
                        annotate the level that staircase leads to.
                        Should your annotation contain an exclamation
                        mark (!), you will be prompted before entering
                        the level. An empty string clears annotations.

Character information:
'display' below means usage of the message area,
'show' means usage of the whole screen.
    @                   Display character status.
    [                   Display worn armour.
    }                   Display wielded and secondary weapons,
                        and missiles (to be shot with the 'f' command).
    "                   Display worn jewellery.
    E                   Display experience info.
    ^                   Show religion screen.
    A                   Show abilities/mutations.
    a                   Choose an ability or read its description.
                        a? or a* show current abilities as a menu.
    \                   Show item knowledge.
    m                   Show skill screen. You can get descriptions of
                        present skills from that screen, as well as the
                        aptitudes.
    i                   Show inventory list. Inside this list, pressing
                        a slot key shows information on that item.
    ]                   Shows a restricted inventory, only containing
                        worn, wielded and quivered items.
    I                   Show list of memorised spells.
    %                   Show resistances and general character overview:
                        health, experience, money, gear, and
                        status, mutations, abilities (the latter three
                        more terse than with the command @, A, a). This
                        is a highly condensed conglomeration of
                        [, ", E, ^, @, A, a, $ on a single screen.
                        Pressing the key of a displayed item views it.

Item interaction (inventory):
    {                   Inscribe item (check the autoinscribe option).
                        An empty inscription or inscribing only space
                        will remove prior inscriptions. See Appendix 6.
                        You can also inscribe items when viewing them
                        by pressing their slot key in the inventory.
    f                   Fire quivered missile. If some monster is in
                        sight, either the last target or the nearest
                        monster will be automatically targeted.
                        Pressing f again shoots.
    F                   Directly choose an item and fire. Contrary to
                        fi this does not change the quiver.
    (, )                Cycle quiver to next/previous suitable missile.
    Q                   Quiver item from a menu.
    q                   Quaff a potion.
    e                   Eat food (tries floor first, inventory next).
                        In the eating prompt, e is synonymous to y.
    r                   Read a scroll or book.
    M                   Memorise a spell from a book.
    w                   Wield an item ( - for none).
    '                   Wield item a, or switch to b.
    v                   Evoke power of wielded item. Also used to attack
                        non-adjacent monsters with weapons of reaching.
    V                   Evoke an item from the inventory. This includes
                        using of wands.
    W                   Wear armour. Also allows to take off armour.
    T                   Take off armour.
    P                   Put on jewellery. Also allows to remove it.
    R                   Remove jewellery.

Item interaction (floor):
    d                   Drop an item.
                        Within the drop list, you can select slots based
                        on a regular expression by pressing Ctrl-F,
                        followed by the regex.
    #d                  Drop exact number of items, where # is a number.
    g or ,              Pick up items; press twice for pick up menu.
                        Use a prefix to pick up smaller quantities.
                        As with dropping, Ctrl-F allows you to pick up
                        items matching a regular expression.
    c                   Chop up a corpse. This will switch to an
                        uncursed edged weapon (unless you have claws or
                        wield such a weapon already), cut up a single
                        corpse on the ground and switch back to your
                        primary weapon. In case there are several
                        corpses on the ground, you are prompted one by
                        one. There, you can answer
                         y, c       yes (chop up this corpse)
                         n, Space   no (skip this corpse)
                         a          yes to all (chop up all corpses)
                         q, Esc     stop chopping altogether

Other game-playing commands:
    a                   Use special ability.
    p                   Pray (or renew an existing prayer).
    z                   Cast a spell. Should the spell demand monsters as
                        target but there are none within range, casting
                        will be stopped. In this case, neither turns nor
                        magic are used. If you want to cast the spell
                        nonetheless, use Z.
    Z                   Cast a spell, regardless of range limitations.
    I                   List spells.
    t                   Tell commands to allies, or shout (with tt).
    Ctrl-A              Toggle autopickup. Note that encounters with
                        invisible monsters always turns autopickup off.
                        You need to switch it on with Ctrl-A afterwards.
    Ctrl-T              Toggle your allies' pickup behaviour between three
                        settings: don't pick up anything, only pick up
                        items dropped by allies, pick up anything.
                        This toggle only works for some kind of characters
                        who can gain permanent, intelligent allies.
    `                   Re-do previous command
    0                   Repeat next command a given number of times

Non-game playing commands:
    ?                   The help menu.
    Ctrl-P              Show previous messages.
    Ctrl-R              Redraw screen.
    Ctrl-C              Clear main and level maps.
    #                   Dump character to file (name.txt).
    :                   Add note to dump file (see option take_notes).
    ?:                  Read the notes in-game.
    ?V                  Display version information.
    ?/                  Describe a monster, spell or feature. You can
                        enter a partial name or a regex instead of the
                        full name.
    ~ or Ctrl-D         Add or save macros and key mappings.
    =                   Reassign inventory/spell/abilities letters.
    _                   Read messages (when playing online; not for
                        local games).
    -                   Edit player doll (Tiles only).

Stashes:
    Ctrl-F              Find. This searches in stashes and shops, you
                        can use regular expressions and also terms like
                        'long blades', 'shop', 'altar', 'artefact'.
                        If you are looking for altars to a special god,
                        a search for 'Trog' , etc. works. If all items
                        are stashed (the default), then a string like
                        'D:13' will list all known items on that level.
                        'D:1}' will search for items on level 1 only,
                        as opposed to 'D:1', which will also list items
                        on D:10 through D:19.
                        Once the list of all found places is displayed,
                        you can cause auto-travel to go there (press the
                        associated letter) or you can examine the items
                        (press ? followed by the letter).
    Ctrl-E              Excludes a square from stash tracking.

Level map ('X')
---------------
The level map (brought up by 'X' in the main screen) uses the whole
screen to show the dungeon. The first line of that screen usually gives
the name of the level and a hint on the help screen. You can use the
level_map_title option to get rid of that.
    Esc, Space          Leave level map.
    ?                   Level map help.
    -                   Scroll level map up.
    +                   Scroll level map down.
    direction           Move cursor.
    Shift-direction     Move cursor in bigger steps (check the option
    or / direction      level_map_cursor_step).
    .                   Travel to cursor (also Enter, Del, ',' and ';').
                        If the cursor is on the character, move cursor
                        to last travel destination instead.
    <                   Cycle through up stairs.
    >                   Cycle through down stairs.
    ^                   Cycle through traps.
    _                   Cycle through altars.
    Tab                 Cycle through shops and portals.
    *                   Cycle forwards through stashes (if the option
                        stash_tracking is set to all, this cycles
                        through all items and piles).
    /                   Cycle backward through stashes.
    Ctrl-C              Clear level and main maps (from temporarily
                        seen monsters, clouds, etc.).
    Ctrl-F              Forget level map.

Waypoints can be set on the level map. You can travel to waypoints
using G. Check the option show_waypoints. The commands are
    Ctrl-W              Set waypoint.
    W                   Cycle through waypoints.

Travel exclusions mark certain spots of the map as no-go areas for
autotravel and explore.
    e                   Set travel exclusion. If an exclusion is already
                        present, change size (from single square to full
                        field of vision); after that, remove exclusion.
    Ctrl-E              Erase all travel exclusions at once.
    E                   Cycle through travel exclusions.

Examining surroundings ('x')
----------------------------
When roaming the dungeon, the surroundings mode is activated by 'x'.
It lets you have a look at items or monsters in line of sight. You may
also examine stashed items outside current view using the option
target_oos = true (if using this, check the option target_los_first).
    Esc, Space, x       Return to playing mode.
    ?                   Special help screen.
    * or '              Cycle objects forward.
    / or ;              Cycle objects backward.
    + or =              Cycle monsters forward.
    -                   Cycle monsters backward.
    direction           Move cursor.
    . or Enter          Travel to cursor (also Del).
    v                   Describe feature or monster under cursor.
                        Some branch entries have special information.
    >                   Cycle downstairs.
    <                   Cycle upstairs.
    _                   Cycle through altars.
    Tab                 Cycle shops and portals.

Targeting
---------
Targeting mode is similar to examining surroundings. It is activated
whenever you fire projectiles, evoke a wand or cast spells which use
targets. All of the commands described for examination of surroundings
work, with the exception of Space (which fires).
    Esc or x            Stop targeting.
    ?                   Special help screen.
    Enter               Fire at cursor direction (also Del and Space).
    .                   Fire at cursor position and stop there with
                        slightly reduced impact. This can be useful to
                        avoid damaging pets, or to avoid losing arrows.
    p                   Fire at previous target (if still in sight).
    f                   Smart-firing: fire at previous target, if it is
                        still in sight; and else fire at the cursor
                        position. Together with the default_target
                        option (which is on by default) this allows to
                        start shooting at an opponent with 'ff' and then
                        keep firing with 'ff'.
    :                   Toggle display of the beam path.
    Ctrl-F              Toggle target modes (between enemies, all,
                        friends; see also option target_zero_exp).
    (, )                These two commands allow you to change
                        ammunition while targeting. The choice is
                        subject to the fire_order option. Usually, you
                        change missiles according to your launcher; i.e.
                        when wielding a bow, ( and ) will cycle through
                        all stacks of arrows in your inventory.
    Shift-direction     Fire straight in that direction. You can go
                        back to the old targeting mode (allowing
                        straight firing by pressing just the direction
                        key) using the option target_unshifted_dirs.
                        Note that target_unshifted_dirs is mutually
                        exclusive with default_target.

Shortcuts in lists (like multidrop):
------------------------------------
When dropping (with the drop_mode = multi option), the drop menu accepts
several shortcuts. The same applies to the pickup menu. In the
following, if an item is already selected, the key will deselect it
(except for ',' and '-', obviously).
    (                   Select all missiles.
    )                   Select all hand weapons.
    [                   Select all armour.
    ?                   Select all scrolls.
    %                   Select all food.
    &                   Select all carrion and inedible food.
    + or :              Select all books.
    /                   Select all wands.
    \ or |              Select all staves.
    !                   Select all potions.
    =                   Select all rings.
    "                   Select all amulets.
    }                   Select all miscellaneous items.
    ,                   Global select (subject to drop_filter option).
    -                   Global deselect (subject to drop_filter option).
    *                   Invert selection. This will allow you to select
                        all items even if you use the drop_filter
                        option.
    .                   Selects next item. (If you have pressed the key
                        of an item in the list, '.' will toggle the next
                        item. This can be repeated, quickly selecting
                        several subsequent items).
Even with TabO alone Tiles player get a feeling of Console.
There is no mouse in crawl;
Hit ?? ingame!

For this message the author gofftc has received thanks: 2
danr, Napkin
User avatar

Vestibule Violator

Posts: 1533

Joined: Thursday, 16th December 2010, 20:52

Post Wednesday, 22nd December 2010, 22:45

Re: List of Keys and Commands

This gives me the idea to create an online version of the manual. Perhaps there is one somewhere already, but seriously, in the age of HTML, is there any reason we shouldn't have an online manual that is indexed and cross-referenced etc.?

I'd look at the manual a lot more if it wasn't just one long stream of text.
User avatar

Dungeon Master

Posts: 4031

Joined: Thursday, 16th December 2010, 20:37

Location: France

Post Wednesday, 22nd December 2010, 22:53

Re: List of Keys and Commands

Looks like there is:
http://crawl.develz.org/other/manual.html

Don't know why the link on the main page didn't point there though. I have fixed that.
<+Grunt> You dereference an invalid pointer! Ouch! That really hurt! The game dies...

For this message the author galehar has received thanks: 2
danr, Whelk
User avatar

Vestibule Violator

Posts: 1533

Joined: Thursday, 16th December 2010, 20:52

Post Wednesday, 22nd December 2010, 23:10

Re: List of Keys and Commands

Thanks.

I added it to my sticky topic in the general advice forum as well.

Server Admin

Posts: 89

Joined: Wednesday, 15th December 2010, 23:13

Location: Germany, Europe

Post Thursday, 23rd December 2010, 00:10

Re: List of Keys and Commands

galehar wrote:Don't know why the link on the main page didn't point there though.

I think that document was created for a release of Stone Soup. It's not automatically recreated and thus doesn't reflect the current state of the manual. That manual.html is from July 7th.

Do you remember who created it and how? I might be able to create a cron-job to keep it up to date.
Please report bugs to the bug tracker, and leave feedback on the development wiki. Thank you!
User avatar

Dungeon Master

Posts: 4031

Joined: Thursday, 16th December 2010, 20:37

Location: France

Post Thursday, 23rd December 2010, 07:44

Re: List of Keys and Commands

Napkin wrote:
galehar wrote:Don't know why the link on the main page didn't point there though.

I think that document was created for a release of Stone Soup. It's not automatically recreated and thus doesn't reflect the current state of the manual. That manual.html is from July 7th.

Do you remember who created it and how? I might be able to create a cron-job to keep it up to date.


I think b0rsuk did. I found the link on this page, which explains that the html and pdf versions are generated from a reST version (here).
<+Grunt> You dereference an invalid pointer! Ouch! That really hurt! The game dies...

Server Admin

Posts: 89

Joined: Wednesday, 15th December 2010, 23:13

Location: Germany, Europe

Post Thursday, 23rd December 2010, 11:41

Re: List of Keys and Commands

The manual.html will now be recreated every 1st and 15th of a month.
Please report bugs to the bug tracker, and leave feedback on the development wiki. Thank you!

For this message the author Napkin has received thanks: 4
evktalo, galehar, gofftc, tcjsavannah
User avatar

Vestibule Violator

Posts: 1533

Joined: Thursday, 16th December 2010, 20:52

Post Thursday, 23rd December 2010, 20:21

Re: List of Keys and Commands

Based on trunk?

Server Admin

Posts: 89

Joined: Wednesday, 15th December 2010, 23:13

Location: Germany, Europe

Post Thursday, 23rd December 2010, 21:28

Re: List of Keys and Commands

Based on the reference in dokuwiki. Sooner or later the deprecated documentation in git will probably also be moved to the dokuwiki.
Please report bugs to the bug tracker, and leave feedback on the development wiki. Thank you!

Spider Stomper

Posts: 245

Joined: Monday, 12th September 2016, 16:25

Post Tuesday, 22nd November 2016, 12:00

Re: List of Keys and Commands

galehar wrote:Looks like there is:
http://crawl.develz.org/other/manual.html


I appreciate this is a pretty heroic necro, but this is now a broken link and is still pointed to by https://crawl.develz.org/wordpress/documentation
Ascension reports with too many words since 2016.

For this message the author damerell has received thanks:
Speleothing

Return to Technical Support

Who is online

Users browsing this forum: No registered users and 3 guests

Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group.
Designed by ST Software for PTF.