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

                           Angband 2.8.1

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

This is a quick port of the semi-stable Angband 2.8.1 to the Amiga.
It contains everything that was in Angband 2.7.9v6 for the Amiga
except the ability to show an objects graphic in the inventory,
equipment and shop lists.

Angband does not require an "Angband:" assign.  The relevant
directories have been moved into a subdirectory "lib" to be more
consistant with other platforms.  You can redirect this by setting
the ANGBAND_PATH, using SETENV.

The "src" directory contains the differences from the original
Angband 2.8.1 source archive.  If you want to compile angband,
you can dowload the source from

  ftp://export.andrew.cmu.edu/angband/Source/ ???


Enjoy!

Tak, 29th June 1007

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

                           Angband 2.7.9v6b

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


IMPORTANT! Read about a virus in the previous distribution
           in section 6 of this file.


1. Introduction

   This is the binary distribution of Amiga Angband 2.7.9v6, featuring
   graphics and sound effects, both of which are optional.

   Some of the new Amiga-specific features/updates in this version:

   - KS1.3 support
   - Compiled to work on any 680x0 processor.
   - Preferences file 'Angband:user/settings.prf'.
   - Support for multiple windows (recall/choice/mirror) on KS3.0+.
   - Faster rendering on custom screen.
   - Shortcuts for SHIFT/CTRL/ALT + direction keys built in.
   - Tombstone graphics, drawn by Torben Kristiansen.
   - Infrequently played samples are loaded on demand and freed
     after use to save memory.

   For changes that are not Amiga-specific, have a look at the
   Angband homepage. (See section 7 of this file for the URL)

   Angband features a comprehensive online help system. You can
   enter the help menu by typing a question mark ('?') almost
   anywhere in the game.


2. Requirements

   - About 1.4MB 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

       LhA -a x Angband-279v6.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,
      or in some script file you run before starting the game:

       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.


4. Usage

   For Amiga specific settings, look at the preferences
   file 'Angband:user/settings.prf'.

   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. You can also
   use the supplied command 'Angband:bin/ReqChar' like this:

    Angband -u`ReqChar`

   For this to work, you'll need to have T: assigned somewhere.
   If you haven't, use the command 'Assign T: RAM:'.

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

   If you want to change _default_ settings for a new game, create a
   character called "PLAYER". Then set options (with "=" or menus), 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, Thomas H. Davies and
     Torben Kristiansen.

     Look at the preferences file 'Angband:user/settings.prf'
     if you want to turn off the graphics, or play with any of
     the other customizable attributes.

   - Sound effects. The samples are stored in uncompressed 8svx
     format, and is located in the directory Angband:xtra/sound.
     If you want, you can include your own samples by just replacing
     one or more of the files there. Most of the samples are loaded
     into memory when the game starts, so if you plan on adding
     some large samples, be sure to have some free chip memory,
     or the sounds will not be loaded.

     If you want to turn off individual sounds, just move the
     sound file in question to the Angband:xtra/sound/off directory.

     Turning off sound will help if you're low on memory.
     (Look at the preferences file).

   - Use whatever monospaced fonts you like. The graphics are scaled
     to fit the fonts, so they will look best if you use a font
     with size 8x8, 8x16, 16x16 and so on. But any sizes are legal.

     If the specified font cannot be used, because it is proportional
     or if it does't exist, the default monospaced font will be used.

   - Use whatever screenmode you like. Use the supplied command
     'Angband:bin/ReqMode' to find the ID number you wish to use.
     Look at the preferences file.

   - You might also want the game to open its window(s) on a public screen.
     This requires that you have KickStart 3.0 or later.

     There is a supplied program 'Angband:bin/PubScr', which lets you
     create a public screen with your desired attributes. Usage:

      PubScr NAME/A,TITLE/K,SM=SCREENMODE/K,WIDTH/N,HEIGHT/N,DEPTH/N,
             TOFRONT/S,CLOSE/S

     Here's an example of how to use this:

      [ Edit the prefs file to have the line 'SCREEN.name Angband' ]

      PubScr NAME=Angband SM=0x29024 WIDTH=1296 HEIGHT=430 DEPTH=6
      Angband -n

     If you ommit any of the SCREENMODE, WIDTH, HEIGHT, or DEPTH
     parameters, the corresponding attribute for the Workbench screen
     will be used.

     If you ommit the TITLE option, the NAME string will be used as
     screentitle.

     The TOFRONT option moves the public screen to the front of the
     display as soon as it is created.

     The CLOSE option is used to close an existing public screen,
     provided there are no windows on it. Note that if you create
     a public screen and open one or more windows on it, it will
     automatically close itself when the last window is gone.

     Take a look at the script file 'Angband:bin/AngPub' to see
     how it can be done. Use the following command to run a
     game on a public screen:

       AngPub <Character_Name>

   - When using a public screen, the mirror/recall/choice windows
     will by default also be opened. To turn one or more of these
     windows on/off, you must edit the preferences file:

      CHOICE.use N
      RECALL.use N
      MIRROR.use N

     Now the windows will not be used. Alternatively you may simply
     comment out the line(s) with a leading semi-colon.

     Note that you can not use multiple windows if you are
     playing on a custom screen.

   - Intuition menus to display and execute game commands and
     options, and to browse the help files. Can be turned off
     by editing the preferences file.

   - Graphics in store/equipment/inventory listings, and options to
     toggle this feature on/off. (Options/Inventory menu).

   - Scaled-down map of the whole dungeon, like in CWMAngband.
     Press the 'RIGHT AMIGA + m' key combination to view the
     map.

   - The following keyboard shortcuts are built in:

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

   - The graphics are included in IFF ILBM format in case you want to
     edit them. To convert this file to the raw bitplane format used
     by the game, use the commands

      Cd Angband:xtra/gfx
      Iff2Raw tiles.iff tiles.raw 32 32 256 256

     This requires Kickstart 3.0+, and uses Christian A. Weber's
     'iff.library 23.2', included in the xtra/libs directory.


