OSDN Git Service

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