This log parsing utility will generate nice HTML player statistics, some nice changes have been made, read the read-me for full description of the new stuff :)
Copyright (c) 2002-2003 Jesse Brandeburg. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself. ---------------------------------------------------------- Title: SoF2Logger Author: Sam Evans Author2: Jesse Brandeburg 'miCro' Author3: Ravencroft E-Mail: email@example.com E-Mail2: firstname.lastname@example.org E-Mail3: email@example.com Website: http://jk2.gamersimpact.com/index.php File Name: sof2logger.zip Date Updated: May 13, 2003 Description: This log parsing utility will generate nice HTML player statistics. ---------------------------------------------------------- NEW: Please see the file CHANGES for improvements DISCLAIMER: I make no warranties / claims that this program works, or will not destroy your data. By using this application you agree that you will not hold the author(s) liable for any damages incurred, or time lost. *** Use this application at your own risk! *** Naturally, this is an evolving project. You are free to hack this code up, do whatever you want with it. But, one thing I do ask is that if you do use some of my code, please give me (us) credit for it. :) INSTALLATION: This program should be ready to run out of the archive, with the user only needing to copy a games.log into this directory. You can make all configuration changes in logparse.conf or change your colors in stats.css CONFIGURATION: If necessary, edit the enclosed logparse.conf file, and change the settings to match your configuration. Note, that if you are specifying a directory name, leave off the trailing backslash. In the script file are Weapon Mapping names. You can change what the Game calls a weapon to what you want to call the weapon. For instance, you can change MOD_MP5 to 'by MP5er'. Read the instructions in the script file. Lastly, you can customize how the output is layed out. Included with this script is a main-stats.html and player-statfile.html template file. Inside this file are script specific tags. DO NOT CHANGE THESE!!! You can change the order, and location. You can even put these tags inside HTML tables, whatever you like. NOTE!!!! It is VERY important that once you rotate your logfile, you run the logparse program so that it can update it's last line counter. Failure to do this could result in tainted stats!!!! (see MODUS OPERANDI below) STATS GENERATION Once you've configured your files you need to try it out! typically you'll already have perl installed under linux, and under windows you'll have to find perl and install it. Make sure you've copied your logfile into the sof2logger directory (unless you've reconfigured its location in logparse.conf) as games.log Once thats done, run perl logparsesof2.pl or perl logparsesof2.pl -c my_logparseconf.conf There are several options you can include: -reinit Delete the players.dat files and all historical tracking from rotated logfiles. -c <conf file> Specify a configuration file other than the default logparse.conf -logfile <file> Specify a logfile to parse and build stats from, override the file specified in <conf file> -h Get a short description of these options -d run in debug mode (LOTS of output) MODUS OPERANDI There are two basic modes (and probably some more) of operation you can use this script in. METHOD ONE 1) stop your server 2) copy your games.log file to the sof2logger directory 3) restart your server, it will continue to append to the existing games.log file 4) run perl logparsesof2.pl 5) move your new stats in sof2logger/public_html to a web directory and you're done! This sequence will result in a forever growing games.log file, but is very easy to manage. Also, all your historical data is located in one file. The logparsesof2.pl script will remember where it left off and continue parsing each time you run stats. METHOD TWO 1) stop your server 2) MOVE your games.log file to the sof2logger directory (this is also called rotating your logfile) 3) restart your server, this will re-create a new games.log 4) run perl logparsesof2.pl, stats will accumulate in the data/players.dat file, and each time you run with a new games.log file your stats will be updated with the new information 5) move your new stats in sof2logger/public_html to a web directory and you're done! This sequence results in the smallest possible games.log file to transfer each time you run stats, but is not as easy to recreate all your historical stats should something go wrong. OUTPUT FILES If you didn't change the default logparse.conf file, a directory called public_html was created in the same directory as this README exists in. This directory contains the generated output of your stats, and can be moved to a web server directory intact and everything should work correctly. ::::::NOTICE:::::: THIS MODIFICATION IS NOT MADE, DISTRIBUTED, OR SUPPORTED BY ACTIVISION, RAVEN, OR LUCASARTS ENTERTAINMENT COMPANY LLC. ELEMENTS TM & © LUCASARTS ENTERTAINMENT COMPANY LLC AND/OR ITS LICENSORS.
There are no comments yet. Be the first!