
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
	* Has a configurable award system (works for any game you know 
	  the names of the weapons for)
	* Processes LARGE log files in short amounts of time
	  (improved in version 0.96: Large client counts do not suck 
	  all system resources, logs are parsed in a quarter of the time
	  it took 0.94)
        * Summarizes total kills, total deaths and efficiency
        * Creates a player HTML page for each player that has # of
	  kills greater than "minimumKills" variable (in the config)
        * 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
	* Counterstrike support
	* Weapon image usage if desired

HOW TO INSTALL:

	Run the supplied install script.

Key: 
	+ = Addtion
	* = Bug fix
	# = Modification (change)	
	
LATEST CHANGES

v0.96
------------------
NOTE: halfStats was COMPLETELY rewritten between version .95 and .96

! Routines and processing times improve GREATLY
+ Changed weapon images to be configurable
+ Suicide calculation can now be turned on/off
+ Award system can now be turned on/off
- Removed "hardest/easiest" opponents tables
  These are slightly pointless as of the opponent matchup table 
+ Changed to configurable award system
+ Counterstrike support (images too!)

v0.95
------------------
NOTE: 0.95 was never released due to inefficient handling of >200 clients

* Fixed blank entries in opponents table (on the player detail screen)
+ Added "favorite weapon" stat in the opponents table
  This shows which weapon an individual used most on all players killed
# Modified the above addition to use the weapon images
+ Added weapon images to the awards table
+ Added "Snark Tamer" award to the awards list
# Removed the dangerous ability to try and replace "" with the statsTool
  script.  
+ Added backup feature into statsTool.  statsTool now places logfiles.tar.gz
  into your home directory.  If anything should go wrong, there is a backup
  located there (just don't backup your mistakes!!)

v0.94 - 09/20/1999
------------------
* Fixed some minor logic problems with counting suicides
  Suicides were being counted as a Kill and a Death == WRONG
# Changed the way listMax works.  If set to 0, all players are 
  displayed
+ Added 'cronEntry' script to be put in a crontab to run 
  halfStats every 15 minutes (or however much you like)
+ Added 'install' script to make installation a bit easier
+ Added 'statsTool' program to the package
  This program allows you to Remove names, Replace names, and fix
  blank name errors
+ Added weapon images from half-life in place of the names
  (Thanks to alien@alienworld.org for the idea and to 
   kit@ukrpack.net for some of the images)
+ Added colored bars to proportionately display weapon %'s
+ Added more in formation about the host running halfStats
  (Last ran date/time and the hostname)
# Changed webpage contact to reflect space on planethalflife

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.

