readme-eng.md

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