Q3LA - Quake 3 Log Analyzer
===========================

*** THIS IS A BETA RELEASE - IT'S FAR FROM FINISHED AND MAY BE BUGGY! ***

Buggy? Ok. Personally, I think it's rock solid. It works with the three games.logs I tested it on. :)


WHAT'S THE PURPOSE OF Q3LA?
===========================

It generates html statistics from Q3's games.log file. Just that. Q3 uses the games.log only for multiplayer games and when you started to server, that is: for local multiplayer games against bots (no games.log if you start a single player game against bots!) and for LAN/Internet games, if you're the server. It is possible to create console logs if you are a client and not the server, but those logs are very simple and Q3LA currently doesn't support them.


HOW TO USE Q3LA
===============

Windows
-------

Unzip "q3la.exe" to your \baseq3 folder and just run it with "q3la games.log" in a command window / DOS window. It will then analyze the file games.log (won't work with the console.log at the moment!) and write two result files, players.htm and games.htm, plus a html file for each single game in the folder q3la_games (you can access those via games.htm).

Linux
-----

Unzip "q3la" to your \baseq3 folder and just run it ("./q3la"). Writes the same players.htm and games.htm as the Windows version. Faster than the Windows version when "games.log" is cached (but only then).

If you want to compile it yourself: unzip the "build xxx" folder, and from within that folder, simply run "make". Move or copy the resulting "q3la" executable to your \baseq3 directory.


SOURCE CODE
===========

The source code of Q3LA is included in this archive (both for Windows and Linux). You may use it for your own purposes and/or improve it - I'd just like you to tell me about it! 


STUFF
=====

My message to other log parser programmers: Release your source code. It may prove useful for others. Won't hurt you to do it, nobody will tell you it looks like crap (at least, not many people told me, and I know it is). 

INFO
====

Q3LA was programmed by:

Fabian Huester (me)	- main programming, design
Maxim Koshelev		- Linux port, helping me to make better code :)

Bug reports, suggestions etc.:

Jonathan Ritchie	- author of Q3Log, a great parser which includes Q3LA
Rubens Farias		- author the Zero parser, great HTML output
Shawn			- Testing and using Q3LA :)

If there's someone I forgot to mention, tell me.

For further information, visit my ugly homepage:

http://www.planetquake.com/idda/

Fabian Huester
spike@planetquake.com
ICQ: 2181442