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