
				DoomArena 2.0

DESCRIPTION

    DoomArena is a waiting room for DOOM games on Solaris 2.  People
    everywhere on the net can run doomarena and then start doom games
    with other people waiting to play.  It is a great tool to help you
    waste more time playing doom.  This is good, because playing doom
    is very therapeutic and will make the time you do spend working
    much more productive.

    DoomArena makes it really easy to start networked DOOM games with
    other people.  Here are some of the advantages DoomArena has over
    regular Sun DOOM:

        o  Easy startup of networked games
        o  Full Mouse support (not part of standard Sun DOOM)
        o  Easy and reliable configuration of game options
        o  Frag matrix with realtime updates
           (e.g., who has killed who, and how many times)
        o  .doomrc configuration panel
        o  Audio controls
	o  Map preview


INSTALLATION

    ** If you are upgrading a DoomArena 1.0 server, read the section
    ** below on upgrading before proceeding.

    DoomArena should be installed in a directory that is accessible
    from NFS.  Use the "share" command to figure out which disk
    partitions are exported.

    Installation steps:

    0) Optional:  Create a "doom" user on your machine, and install
       doomarena as the "doom" user.  Then you can run the server
       as the "doom" user, rather than yourself.

    1)  uncompress DoomArena-2.0.tar.Z
    2)  tar xf DoomArena-2.0.tar
    
    This will create a directory called "doomarena".
    
    3)  This step is necessary to enable network play:
    
        Edit the file doomarena/src/script/Makefile.
        Remove the following line:
    
    DAPARENT:sh = cd ../.. ; pwd
    
        Set DAPARENT to the auto-mountable path where doomarena
        is installed.  For example:
    
    DAPARENT=/net/hostname.domain/export/games/doomarena
    
        People on other machines will then be able to invoke
        /net/hostname.domain/export/games/doomarena/bin/doomarena,
        and will connect to your DoomArena server.  I couldn't figure
        out how to automatically determine the auto-mountable path
        for a given directory, therefore this step is needed.  If
        you know how to do this automatically, I would appreciate
        your feedback.
    
    4)  cd doomarena ; ./arenacache
    
    
    + To run the server +
    
    cd doomarena/server
    ./das >& das.out &

    Note: The server must be run on the same machine where the
          "arenacache" command was run.
    
    + To run the client +
    
    cd dooarena/bin
    ./doomarena

    Note: The client can be run from any machine that has NFS access
          to the doomarena installation.
    
    A copy of DoomArena will be installed in /tmp, or a local directory of
    your choice.  The reason for this is that people running doomarena
    over the net will get MUCH better performance with DoomArena installed
    on their local disk.

    + Running doomarena locally +

    If you are on the same machine as the doomarena installation, you
    can run doomarena with the -local flag.  This means that doomarena
    will not be installed in /tmp, but will be run directly from the
    original install directory.  This is a useful option if you
    simply want to play single player DOOM and don't care about
    networked play.


UPGRADING FROM DOOMARENA 1.0

    DoomArena 2.0 is _not_ backward compatible with version 1.0.  The
    safest way to avoid problems is to shutdown the old server and
    remove all client installs.  A version 1.0 client will cause
    endless error popups for other players.  Install the 2.0 server
    following the instructions above and re-install the clients as
    usual.


AUDIO PATCH

    If you are running Solaris 2.4 on an SS4 or SS5 machine, you will
    need to apply a patch in order to get audio to work.  This patch
    can be found in doomarena/AUDIOPATCH/102125.tar.Z.


