----- How to install -----

--- UNIX
  Download source archive and try...

  tar -zxvf hengband-x.x.x.tar.gz
  cd hengband-x.x.x
  ./configure --disable-japanese
  make install

  Substitute the version number to x.x.x.
  You need --disable-japanese option of the configure for English version.
  If you are a super user, --with-setgid=games option works.

  then try
  ./hengband -- -n<number of windows>  ## for normal ASCII graphics
  or
  ./hengband -g -- -n<# of windows>    ## for 8x8 tile graphics 
  ./hengband -g -- -b -n<# of windows> ## for Bigtile graphics
  ./hengband -g -- -a -n<# of windows> ## for 16x16 tile (need heng_graf.tar.gz)
  to play.

You can change game windows' font, location, and size, by environment 
variables.

Ex.
setenv ANGBAND_X11_FONT '-*-*-medium-r-normal--24-*-*-*-*-*-iso8859-1'
hengband -- -n

Then font size will be changed.

You can set ANGBAND_X11_FONT_n for specific window which have window number n.

Location of windows are ANGBAND_X11_AT_X_n, and ANGBAND_X11_AT_Y_n.
Size of windows are ANGBAND_X11_COLS_n, and ANGBAND_X11_ROWS_n.


--- Windows

Download the binary archive for Windows.
Unzip it, and click hengband to play.

The makefile.bcc was changed again.
If you want to compile from the source with borland compiler (BCC),
Comment out options for japanese; 'JP_OPT = ...' and 'ANGBAND_RC = ...' 
in makefile.bcc, and un-comment the line 'ANGBAND_RC = ang_eng.rc'.


--- MS-DOS

Use the makefile.ibm or the makefile.dos.
Comment out options for japanese version; 'JP_OPT = ...' in makefile.ibm 
or makefile.dos before MAKE with these.


--- Macintosh

Download the dmg file for Macintosh, double click on it to open the disk
image, and then drag the hengband application inside it to where you want
to store it.  Double clicking on the application will run it.  Since the
application has not been signed, you'll likely have to make an exception
for it to use the application.  Apple's instructions for how to do that
are at

    https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac

In short, one way to grant the exception is:

1) Control click (i.e. click while holding the control button down) on the
   application in the finder.
2) Select "Open" in the menu that comes up.
3) That will bring up a confirmation dialog about allowing the application to
   open on the system.
4) If your account does not have administrator privileges, there'll be an
   additional dialog asking you to authenticate as an administrator to apply
   the exception to the security settings.

For Mac OS X with Xcode installed, the Unix instructions can work to build a
version usable from a terminal.  If XQuartz, https://www.xquartz.org ,  is
installed, X11 will be used for display.

For Mac OS X 10.8 or later with Xcode installed, a native version can be
built by downloading the source archive and running

tar -zxvf hengband-x.x.x.tar.gz
cd hengband-x.x.x
./configure --disable-japanese --enable-cocoa
make install

from a terminal where you substitute x.x.x with the version number you
downloaded.  That will build hengband.app in the hengband-x.x.x directory;
you can then move hengband.app to where you want it to be.

-----  Basic for Playing  ------

     We recommend that you go to the Yeek cave next to your starting position 
in the town of Outpost.  Although the King of Yeeks at the lowest level is a 
fierce enemy, the rest of the cave should be fairly safe.  Once you complete 
this dungeon, you will be strong enough to leave Outpost in search of greater 
adventures.  Carry lots of food and fuel, for the journey can be a long one.  
Since this world is very large, it is convenient to go into global map mode by 
pressing the '<' key, and then return to local map mode by '>' key when you are 
at the destination.  When in the wilderness, stay in safe grids such as roads 
or plains; seas and lava fields are best avoided for a while.
	Many towns and dungeons await you; good ones to explore early on include 
the orc caves and the Labyrinth.  To the northeast of the town of Morivant, 
near the center of the map, is the dread dungeon of Angband.  It is home to the 
Serpent of Chaos, whom you must kill in order to win the game.