6. Bugfixes

   Amiga-specific bugs in 2.7.9v6 that have been fixed:

   - Some of the files in the bin/ directory were infected
     by the 'Happy new year' virus. :( As far as I know this
     virus is harmless, it just adds some text to the infected
     executable files.
     If you have downloaded and extracted the Ang279v6.lha
     archive, please delete all files from this archive
     and run a virus scan on your HD. The infected files can
     be fixed by 'VirusZ II 1.31' by G.Hlmann. This program
     can be found on AmiNet as 'util/virus/VirusZ_II131.lha'.
     I'm deeply sorry about the inconvenience this might have
     caused.

   Amiga-specific bugs in version 2.7.9v5 that have been fixed:

   - Some sounds were played with wrong sample-rate. Fixed.

   - Menus did not work well with MagicMenu. Partually fixed.
     Deadlocks can still occur when multiselecting checkmarks.
     This is due to MagicMenu's handling of IDCMP_MENUVERIFY.

   - Keymap file removed, since it could cause unwanted results
     with other programs. The keyboard shortcuts that came with
     the keymap file are now built into the game instead.

   - The large yellow snake appeared as a large *black* snake. Fixed.

   Amiga-specific bugs in version 2.7.9v4 that have been fixed:

   - The menus had unreadable colors on the Workbench screen. Fixed.

   - When changing options by other means than using the intuition
     menus, the menus would not be updated. Fixed.

   - When multiselecting options in the menus, only the first selection
     would be noticed by the program. Fixed.

   - When using a staff/wand/rod, a sound would be played even if the
     magic failed. Fixed.


7. Internet Support

     All Angband related files can be found at these sites:

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

     Be sure to read the newsgroup dedicated to Angband:

        rec.games.roguelike.angband

     And check out Ben Harrison's Angband homepage at:

        http://www.voicenet.com/~benh/Angband/


8. Author

     Don't hesitate to contact me for any questions, comments, suggestions,
     or anything regarding the Amiga version of Angband. And please send me
     more graphics and samples. :)

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

                                                        Lars Haugseth, 27/7-96

