hlsStats
Version a.03
Readme Documentation
05/22/2001

hlsStats pre-release Team Fortress Classic statistics report generator.

INSTALALTION

Untar the hlsStats tarball into any directory. This could be /halflife/hlds_l/tfc directory.
The tarball contains the hlsStats executable and this file.

CONFIGURATION

Execution of hlsStats requires two parameters in one of tw formats:
logfile name and the output directory of the html source files.  

./hlsStats L0516000.log htmlDir=/home/httpd/html
This allows you to create single map statistics.
..or..
./hlsStats -ld=/halflife/hlds_l/tfc/logs -m<x> htmlDir=/home/httpd/html
where -ld= is the path to your tfc logfiles and <x> is the number of
previous logfiles to process. This allows you to create a listing of
 previous matches.

NOTE there is no trailing backslash on the "htmlDir=" output directory.
Four files are built in the htmlDir for each map's statistics: 
        hlsStats.html (the index start page)
        map_stats<xxxxxxx>.html
        svr_settings<xxxxxxx>.html
        converse<xxxxxxx>.html
        plyr_rankings<xxxxxxx>.html
        (where <xxxxxxxx> distinguishes between maps>

hlsStats may be used with a third party admin util such as hlds_ld. Place the following
lines in the STATS OPTIONS section of the hlds_ld.cfg file.

statspath=/hlsStats/hlds_l/tfc/hlsStats
#for single stastics
statsargs=%L htmlDir=/home/httpd/html/hlsStats
#..or..
# for the 5 previouse map stats
statsargs= -ld=/halflife/hlds_l/tfc/logs -m5 htmlDir=/home/httpd/html/hlsStats

Of course, specify the correct path of the hlsStats executable and your html file locations.

TROUBLESHOOTING

REMEMBER, this is a pre-release alpha version.  Report any problems or bugs to hlsStats@hosttheweb.com.
There is very little error handling built into hlsStats as of now, be sure to use the exact parameters
and specify correct paths. 

Next version will include some better error trapping, as well as accumulative stats on players
your users can go back several maps, customizable html and so on.  Suggestions are welcome!

REVISIONS

a.03 5/22/2001 - added processing for previous map list statistics
a.02 5/18/2001 - fixed map stats for odd team names (i.e. Dustbowl Team#1)
a.01 5/15/2001 - original release

DISCLAIMER

C.C.N. and HostTheWeb.com hold no responsiblty for any damages as a result of using this software.
Use at you own risk!

C.C.N. 
Continental Communications Network
www.ccnhost.com
www.hosttheweb.com
hlsStats@hosttheweb.com