REGISTERED WAD FILES

    DoomArena comes with doom1.wad.  This is the shareware version
    of the DOOM.  If you purchase a copy of DOOM or DOOM II, then
    you can play the registered version of the wad file with Sun DOOM.

    DoomArena comes with some shareware wads written by various
    people that are enabled only if the registered wad for DOOM
    or DOOM II is installed.

    To upgrade DoomArena with the registered wad files, you must
    buy DOOM or DOOM II and then patch the wad file to version 1.8
    or 1.9.  This requires a PC machine because the patch scripts
    will only run under DOS.

    1)  Install DOOM and/or DOOM II on a DOS machine

    2)  Copy and apply the appropriate patch file(s).  The patch files
        are available via anonymous ftp at the locations listed below.
        You need to apply a combination of patches that will get you
        from your current DOOM version up to version 1.8 or 1.9.
        1.8 is preferable, but 1.9 will do.  The DOOM demo causes the
        game to crash if you have any version other than 1.8, therefore
        with version 1.9 you have to start a game quickly before the demo
        starts running.  Your current DOOM version is the one listed
        at the top of the screen when you start DOOM on the PC.

        Patches for DOOM and DOOM II can be found at the following sites.
        (The "idstuff" directory contains the patches.)
    
        California  ftp.cdrom.com/pub/doom
        Texas       ftp.idsoftware.com/tonsmore/doom/
        Utah        ftp.pht.com/pub/games/doom/
        Wisconsin   ftp.uwp.edu/pub/games/id/home-brew/doom/
        New York    doomgate.cs.buffalo.edu/pub/idgames/
        S. Africa   ftp.sun.ac.za/pub/msdos/idgames/
        Taiwan      nctuccca.edu.tw/PC/games/DOOM/
        Austria     flinux.tu-graz.ac.at/pub/idsoftware/
        Germany     ftp.fu-berlin.de/pc/msdos/games/doom
        Netherlands ftp.sls.wau.nl/pub/msdos/doom/
        England     ftp.dungeon.com/pub/msdos/games/IDgames/
        Sweden      ftp.luth.se/pub/games/doom/
        France      anasgard.calvacom.fr/pub/pc/doom

    3)  Copy doom.wad and/or doom2.wad from the PC into the top level
        doomarena directory.  This is best done using pkzip because it
        will split the wad file across multiple floppies.  pkzip,
        pkunzip, and unzip are included as part of doomarena, and can
        be found in the zip directory.

        Invoke the pkzip command as follows:
            pkzip -& a:\doom.zip doom.wad

        To unzip the wad on the Sun machine, copy all the zip files off
        of the floppies, cat them all together, and use unzip.  Be sure
        to use the version of unzip from doomarena/zip/unzip!  "unzip" will
        spew a bunch of warnings, but these can be ignored.
            cat doom.zip1 doom.zip2 doom.zip3 ... > doom.zip
            unzip doom.zip

        This operation can be done with only one floppy as follows:
        PC
            pkzip -& a:\doom.zip doom.wad
            Insert disk #2 - Press a key when ready
            <Take the disk out and put it in the Sun machine>
        SUN
            volcheck
            cp /floppy/<diskname>/doom.zip ./doom.zip1
            rm /floppy/<diskname>/doom.zip
            eject
            <Put the floppy back in the PC and press a key>

        Repeat these steps to create doom.zip1, doom.zip2, etc., then
        invoke unzip as follows:
            cat doom.zip1 doom.zip2 doom.zip3 ... > doom.zip
            unzip doom.zip

        Move the doom.wad and/or doom2.wad file into the top level
        doomarena directory.  Be sure to rename DOOM.WAD to doom.wad,
        and DOOM2.WAD to doom2.wad.

    4)  Re-run the DoomArena clients:
            doomarena/server/dasadmin RerunClients
        NOTE:  Re-running the DoomArena clients will kill all currently
               running DOOM games.  This tends to upset people, so be
               careful.


ADMINISTRATION

    Read the file doc/administration for directions on adding new sounds
    and new wad files.


PERFORMANCE

    The version of sundgadoom included with DoomArena has been
    tuned for the sun4m architecture.  Therefore, you will not
    get very good performance on sun4c machines (SS1, SS2, etc.).


AUTHORS

    Douglas Stein
    Steve Jankowski


BUGS/COMMENTS

    Send email to doomarena-bugs@activesw.com


MAILING LIST

    There is a mailing list for general discussion of DoomArena.
    The list will be of most interest to server maintainers, but
    players might find it interesting as well.

	echo subscribe | mail doomarena-request@activesw.com
