summaryrefslogtreecommitdiffstats
path: root/crawl-ref/source/util/docs/key_changes.tex
blob: be547363bfb6dc788c443a011ff5f1b6556582fe (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
\documentclass[a4paper,10pt]{article}

\usepackage{palatino}
\usepackage{mathpazo}           % optional [sc] fuer real small caps
\usepackage[left=3cm,top=3cm,right=3cm,bottom=2cm,nohead,nofoot]{geometry}

\usepackage{graphicx}

\newcommand{\key}[1]{{\texttt{#1}}} % this does nasty things to underscores
\newcommand{\sex}[1]{{{\textbf{#1}}}} % \sec already defined

\newcommand{\crawl}{\textsc{Crawl}}
\newcommand{\dungeon}{\textsc{Dungeon}}

\newcommand{\spacecolumn}{\begin{minipage}[t]{2cm}\phantom{xxxx}\end{minipage}}
\newcommand{\para}{\vspace{1.5ex}}
\setlength{\parindent}{0em}

\newcommand{\mc}[1]{\multicolumn{2}{l}{#1}}

\newcounter{abccounter}
\newenvironment{abcliste}{\begin{list}{(\alph{abccounter})}
                      {\usecounter{abccounter}
                       \setlength{\topsep}{0ex}
                       \setlength{\partopsep}{0ex}
                       \setlength{\listparindent}{0ex}
                       \setlength{\itemsep}{0ex}
                       \setlength{\parsep}{0ex}
                       \setlength{\leftmargin}{2em}
                       \setlength{\labelwidth}{2em}
                       \setlength{\parskip}{0ex}
                      }
                      }{\end{list}}

\pagestyle{empty}

\begin{document}

\begin{center}\textbf{\LARGE
\dungeon\ \crawl: Important interface changes
}\end{center}

\subsection*{Command key changes introduced in 0.5}

There have been some command key changes in 0.5. There is no macrofile this time; you may have to resort to macros on your own. 
(This is probably only needed to interchange the \key{Z} and \key{V} commands if you refuse to learn that wands are nowadays
activated with \key{V}.)

\begin{center}
\begin{tabular}{ll}
key          & new command \\ \hline
\key{V}      & evokes items in inventory like \textbf{wands} (was \key{Z}) \\
\key{Z}      & cast a spell even if no monster is within range \\
\key{z}      & cast a spell (as before) but abort if no monster is within range \\
\key{Ctrl-X} & lists monsters, items and features in sight \\
\key{Ctrl-S} & saves game without prompt (was \key{Ctrl-X}) \\
\\
\multicolumn{2}{l}{On the level map (\key{X}):} \\
\key{e}      & set/remove travel exclusion (was \key{Ctrl-X}) \\
\key{E}      & cycle travel exclusions (was \key{x})
\end{tabular}
\end{center}

\newpage

\subsection*{Command key changes introduced in 0.4}

In DCSS 0.4, for better ergonomics, many key bindings were changed. Also,
a small number of new commands were introduced. The tables below list all 
of these. If you have been playing an older version and want to restore 
the old key set, do so by adding this line to the 
\texttt{init.txt} file: \\
\verb$additional_macro_file = 034_command_keys.txt$ 

\para

The command for examining items (was \key{v}) is gone. Bring up the
inventory and press the key matching an item's slot in order to examine it.

When chopping up a single corpse on the ground, there is no longer any
prompt. You will only be prompted if there are two or more corpses. When
answering this prompt, you can use the following shortcuts: \key{c} means 
yes, so you can press \key{cccc}\dots to chop up all corpses in one place,
or you can just hit \key{a} to butcher of corpses on a square.

The \key{* Direction} and \key{Ctrl-Direction} keys now both open and close
doors.

\para\para

\begin{center}
\begin{tabular}{lll}
key          & new command \\ \hline
\key{\_}     & \mc{read message (only used for online play)} \\
\key{!}      & \mc{annotate level (read annotations with \key{Ctrl-O};} \\
             & \mc{annotations with an ! prompt when entering the level)} \\
\key{(}      & \mc{cycle ammunition} \\
\key{Q}      & \mc{quiver item}      \\
\key{`}      & \mc{redo previous command} \\
\key{0}      & \mc{repeat next command} \\
\key{V}      & \mc{verbose list of monsters in sight} \\
\key{Ctrl-T} & \mc{toggle ally pickup mode (only for permanent allies)} \\
\key{Ctrl-D} & \mc{add macro (a new synonym for \key{$\sim$})} \\
\\
\\
new key      & command          & old key \\ \hline
\key{z}      & cast spell       & was \key{Z}      \\
\key{Z}      & zap wand         & was \key{z}      \\
\key{o}      & auto-explore     & was \key{Ctrl-O} \\
\key{Ctrl-O} & dungeon overview\phantom{xxx} & was \key{O}      \\
\key{O}      & open door        & was \key{o}      \\
\key{C}      & close door       & was \key{c}      \\
\key{c}      & chop up          & was \key{D}, dissect \\
\key{E}      & show experience  & was \key{C}      \\
\key{v}      & evoke            & was \key{E}      \\
\key{F}      & manually throw   & was \key{t}      \\
\key{t}      & tell/yell        & was \key{!}      \\
\key{Ctrl-V} & Tiles settings   & was \key{Ctrl-Q} \\
\key{Ctrl-Q} & quit             & was \key{Q}
\end{tabular}
\end{center}

There are additional changes to the targeting interface: \\
The functions of \key{!} and \key{.} have been swapped. So firing with
\key{.} will now stop at the target, whereas \key{!} will shoot further
if the target was missed (and \key{Enter}, \key{Del}, \key{Space} still
behave as in 0.3.4). \\
You can now target using the monster list as well; \key{Ctrl-L} toggles
this option.\\
You may quiver an item, meaning that you will preferably fire this
ammunition (and keep doing so even if you run out of it temporarily). 
Quivering is done via \key{Q} (quiver the currently fired item) or 
\key{fi} (choose an item and quiver it) or also by using \key{(} (cycling 
appropriate ammunition) and then firing. \key{F} also lets you select an 
item to be thrown, but this command does not affect the quiver.

\newpage

\subsection*{Other interface changes introduced in 0.4}

The colours of many monsters have been changed. Most notably, there are
no darkgrey monsters anymore. In case darkgrey is actually better visible 
than blue on your system, you can swap these colours using the line \\
\verb#   colour.blue = darkgrey #\\
in \key{init.txt}. Apart from that, more dangerous monsters are now 
generally displayed in lighter colours.

\para

We are content that all of these changes are genuine improvements. Should
your brain be hardwired to the old settings, you can effectively enforce
the 0.3.4 state by using the following options:
\begin{verbatim}
   include                 = 034_monster_glyphs.txt
   additional_macro_file   = 034_command_keys.txt
   always_confirm_butcher  = true
\end{verbatim}

Note that the header of \key{init.txt} contains these lines. (It contains 
some more options for using other old settings.) The options are commented 
out, so you just need to remove the \key{\#} in front in order to activate 
them. You can choose to use only part of these options. In case you decide 
to use the old keyset, be aware that \key{D} and \key{d} are synonyms for 
'yes' in the butcher interface.

\end{document}