
REQUIREMENTS FOR THIS PROGRAM:
        * A Linux system with perl 5.0 or greater installed
        * Access to a web browser (preferably on the system your halflife
          server resides on)

FEATURES:
        * Creates HTML for all players that have a kill
	* Keeps stats across many different maps.  Does not operate on
	  a game to game basis.
	* Customizable HTML colors
	* Creates a very aestheticly pleasing and easy to use web interface
	* Shows a table for most uses of crowbar, bolt and gluon
	* Processes LARGE log files in short amounts of time
	  (Test machines are as follows:
	  1.	Running Redhat 6.0 on  
		Dual PPRO 180, 64MB pc66 dimms, 7200RPM IDE 10.2GB
		Processes about 10 megabytes of logs in 54 seconds
	  2.	Running Mandrake 6.0 on
		PII-350, 96mb pc100 dimms, 5400RPM IDE 9.6GB
		Processes same 10 megabytes of log files in 25 seconds
	  NOTE: Other halflife stats programs (on win32) took up to 2.5 
		minutes to process the same set of data on similar machines.)
        * Summarizes total kills, total deaths and efficiency
        * Creates a player HTML page for each player in the top 25
          (unless you reconfigure that number)
        * Summarizes hardest/easiest opponents for each player
        * Tracks your weapon usage with RAW numbers and % of your
          total kills
	* Tracks each opponent you frag.  Shows how you did against them
	  and how they fared against you.  Uses raw numbers and a 
	  kill to death ratio
	* Reports total size of log files
	* Reports time in seconds of computation
	* Is configured through and easy to edit external config file

HOW TO INSTALL:

        1. Create a directory to store halfStats html in
           (be sure to create a dir called "players" in that dir)
       	2. Copy halfStats files into that directory
        3. Edit 'halfStats.cfg' in your halfStats directory
	4. Add '+set mp_logfile 1' to your server startup script
	5. Check the permissions on not only copied files, but the
	   logs directory.  Example:
	   	chmod ugo+rx logs
		chmod ugo+r logs/*
	6. Edit your servername.txt
	7. Copy the default index.html to your html directory

THINGS YOU MAY WISH TO ALTER:
        
        *  halfStats only shows the current month's stats.  To change this,
           search for this code:

            if($year == $curYear && $month == $curMonth)
            {
                chomp($end);
                $obitArray[$count] = "$end";
                $count++;
            }

          Replace that code with:

           chomp($end);
           $obitArray[$count] = "$end";
           $count++;

          Basically, just remove the if condition and its brackets.  This will
          add all stats to the page.  This can significently effect the
          amount of time halfStats takes to complete.

LATEST CHANGES

v0.93 - 09/16/1999
------------------
* Added opponent tracking table 
  Shows each person you've killed in the following format:
   [Name] [Times killed] [Times they killed you] [Kills per death] 
  -- Thanks Oliver Henry!
* Modified the way configurations work.  Individuals will now edit
  the 'halfStats.cfg' file in their halfStats directory.  Configuring
  halfStats is no longer done at the top of the PERL script
* Added the "Those" Weapons awards.  Thanks to Adam Davidison (author of HLR)
  whose program gave me the idea for this modification
* MAJOR additions to this file (README)


v0.92 - 09/10/1999
------------------
* Added the ability to alter background, foreground, and link colors
  (most table headers stay the same)
* Added logfile size and computation time summary
* Added links to halfStats homepage and my email address
* Minor aesthetic changes

v0.91 - 09/08/1999
------------------
* Updated the routines to CORRECTLY track least kills and hardest to kill.
  Players who had not been fragged or had not fragged someone at all were
  reporting them as the match.  Instead of a NULL entry for frags, it now
  does not coaunt them at all
* Made weapon usage summary display in ranked order by highest percentage.

v0.90
-----
* First version, not released due to problems with tracking least kills and
  hardest to kill summaries.
* Added month to month cut off (consequently year to year cut off as well)
* Added a customizable limiter for main page listing.

