OSDN Git Service

Merge pull request #1191 from hengband/feature/3.0.0Alpha26
[hengbandforosx/hengbandosx.git] / readme-eng.md
1 # Introduction
2
3 * [日本語](/readme.md)
4
5 This readme is very old, so I will update it later.
6
7 # How to install
8
9 ##  UNIX
10
11 Download source archive and try...
12
13 ```
14 tar -zxvf hengband-x.x.x.tar.gz
15 cd hengband-x.x.x
16 ./configure --disable-japanese
17 make install
18 ```
19
20 Substitute the version number to x.x.x.
21 You need --disable-japanese option of the configure for English version.
22 If you are a super user, --with-setgid=games option works.
23 then try
24
25 ```
26 ./hengband -- -n<number of windows>  ## for normal ASCII graphics
27 ```
28
29   or
30
31 ```
32 ./hengband -g -- -n<# of windows>    ## for 8x8 tile graphics
33 ./hengband -g -- -b -n<# of windows> ## for Bigtile graphics
34 ./hengband -g -- -a -n<# of windows> ## for 16x16 tile (need heng_graf.tar.gz)
35 ```
36
37   to play.
38
39 You can change game windows' font, location, and size, by environment 
40 variables.
41
42 Ex.
43
44 ```
45 setenv ANGBAND_X11_FONT '-*-*-medium-r-normal--24-*-*-*-*-*-iso8859-1'
46 hengband -- -n
47 ```
48
49 Then font size will be changed.
50
51 You can set ANGBAND_X11_FONT_n for specific window which have window number n.
52
53 Location of windows are ANGBAND_X11_AT_X_n, and ANGBAND_X11_AT_Y_n.
54 Size of windows are ANGBAND_X11_COLS_n, and ANGBAND_X11_ROWS_n.
55
56
57 ## Windows
58
59 Download the binary archive for Windows.
60 Unzip it, and click hengband to play.
61
62 The makefile.bcc was changed again.
63 If you want to compile from the source with borland compiler (BCC),
64 Comment out options for japanese; 'JP_OPT = ...' and 'ANGBAND_RC = ...' 
65 in makefile.bcc, and un-comment the line 'ANGBAND_RC = ang_eng.rc'.
66
67
68 # Basic for Playing
69
70  We recommend that you go to the Yeek cave next to your starting position 
71 in the town of Outpost.  Although the King of Yeeks at the lowest level is a 
72 fierce enemy, the rest of the cave should be fairly safe.  Once you complete 
73 this dungeon, you will be strong enough to leave Outpost in search of greater 
74 adventures.  Carry lots of food and fuel, for the journey can be a long one.  
75 Since this world is very large, it is convenient to go into global map mode by 
76 pressing the '<' key, and then return to local map mode by '>' key when you are 
77 at the destination.  When in the wilderness, stay in safe grids such as roads 
78 or plains; seas and lava fields are best avoided for a while.
79         Many towns and dungeons await you; good ones to explore early on include 
80 the orc caves and the Labyrinth.  To the northeast of the town of Morivant, 
81 near the center of the map, is the dread dungeon of Angband.  It is home to the 
82 Serpent of Chaos, whom you must kill in order to win the game.
83
84
85 ## Commands
86
87  Please read on-line help (Press the ? key in the game) for full
88 information of the game.  Here are only descriptions of basic commands.
89
90  The following section lists most commands, and the less frequently used 
91 ones may be accessed by pressing the return key, or (if using the original 
92 keyset) the 'x' key, to bring up the command menu.  Almost any command may be 
93 chosen from the main menu.  "(R) Rest" can be performed by pushing 'R' (in 
94 uppercase).  "Look around (l/x)" can be performed by pushing 'l' in the Original 
95 keyset, and by pushing 'x' in the Rogue-like keyset.
96
97 * [Movement]
98
99 >     Original Keyset Directions
100 >
101 >              7  8  9
102 >              4     6
103 >              1  2  3
104 >
105 >     Roguelike Keyset Directions
106 >
107 >              y  k  u
108 >              h     l
109 >              b  j  n
110
111    *  5/, Stay still
112    *  <   Go up staircase or Enter global map mode in the wilderness.
113    *  \>   Go down staircase or return from global map mode in the wilderness
114    *  Shift+direction   run
115    *  Ctrl+direction   attack, open, close, or dig
116 * [Tools]
117    * r  Read a scroll
118    * q  Quaff a potion 
119    * u/Z  Use a staff
120    * a/z  Aim a wand
121    * z/a  Zap a rod
122    * E  Eat some food
123    * A  Activate an equipment
124    * F  Fuel your lantern/torch
125    * f/t  Fire a missile
126 * [Action]
127    * d  Drop an item
128    * g  Pick up items
129    * R  Rest for a period
130    * o  Open a door or chest
131    * s  Search for traps/doors
132    * k/Ctrl+d  Destroy an item
133 * [Magic]
134    * m  Cast a spell / use mental power
135    * G  Gain new spells/prayers
136    * U/O  Use bonus power
137    * b/P  Examine spells (choose each spell to get a description)
138 * [Equipment] 
139    * w  Wear/wield equipment
140    * t  Take off equipment
141    * F  Fuel your lantern/torch
142 * [Info] 
143    * x  Examine items in a store
144    * C  Character description
145    * I  Examine an *identified* item
146    * i  Inventory list
147    * l/x  Look around
148    * M  Full dungeon map
149    * ~  Display various information
150 *  [Other]
151    * p  Command pets
152    * =  Set options
153    * $  Reload auto-picker preference file
154    * _  Edit auto-picker preference
155    * n/[  Repeat previous command
156    * @  Interact with macros
157 *  [Help]
158    * ?  View the on-line help (Press a-z to choose a section,  space key to go next page.)
159
160
161 ## Inscriptions
162
163 Below, only the new features in Hengband are explained.
164
165 * You can inscribe on objects with "@ma" or '@'+<any command letter>+<any tag>. Then, type these alphabet letter in 'm' command to cast from the spellbook.
166 * The inscriptions "@1" or '@'+<any tag number> make the objects able to be used by pressing <tag number> key in any command.  Any alphabet key cannot be used as a tag in this form.
167 * You can inscribe on *identified* items with "%" or "%all". Then, "%" or "%all" is automatically replaced by strings which describe the item's abilities. 
168 ** Example:  You inscribe with "%all" on a pair of gauntlets of power which provide resistance to fire. The description will look like {St;Fi} which means bonus to Strength and resistance to fire. If you inscribe it with "%", its description will look like {Fi} which means its random added ability is resistance to fire.
169
170 ## Auto pickup/destroy
171
172 Hengband offers two different methods of auto-pickup/destroy.
173
174 ### Powerful method
175 * Hengband offers a very powerful auto-pickup/auto-destroy system which you may customize.  Press   *  '_' key to enter edit mode.  Please read the file "autopick_eng.txt" about the syntax.
176
177 ### Easy method
178 * Since the powerful method is slightly difficult to use effectively, there is another very easy option. you can turn on 
179 * the destroy_items option and/or the always_pickup option to use this method.  These options are located in (6) Easy Auto-Destroyer Options and (1) Input Options in the Set options ('=') command.
180
181 ## Tile graphics, Big tile, and Big screen
182
183 ### Tile graphics
184
185   To use graphics mode, choose it from menu for Windows and Mac, or
186   use -g option for Linux.  There are 8x8 size old tile and 16x16 size
187   Adam bolt tile, and you can change from menu for Windows and Mac, or
188   use -- -a option to use 16x16 tile for Linux.  Since source archive
189   doesn't include 16x16 size tile, you need to download the
190   heng_graf.tar.gz.
191
192 ### Big tile (Double-width tile)
193
194   In the Big tile mode, graphic tile have double width, and become
195   square.  You can choose Bigtile from menu for Windows and Mac, or
196   use -- -b option for Linux.
197
198 ### Big screen
199
200   You can resize each window using mouse, which allow you to have
201   terminal windows larger than 80x24.  On linux, it's convenience to
202   use environment variables: ANGBAND_X11_COLS_0 and
203   ANGBAND_X11_ROWS_0.
204
205 ## Play Record
206
207 Play record will be written to a file named 'playrec-<character's name>.txt' 
208 in the same directory as your user preference file.  It is in ~/.angband/
209 Hengband/ for UNIX, or hengband/lib/user/ for other OS.
210 '|' command displays play record in the game.
211
212 ## World score
213
214 When You die, or retire, you can register a score to the world 
215 score sever through the Internet. 
216 However, please do not register a score, if you have cheated 
217 by modifying data or source files, or by restoring from a backed 
218 up savefile.
219
220 The score server is here:
221   http://hengband.sourceforge.jp/en/score.html
222