This setup is only guaranteed to work under Linux.  If you're running
under Windows, see INSTALL_WIN32.TXT.  If you're running under BSD,
you'll probably need to use the Expert install, but I have no
experience with that.

EASY SETUP (Linux only):

Make sure your Wolfenstein server is installed and running on the same
machine you're going to run WAB on.  Then:

./install-wab

Accept all the defaults.

Manual Setup:

1) Untar the file.  I presume you've already done that if you're
   reading this.  :)  This should result in a directory called
   "wab-0.91d".  I recommend putting this directory in your Wolfenstein
   directory.  By default this is /usr/local/games/wolfenstein.  This
   document assumes you have the default directory.  If you installed
   it somewhere else, replace all instances of
   "/usr/local/games/wolfenstein" with where you installed it, since
   you seem to think you're so smart.  

2) In order to be able to talk to the server, WAB needs two things.
   First of all, it needs to be able to read your server's log files.
   With a default install of Wolfenstein, these are probably
   someplace really weird.  In order to get this to work, you'll need
   to update your server.cfg so that they are both created and
   somewhere sane.  Add these to your server config file:

     set g_log games.log
     
   And, add to your execution of wolfded:

     +set fs_homepath /usr/local/games/wolfenstein +set fs_basepath /usr/local/games/wolfenstein

   If you make your logs live somewhere other than

     /usr/local/games/wolfenstein/main/games.log

   you'll need to update wab.cfg, and put the new value in the section
   [server], variable "game_logfile".  Now, edit your server.cfg (the
   file you put your RTCW settings in), and make sure the line:

      set g_logSync 1

   is there.  This forces Wolfenstein to dump its data to the logfile
   in real time.

   Secondly, you need an RCON password.  Find the above-mentioned
   server.cfg, and make sure it has a line like:

      rconPassword MyPassword

   in it.  IMPORTANT!  Do not actually use "MyPassword" for your
   password!  Choose something else other people won't be able to
   guess!  Once you have an rcon password, open wab.cfg back up, and
   set the variable "rcon" in the section [server] to the same
   password you chose, above.  Also make sure that the values
   of "ip" and "oob_port" (the same port you run your server on)
   are correct.

3) Browse through wab.cfg, and see if it fits your server philosophy.
   The default config is very agressive against TKs; kicks people with
   objectionable nicks, and doesn't change the length of the game.  I
   recommend not messing with the [anti_tk] or [weapon_tk_points]
   sections unless you really know what you're doing.

4) Run your Wolfenstein server.  Remember to stop and restart your
   server if you made any changes to server.cfg, above.

5) Run WAB:

   cd /usr/local/games/wolfenstein/wab-0.91d
   ./wab

That's it!  If you install WAB and doesn't seem to do very much at
first, give it a round or two to get its bearings.  When it comes in
in the middle of a game, it may be the warm-up round at the 
beginning where TKing doesn't matter.  Unfortunately, the only way it
can figure out what's happening is to wait for rounds to cycle.  In a
round or two, it should start working at full speed.

--

A note on perl versions:

I developed this and ran it on 5.6.0.  I have a report of it working
on 5.5.4.  I know it's fine on 5.6.0, but earlier versions may require
a new IO::Sockets from:

  http://www.cpan.org/modules/by-module/IO/IO-1.20.tar.gz

Thanks to Simon Garner for helping me track down some bugs with perl
versions.

Also, Chase Earles reports that ActivePerl 5.6.1 for Windows works.
