Fix braces
[crawl.git] / crawl-ref / docs / tiles_help.txt
1
2 Note: If you are experiencing significant slowdown and lags with the Tiles
3 version of Dungeon Crawl Stone Soup, scroll down to the end of this file.
4
5
6 Tiles specific commands
7 -----------------------
8
9 There are several different ways to interact with your environment, both
10 by typing the command keys, and by using the mouse.
11
12 Of notable interest is the clickable tab area to the right of the screen
13 that allows easy access to e.g. inventory, spells, or common commands.
14
15 Depending on your screen resolution, one of more of these panels may be
16 open at any time, though you can temporarily exchange the inventory view
17 with another type of tiled panel by clicking on the tab icons.
18
19 You can customize the priority of the control panels by modifying the
20 tile_layout_priority option in init.txt in the settings directory.
21
22
23 Movement
24 --------
25
26 You can move by using the arrow keys, the vi-keys, or the number pad.
27 (For the latter try both Numlock on and off.)
28
29 Numpad:   7 8 9     vi-keys:   y k u
30            \|/                  \|/
31           4-.-6                h-.-l
32            /|\                  /|\
33           1 2 3                b j n
34
35
36 To run several steps into the same direction, press Shift along with these
37 keys.
38
39 You can also move by clicking somewhere on the map or minimap with your
40 mouse. If the square is reachable from your current position and there are
41 no hostile monsters in sight, you will automatically travel there. If there
42 are hostile monsters in sight, you will only take a single step at a time.
43
44 For automatic exploration, you can either type the 'o' command or you can
45 click on the corresponding tile in the command panel to the right of your
46 screen. Like mouseclick travel, these will refuse to work if there are
47 hostile monsters in sight.
48
49
50 Getting information
51 -------------------
52
53 Doing a right-click with your mouse on any feature, monster or item on the
54 main map or in the tiled control panels will display the description of
55 said feature, monster or item on a separate screen.
56
57 A simple mouseover will usually display the same description, or as much of
58 it as can fit, in the message area.
59
60 Similarly, letting your mouse rest for a while on a feature, monster or
61 item will usually display a "tool tip" of applicable commands.
62
63
64 Attacking monsters
65 ------------------
66
67 You can attack a monster in melee by moving into it with the movement keys
68 or by clicking on it with your mouse.
69
70 For ranged attacks (including spells and wands), mouse over the monsters
71 and wait for the tool tip to appear. Alternatively, you can cast spells by
72 clicking on the spell tiles in the spell panel, or fire ammunition or
73 evoke wands by clicking on them in the inventory panel.
74
75 In the command panel, you'll also find a tile described as "Autofight",
76 which, if clicked, will attack an adjacent monster in melee, or if there is
77 no adjacent monster, take one step in the direction of the closest monster.
78
79
80 Item usage
81 ----------
82
83 The easiest way to use items is by clicking on them in the inventory panel.
84 The mouseover tool tip will tell you what a mouseclick will do, and also
85 the corresponding command key to execute the same action.
86 As an alternative, you can also use an item by selecting it in the inventory
87 ('i' command) and then pressing the appropriate key in the action prompt.
88
89 To pick up items on the ground, you can either click on them one by one in
90 the floor section of the inventory panel, or you can click on the player
91 tile and pull up a menu of selectable items instead. In the latter case,
92 'Enter' will confirm your selection and start pick up.
93
94 Dropping items works similarly, either by clicking on single items in the
95 inventory panel, or by typing the 'd' command and then selecting items
96 from a menu.
97
98
99 Interacting with the dungeon
100 ----------------------------
101
102 Again, doing a mouseover on features (such as staircases or doors) in the
103 main map will tell you how to interact with them.
104
105
106 Character status
107 ----------------
108
109 Doing a right-click on the player tile will display a character overview
110 screen listing equipment, resistances and stats.
111
112 More detailed screens on specific aspects of your characters can be
113 accessed by clicking on the corresponding tiles in the command panel.
114
115
116
117 If you are experiencing significant slowdown and lags...
118 --------------------------------------------------------
119
120 Crawl renders its graphics using OpenGL and SDL. However, it needs hardware
121 acceleration to not run slowly. If you are on Windows, make sure to update
122 your graphics card driver. If you are on Linux, be sure that you are using
123 DRI.
124
125 It has been tested successfully with cards as old as the i865. Unfortunately,
126 it has been known to be slow on the i810 and there is little to be done in
127 that case but to run the console version instead or switch to a different
128 machine.
129
130 You can try tweaking a number of options in init.txt in the settings
131 directory to see whether performance improves:
132
133 travel_delay = -1
134     This setting suppresses redrawing until travelling is finished or
135     interrupted.
136
137 tile_update_rate = 1000
138     By default, the screen gets redrawn at least every 1000 milliseconds,
139     more often if you take actions that change the display. You could try
140     cranking up this value, though this may lead to updating taking too long.
141
142 tile_runrest_rate = 100
143     While running and resting the screen is redraw every 100 milliseconds.
144     If Crawl is slow while running or resting, increase this number.
145
146 tile_tooltip_ms = 0
147     Deactivating the tooltips means there's less stuff to draw every time.
148
149 clear_map = false
150     Not having to redraw remembered monsters outside your line of sight
151     takes some load off the redrawing routines.
152
153 tile_window_width   = 1024
154 tile_window_height  = 768
155     The larger the map area the more cells there are to redraw each turn.
156     If you've got a large display showing way more than the necessary 17x17
157     grids of the map, you could try specifying a lower resolution.