-------------------------------------------------------------------------

                     Amiga Angband 2.7.9v3 Graphics

-------------------------------------------------------------------------

1. Introduction

   This is Amiga Angband 2.7.9v3 with graphics, binary distribution.

2. Requirements

   - CPU 68020 or better.
   - Kickstart 2.04 or newer. (Only tested on 3.0)
   - About 1.3MB of available memory.
   - A program to extract LhA archives, like LhA, LhX or Lx

3. Installation

   3.1. Harddisk installation

      First, select a directory on your harddisk to which you want to
      install Angband. Substitute the $PATH word used below with the full
      path to your chosen directory, ie. "DH0:Games"

      Use the command

         LhX x Ang279v3Gfx.lha $PATH/

      to extract the archive anywhere on your harddisk. A directory
      called 'Angband' will be created there, containing all the
      necessary files.

      Insert the two following lines at the end of your S:User-Startup file:

         Assign Angband: $PATH/Angband
         Path Angband:bin ADD

   3.2. Floppy installation

      You'll need two formatted and empty disks. Name the first
      disk whatever you like, and the second disk "Angband:".
      After extracting the archive to RAM: or whatever, copy the
      main executable file 'Angband' to the first disk, then
      copy all the directories to the other disk.

      You might be able to stuff everything onto one disk by
      compressing the executable.

4. Usage

   When playing for the first time, or whenever you want to create
   a new character, start the game with the command

      Angband -n

   and the game will let you create a new character.

   To restore a saved game (which are in lib/save directory), use

      Angband -uName

   Where "Name" is the name of the your character. Note that when your
   character dies, there is still a save file there. Remove obsolete save
   files now and then. You can backup save files, but that is cheating
   (according to True Faithful Worshippers of Holy Angband).

   If you want to change _default_ settings for a new game, create a
   character called "PLAYER". Then set options (with "="), save the
   game, run angband -uPLAYER and get the character killed.

   Settings in save file "Angband:save/PLAYER" are always loaded when you
   start a new game. It will say "Restoring Memory of a departed
   spirit..." when this happens.

   If you change your character's name, save file name will change too.

   To see command line options, try "Angband -?".

5. Features

   Amiga-specific features of this version of Angband are

   - Graphics drawn by James Larimer and Thomas H. Davies

   - ASCII, if you prefer to play it the classical way. Use
     the commands

        SetEnv ANGBAND_NOGFX "Yes"
        Rename Angband:user/pref-ami.prf Angband:user/pref-ami.off

     to turn the graphics off. (They are on by default). To turn the
     graphics back on, type

        UnSetEnv ANGBAND_NOGFX
        Rename Angband:user/pref-ami.off Angband:user/pref-ami.prf

   - Use whatever monospaced font you like, though when using graphics,
     the font must be 8x8 pixels or smaller. Use the command

        SetEnv ANGBAND_FONT "`SelFont`"

     to select a nice font. (The "`" char used above is the one you get
     by pressing the ALT key together with the key above the TAB key.)

   - Use whatever screenmode you like, provided it can have a screen
     big enough for the necessary 8024 characters display used by
     the game. Use the command

        SetEnv ANGBAND_MODEID "`DisplayID`"

     and a screenmode requester will appear which lets you select the
     prefered screenmode. If no screenmode is specified, or if the specified
     mode is unsuitable, the program will try to pick a suitable one.

   - Graphics in store/equipment/inventory listings, and options to
     toggle this feature on/off.

   - A keymap file is included which is customized like this:

      * SHIFT + Numeric key 1 - 9     = Run in a direction
      * ALT   + ...                   = Tunnel in a direction
      * CTRL  + ...                   = Open door in a direction

     To use this keymap, copy the file Angband:Devs/Keymaps to DEVS:Keymaps/
     then use your SYS:Prefs/Input program to select this keymap.
     (Note: It is based on the american keymap.)

   - Wizard mode and Borg mode are included. Note that the Borg will not
     work in graphics mode.

6. Notes

     If you are playing in graphics mode, you should turn off the
     game options 'Draw torchlite in yellow' and 'Draw viewable light
     brightly', since they have no effect when using graphics, except
     slowing down the game.

     The roofs of the building in town in version 2.7.8 was a nasty hack,
     which unfortunately could not be applied to this version. I'm not
     sure if a savefile saved within town in 2.7.8 works 100% correct
     in 2.7.9v3, so if I were you I'd make a 2.7.8 savefile at 50 feet,
     and load this into 2.7.9v3.

     This binary was compiled with SAS/C 6.50. It does not use curses
     library calls. Instead graphics.library primitives are used directly
     to create the display. This is faster, and was easier to implement,
     especially since the current version of Amiga Curses had some missing
     features that made it unsuitable for Angband.

7. Bugfixes

     The following bug(s) in the base 2.7.9v3 code have been corrected:

     - A macro definition with hexadecimal keycodes in the P: field
       was not converted correctly. Example: '\x9b' was converted to
       character 0x91 instead of 0x9b. This is fixed. (Crucial if you
       want to store macros on the F-keys. Look at the file
       'Angband:user/example.prf').

8. Internet Support

     All Angband related files can be found at these sites:

        ftp://expert.andrew.cmu.edu/Angband/
        ftp://ftp.cis.ksu.edu/pub/Games/Angband/Angband-2.7.x/

     And be sure to read the newsgroup dedicated to Angband:

        rec.games.roguelike.angband

     Don't hesitate to contact me for any questions, comments, suggestions,
     or anything regarding the Amiga version of Angband.

     EMAIL :  larshau@ifi.uio.no
     WWW   :  http://www.ifi.uio.no/~larshau

                                                        Lars Haugseth, 26/1-96

