Ticket #1544: general.txt

File general.txt, 17.8 KB (added by PowerWyrm, 8 years ago)

Fixed one typo.

Line 
1===================
2General information
3===================
4
5Using the Online Help
6=====================
7
8You can press Escape (``ESC``) at any time to leave the online help.
9
10You can press Space to advance one page, Plus (``+``) to advance one half
11page, or Return to advance one line. If you reach the end, you will jump
12back to the start. You can press Minus (``-``) to back up one half page,
13Underscore (``_``) to back up one page, or Equal (``=``) to back up one
14line. If you reach the start, you will stay there. Advancing by one page is
15the most efficient method.
16
17You can press Hash (``#``) [or Percent (``%``)] to go to a specific line
18[or file].
19
20You can press Slash (``/``) [or Ampersand (``&``)] to search for [or
21highlight] a string. This is case-insensitive by default, but Pling (``!``)
22toggles it to case-sensitive. Use ``#``, ``0``, ``Return``, ``/``, Return
23to restart a search from the top of the file.
24
25Please press Space to view the rest of this file...
26
27General Information
28===================
29
30Angband is basically a complex single player dungeon simulation. A player
31creates a character, choosing from a variety of races and classes, and then
32plays that character over a period of days, weeks, even months.
33
34The player will begin his adventure on the town level where he may acquire
35supplies, weapons, armor, and magical devices by buying from various shop
36owners. Then the player can descend into the Pits of Angband, where he will
37explore the many levels of the dungeon, gaining experience by killing
38fierce creatures, collecting powerful objects and valuable treasure, and
39returning to town occasionally to buy and sell supplies. Eventually, as the
40player grows more experienced, he may attempt to win the game by defeating
41Morgoth, the Lord of Darkness, who resides far below the surface.
42
43Note that Angband is a very complex game, and it may be difficult to grasp
44everything at first, especially if you have never played a "roguelike" game
45before. You should probably browse through all of the "online help files",
46especially this one, before beginning any serious adventuring...
47
48About the game
49==============
50
51Angband has been maintained by a succession of volunteers since it was
52written in the early 1990s. The current maintainer is Andi Sidwell.
53
54Angband will run on a wide variety of systems (including Unix, Macintosh,
55Windows). It is written in C, and the source code is freely available.
56Creating a version for a new platform involves writing as few as 100 lines
57of code and recompiling.
58
59See the Official Angband Home Page at http://rephial.org/ for up to date
60information about the latest version of Angband, including a complete list
61of recent modifications and a wiki about the game which includes a full
62user guide.
63
64You can post compliments, complaints, suggestions, bug reports, and patches
65at http://angband.oook.cz, or to the newsgroup
66'rec.games.roguelike.angband'. You can also post interesting experiences
67and ask for help.
68
69This version of Angband is under the GNU General Public Licence (GPL)
70version 2. A copy of this licence is included with the game, in the file
71copying.txt.
72
73If you're interested in the development of the game, the public bug tracker
74and development road map are at http://trac.rephial.org.
75
76The basic help files supplied with this game are more or less up to date,
77but when in doubt, you should ask the newsgroup or the forum for
78confirmation.
79
80Note that spoiler files are not distributed with the source since they may
81spoil the game for new players (hence their name). If you want to use them,
82you can obtain them from various places as with the source and executables.
83Spoiler files may be placed into the "lib/info" directory, or into a user
84specified external directory, to allow access via the "online help" system.
85
86Remember to tell all your friends about how much you like Angband...
87
88A quick demonstration
89=====================
90
91Angband is, as mentioned above, a very complex game, so you may want to try
92the following quick demonstration. The following instructions are for
93demonstration purposes only, and so they are intentionally boring.
94
95For this demo, we will assume that you have never played Angband before,
96that you have not requested any special "sub-windows", that you have not
97requested any special "graphics" modes, that you have a "numeric keypad" on
98your computer, and that you are using the default options, including, in
99particular, the "original" command set. If any of these assumptions are
100incorrect, you will need to keep in mind that this demo may not work. There
101are many ways to view this file while playing, in particular, you should be
102able to view it using the "online help" built into the game.
103
104Any time you see the ``-more-`` prompt, read the message and press space.
105This takes precedence over any other instructions. At any other prompt, for
106example, if you accidentally hit a key, you can normally "cancel" the
107action in progress by pressing escape.
108
109When the game starts up, depending on what platform you are using, you may
110be taken directly to the character creation screen, or you may have to ask
111to create a new character by using the File menu. In either case, you will
112be shown the character information screen, and you will be given a series
113of choices. For this demo, press ``a`` four times to elect a "female human
114warrior" character with the point-based stat allocation system. You will
115now be presented with a description of your character. Look over the
116description briefly, there is a lot of information here, and most of it
117will not make any sense. Press enter three times and your character will be
118placed into the "town".
119
120You should now be looking at the basic dungeon interaction screen. To the
121left is some information about your character. To the right is an overhead
122view of the town. Nothing happens in Angband while the game is waiting for
123you to specify a command, so take a good look at the town. You will see a
124variety of symbols on the screen. Each symbol normally represents a terrain
125feature, an object, or a monster. The ``@`` symbol is special, it
126represents your character. You can use the ``/`` command to find out what a
127given symbol represents. Press "/" then ``@`` now to verify the meaning of
128the ``@`` symbol.
129
130The solid blocks (which may be ``#`` symbols on some systems) around the
131edge of the town represent the walls that surround the the town. You cannot
132leave the town above ground, although some games derived from Angband
133(called "variants") have an overground element.
134
135The large rectangles represent stores. The "numeric" symbols represent an
136"entrance" to a store. The ``.`` symbols represent the "floor". It is
137currently daytime, so most of the town should consist of stores and
138illuminated floor grids.
139
140Any "alphabetic" symbols always represent monsters, where the word
141"monsters" specifies a wide variety of entities, including people, animals,
142plants, etc. Only a few "races" of monsters normally appear in town, and
143most of them are harmless (avoid any mercenaries or veterans if you see
144them). The most common "monsters" in town are small animals (cats and dogs)
145and townspeople (merchants, mercenaries, miscreants, etc).
146
147Now use the ``l`` command to "look" around. This will cause the cursor to
148be moved onto each "interesting" square, one at a time, giving you a
149description of that square. The cursor always starts on the square
150containing your character. In this case, you will see a message telling you
151that your character is standing on a staircase. Keep pressing space until
152the prompt goes away.
153
154Now press ``i``, to display your character's "inventory". New characters
155tart out with some objects to help them survive (though there is an option
156to start with more money instead). Your character will have some food, a
157potion, some torches, and a scroll. Press ``e`` to see what you are
158wearing. You will find you are wearing armour on your body, wielding a
159broad sword and lighting the way with a torch. You have many other
160equipment slots but they are all currently empty.
161
162Press ``t`` to take something off. Note that the equipment listing is
163reduced to those objects which can actually be taken off. Press ``g`` to
164take off the armour, and then press ``e`` again. Note that the armour is no
165longer shown in the equipment. Press escape. Press ``w`` to wield something
166and observe that the inventory listing is reduced to those objects which
167can actually be wielded or worn, press ``e`` to put the armour back on.
168
169Monsters can only move after you use a command which takes "energy" from
170your character. So far, you have used the ``w`` and ``t`` commands, which
171take energy, and the ``e``, ``i``, ``l``, and ``/`` commands, which are
172"free" commands, and so do not take any energy. In general, the only
173commands which take energy are the ones which require your character to
174perform ome action in the world of the game, such as moving around,
175attacking monsters, and interacting with objects.
176
177If there were any monsters near your character while you were experimenting
178with the ``w`` and ``t`` commands, you may have seen them "move" or even
179"attack" your character. Although unlikely, it is even possible that your
180character has already been killed. This is the only way to lose the game.
181So if you have already lost, simply exit the game and restart this demo.
182
183One of the most important things that your character can do is move around.
184Use the numeric keys on the keypad to make your character move around. The
185``4``, ``6``, ``8``, and ``2`` keys move your character west, east, north,
186and south, and the ``7``, ``9``, ``1`` and ``3`` keys move your character
187diagonally. When your character first moves, observe the ``>`` symbol that
188is left behind. This is the "staircase" that she was standing on earlier in
189the demo - it is the entrance to the dungeon.
190
191Attempting to stay away from monsters, try and move your character towards
192the entrance to the "general store", which is represented as a ``1`` on the
193screen. As your character moves around, use the ``l`` command to look
194around. You can press escape at any time to cancel the looking. If you die,
195start over.
196
197One of the hardest things for people to get used to, when playing games of
198this nature for the first time, is that the character is not the same as
199the player. The player presses keys, and looks at a computer screen, while
200the character performs complex actions, and interacts with a virtual world.
201The player decides what the character should do, and tells her to do it,
202and the character then performs the actions. These actions may induce some
203changes in the virtual world. Some of these changes may be apparent to the
204character, and information about the changes is then made available to the
205player by a variety of methods, including messages, character state
206changes, or visual changes to the screen. Some changes may only be apparent
207to the player.
208
209There are also a whole set of things that the player can do that can not
210even be described in the virtual world inhabited by the character, such as
211resize windows, read online help files, modify colormaps, or change
212options. Some of these things may even affect the character in abstract
213ways, for example, the player can request that from now on all monsters
214know exactly where the character is at all times. Likewise, there are some
215things that the character does on a regular basis that the player may not
216even consider, such as digesting food, or searching for traps while walking
217down a hallway.
218
219To make matters worse, as you get used to the difference between the player
220and the character, it becomes so "obvious" that you start to ignore it. At
221that point, you find yourself merging the player and the character in your
222mind, and you find yourself saying things like "So yesterday, I was at my
223friend's house, and I stayed up late playing Angband, and I was attacked by
224some wild dogs, and I got killed by a demon, but I made it to the high
225score list", in which the pronoun changes back and forth from the real
226world to the virtual one several times in the same sentence. So, from this
227point on you may have to separate the player and the character for
228yourself.
229
230So anyway, keep walking towards the entrance to the general store until you
231actually walk into it. At this point, the screen should change to the store
232interaction screen. You will see the name of the shop-keeper, and the name
233of the shop, and a list of objects which are available. If there are more
234than twelve different objects, you can use the space or arrow keys to
235scroll the list of objects. The general store is the only tore with a fixed
236inventory, although the amount of various items may vary. One of the items
237sold here are flasks of oil. Press ``down`` to highlight the line with
238flasks of oil and press the ``p`` key to purchase some. If you are asked
239how many you want, just hit enter. Any time you are asked a question and
240there is already something under the cursor, pressing return will accept
241that choice. Hit enter to accept the price. Many commands work inside the
242store, for example, use the ``i`` command to ee your inventory, with the
243new flask of oil. Note that your inventory is always kept sorted in a
244semi-logical order, so the indexes of some of the objects may change as
245your inventory changes.
246
247Purchase a few more flasks of oil, if possible: this time, when asked how
248many you want, press ``3`` then return to buy three flasks at once. Flasks
249of oil are very important for low level characters, because not only can
250they be used to fuel a lantern (when you find one), but also they can be
251ignited and thrown at monsters from a distance. So it is often a good idea
252to have a few extra flasks of oil. Press escape to leave the store. If you
253want, take time to visit the rest of the stores. One of the buildings,
254marked with an ``8``, is your "home", and is not a real store. You can drop
255things off at home and they will stay there until you return to pick them
256up. The interface is exactly the same as a store, but there is no payment.
257
258Now move to the staircase, represented by the ``>`` symbol, and press
259``>``, to go down the stairs. At this point, you are in the dungeon. Use
260the ``l`` command to look around. Note that you are standing on a staircase
261leading back to town. Use the ``<`` command to take the stairs back to
262town. You may find that any townspeople that were here before have
263disappeared and new ones have appeared instead. Now use the ``>`` command
264to go back down the stairs into the dungeon. You are now in a different
265part of the dungeon than you were in before. The dungeon is so huge, once
266you leave one part of the dungeon, you will never find it again.
267
268Now look at the screen. Your character may be in a lit room, represented as a
269large rectangle of illuminated floor grids (``.``), surrounded by walls. If
270you are not in a lit room, keep going back up to the town and back down
271into the dungeon until you are. Now look around. You may see some closed
272doors (``+``) or some open doors (``'``) or some open exits (``.``) in the
273walls which surround the room. If you do not, keep playing the stairway
274game until you are in such a room. This will keep the demo simple.
275
276Now look around using the ``l`` command. You may see some monsters and/or
277some objects in the room with you. You may see some stairs up (``<``) or
278some stairs down (``>``). If you see any monsters, move up next to the
279monster, using the movement keys, and then try and move into the monster.
280This will cause you to attack the monster. Keep moving into the monster
281until you kill the monster, or it runs away, or you die. If you die, start
282a new game. If the monster runs away, ignore it, or chase it, but do not
283leave the room. Once all the monsters in the room are dead or gone, walk on
284top of any objects in the room. Press ``g`` to get the object, and it will
285be added to your inventory. If there are any closed doors (``+``) in the
286room walk up next to them and press ``o`` and then the direction key which
287would move you into the door, which should attempt to "open" the door.
288
289Now use the movement keys to explore the dungeon. As you leave the room,
290you will probably notice that your character cannot see nearly as far as
291she could in the room. Also, you will notice that as she moves around, the
292screen keeps displaying some of the grids that your character has seen.
293Think of this as a kind of "map" superimposed on the world itself, the
294player can see the entire map, but the character can only see those parts
295of the world which are actually nearby. If the character gets near the edge
296of the "map" portion of the screen the entire map will scroll to show a new
297portion of the world. Only about ten percent of the dungeon level can be
298seen by the player at one time, but you can use the ``L`` command to look
299at other pieces of the map. Use the ``.`` key, then a direction, to "run"
300through the dungeon. Use the ``R`` key, then return, to force your
301character to "rest" until she has recovered from any damage she incurs
302while attacking monsters. Use the ``M`` key to see the entire dungeon level
303at once, and hit escape when done. If your food rations are still at index
304``a`` in your inventory, press ``E``, ``a`` to eat some food. If your oil
305is still at index ``b`` in your inventory, and there is a monster nearby,
306press ``v``, ``b``, ``'`` to throw a flask of oil at the nearest monster.
307To drop an item from your inventory, press ``d`` plus the index of that
308item. You can use the ``^X`` key to quit and save the game.
309
310You now know enough to play a quick game of Angband. There is a lot more
311for you to learn, including how to interpret information about your
312character, how to create different kinds of characters, how to determine
313which equipment to wield/wear, how to use various kinds of objects, and how
314to use the more than fifty different commands available to your character.
315The best resource for learning these things is the online help, which
316include, among other things, a complete list of all commands available to
317you, and a list of all the symbols which you may encounter in the dungeon,
318and information about creating new characters.
319