---------  Commands  ----------- 

     Please read on-line help (Press the ? key in the game) for full
information of the game.  Here are only descriptions of basic commands.

     The following section lists most commands, and the less frequently used 
ones may be accessed by pressing the return key, or (if using the original 
keyset) the 'x' key, to bring up the command menu.  Almost any command may be 
chosen from the main menu.  "(R) Rest" can be performed by pushing 'R' (in 
uppercase).  "Look around (l/x)" can be performed by pushing 'l' in the Original 
keyset, and by pushing 'x' in the Rogue-like keyset.



  [Movement]

     Original Keyset Directions

              7  8  9
              4     6
              1  2  3

     Roguelike Keyset Directions

              y  k  u
              h     l
              b  j  n

  5/, Stay still
  <   Go up staircase or Enter global map mode in the wilderness.
  >   Go down staircase or return from global map mode in the wilderness
  Shift+direction   run
  Ctrl+direction   attack, open, close, or dig

  [Tools]
  r  Read a scroll
  q  Quaff a potion 
  u/Z  Use a staff
  a/z  Aim a wand
  z/a  Zap a rod
  E  Eat some food
  A  Activate an equipment
  F  Fuel your lantern/torch
  f/t  Fire a missile

  [Action]
  d  Drop an item
  g  Pick up items
  R  Rest for a period
  o  Open a door or chest
  s  Search for traps/doors
  k/Ctrl+d  Destroy an item

  [Magic]
  m  Cast a spell / use mental power
  G  Gain new spells/prayers
  U/O  Use bonus power
  b/P  Examine spells (choose each spell to get a description)

  [Equipment] 
  w  Wear/wield equipment
  t  Take off equipment
  F  Fuel your lantern/torch

  [Info] 
  x  Examine items in a store
  C  Character description
  I  Examine an *identified* item
  i  Inventory list
  l/x  Look around
  M  Full dungeon map
  ~  Display various information

  [Other]
  p  Command pets
  =  Set options
  $  Reload auto-picker preference file
  _  Edit auto-picker preference
  n/[  Repeat previous command
  @  Interact with macros

  [Help]
  ?  View the on-line help 
     (Press a-z to choose a section,  space key to go next page.)


--- Inscriptions

Below, only the new features in Hengband are explained.

- 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.

- 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.

- You can inscribe on *identified* items with "%" or "%all".
  Then, "%" or "%all" is automatically replaced by strings which describe the 
  item's abilities. 
  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.


---- Auto pickup/destroy

Hengband offers two different methods of auto-pickup/destroy.
- Powerful method
  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.

- Easy method
  Since the powerful method is slightly difficult to use 
  effectively, there is another very easy option.  you can turn on 
  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.

------ Tile graphics, Big tile, and Big screen

- Tile graphics
  To use graphics mode, choose it from menu for Windows and Mac, or
  use -g option for Linux.  There are 8x8 size old tile and 16x16 size
  Adam bolt tile, and you can change from menu for Windows and Mac, or
  use -- -a option to use 16x16 tile for Linux.  Since source archive
  doesn't include 16x16 size tile, you need to download the
  heng_graf.tar.gz.

- Big tile (Double-width tile)
  In the Big tile mode, graphic tile have double width, and become
  square.  You can choose Bigtile from menu for Windows and Mac, or
  use -- -b option for Linux.

- Big screen
  You can resize each window using mouse, which allow you to have
  terminal windows larger than 80x24.  On linux, it's convenience to
  use environment variables: ANGBAND_X11_COLS_0 and
  ANGBAND_X11_ROWS_0.


------ Play Record
Play record will be written to a file named 'playrec-<character's name>.txt' 
in the same directory as your user preference file.  It is in ~/.angband/
Hengband/ for UNIX, or hengband/lib/user/ for other OS.
'|' command displays play record in the game.


------ World score

When You die, or retire, you can register a score to the world 
score sever through the Internet. 
However, please do not register a score, if you have cheated 
by modifying data or source files, or by restoring from a backed 
up savefile.

The score server is here:
  http://hengband.sourceforge.jp/en/score.html

