Back to main

Who's The Winner
a Quake 3 Arena log analyzer
written in Python.


WTW - Version 1.1 Online Docs

Introduction.

WTW is a log analizer designed for Quake 3 Arena. Actually has only support for all Q3A mod games like: Free For All, Tournament Deathmatch,
Team Deathmatch and Capture The Flag. It can be used on LAN games and Internet game servers since is transparent to Quake 3. Infact who was
the server, can execute WTW after all games are finished, and generate HTML pages with a lot of stats about all games played on his server and later
decide to publish them on Internet.

Usage.

To execute WTW under Windows simply open the directory extracted from the installation archive and double click wtw.pyw
to execute WTW. You can make a shortcut if you prefer.
On Unix simply open your preferred shell and type:

python wtw.pyw


When WTW is started you'll see a gui like this (on Unix systems can differ a bit depending on your window manager):






First you had to select a Q3A log to process. Click the Browse button on the top right side and a file requester appear.
Search for the log usually inside baseq3 directory in your Q3A installation path.
After you selected the log can store this path clicking on the Save button on the bottom side, so the next time you'll restart
WTW will be shown on the entry field near the Browse button.
Now you should be ready for processing. Simply click the Go! button to start processing your log.
Note:
Remember that WTW destroy all HTML pages from a previous log processing, but never delete a Q3A log.
When WTW processing Q3A logs, makes a lot of stuffs, among other things drawing graphs for each games (major overhead).
On my Celeron 466 a 1.5Mb log containing 87 games is processed in 1 minute and 12 seconds.
You can see processing status on the middle bar of the gui in percentual measure.

To exit simply click the Quit button.


Score definitions and stats measurement.

Below follows a list about all score definition and stats measurement generated by WTW:

Frags/F
Number of times you kill another player except yourself or a teammate.
Each time you kill yourself or a teammate frag score is counted as negative frags incrementing Suicides and Team Kills score
Kills/K
Number of time you kill every player on the game including yourself (F+S+TK)
Deaths/D
Number of times you are killed by another player.
Suicides/S
Number of times a player dies due to an action of his own cause like falling in void, drowning, sliming, lava burning, accidentally splash damages from a weapon the player are firing.
Team Kills/TK
Number of times a player kills accidentally a teammate on Team DeathMatch or Capture The Flag game match.
Capture The Flag specifics
Flags Captured/FC When a player touch his own flag carrying the enemy flag.
Flags Backed/FB When a player picked his own flag in the world returning to his base.
Flags Picked/FP When a player picked an enemy flag.
Flags Dropped/FD When a player dies carrying ana enemy flag.
Efficiency/Eff.
Is a kills ratio: (Kills/Kills+Deaths+Suicides+Team Kills)
FOD (Frags On Deaths)
Is a skill ratio: (Frags/Frags+Deaths)
If this ratio is below 50% means you was killed more than you killed.
Viceversa is above 50%.
FPM (Frags Per Minute)
Is an average frag ratio vs. time (Frags/Minutes in a single game)
MFPL (Most Frags Per Life)
Is the max number of frags you score after you respawned in a single game.
Excellent/Exc.
Is the number of frags you score in a 2 seconds temporal gap killing more than one people togheter.
Impressive/Imp.
Is a Railgun skill ratio.Is the number of times you consecutivelly more players with the railgun except for the first occurence. Note: this ratio is computed analizing in some way Q3A logs because no infos on real impressives computed by Quake3 are written on logs.
Gauntlet/Gau.
Number of time you frag another player using Gauntlet weapon.
Play/Match Time
The time expressed in hh:mm:ss time format.


Stats generated.

After WTW processed a Q3A log, simply double click index.html inside WTW directory to view games stats.
The main page is divided in two part: the left part is a navigation frame, the right part inform you about how many games was played on you server.
The navigation frame show these links:

Individual Games

Shows a list of all games inside the log you've processed.

Player List

Shows a list of all players that have played on your server.

High & Low Scores

Shows two big tables with high & low scores on all games.

Ranking

Shows three tables:
1) Frags Ranking (who make more frags and other stats)
2) Delta Frags (how much frags to exceed the first player in frags ranking classific)
3) Winner Ranking (who wins more matches)

Map List


Shows a list of all maps played on your server.

Icons Help

Shows all symbols and icons used by WTW.

Main Help

This doc you're reading.

Inside WTW stats.

A) When you choose Individual Games a table like this appears:



You can see all games are sorted by game type relatively to baseq3 game.
The number on the right side means number of time a game type was played.
Clicking on the game type link will bring you to this table.



Clicking on the winner name or in the map link bring you respectively in the Player List and Map List page (that belongs to the winner or the map)
Clicking on the number on the left make you access to the single game stats page. There are a lot of infos inside grouped in table:
1) Game Infos showing fraglimit, timelimit, map name etc.
2) Ranking & Summary showing the rank for this game based on frags,kills,deaths,suicides,team kills (*) , efficiency,FOD,FPM,MFPL fo reach player
and the winner.
(*) For Team Deathmatch and CTF.
3) Special Mentions showing excellent,impressive and gauntlet score for each player.
4) Game graph showing Frags vs. Time progress. If you click it you'll see a bigger graph.
5) Match up tables showing a) match up and b) player vs. player efficiency.
In the first table in the rows are the killers and in the columns the victims. In each cell you'll see the frag score vs. a single victim.
In the second table you'll see a comparison between Player 1 vs. Player 2 computed in each cell in this way:
reading from Pl.1 vs. Pl.2 each cell represent Frags(Pl.1 vs Pl.2)/(Frags(Pl.1 vs Pl.2)+Frags(Pl.2 vs Pl.2)) and so on.
6) Specifics Kills,Deaths and Suicides show the way each player has killed, died and suicided himself.
7) Items picked show all items picked by each player grouped in Health&Armor, Weapons,Ammos, and Special Item (Quad Damage, Regen,Invisibility and so on.)

B) When you choose Player List a table like this appears:



Clicking on a single player bring you in his personal stats page showing:
1) The player ranking for all games including FFA, Tournament, Team Deathmatch and CTF.
2) Weapons specifics showing the way the player made his frags, kills, deaths, suicides, team kills.
3) Items picked in all games played by the player.

C) When you choose High & Low Scores a page with two big tables appears showing for each of WTW score definitions (see above)
and stats, players that totalized a particular high & low score.

D) When you choose Ranking a page appears showing three tables yet discussed above:
1) Frags Ranking (who make more frags and other stats)
2) Delta Frags (how much frags to exceed the first player in frags ranking classific)
3) Winner Ranking (who wins more matches)

E) When you choose Map List a table like this appears:



It shows all the maps played on your server and the times the map was played.
Clicking on a single map link bring you in a page showing all ranking for each players that played this map.

F) When you choose Icons help bring you in a page showing all the icons used by WTW.

G) When you choose Main Help bring you to this page.

Using generated stats.

When you have processed a log you'll see in the WTW installation directory a file index.html, the start page to view WTW stats, a directory wtwlogs,
a directory containing HTML pages and graph game images. You can share the WTW installation directory with other players using Windows sharing
mode allowing all players to see personal stats in their computer using an HTML browser.
If you decide to public WTW stats on Internet on your site you must copy index.html, wtwlogs, and wtwimages in the same directory level and simply
make a link to index.html in your page.

Bugs.


Even WTW is been tested, some logs can reveal an hidden bug.
If so, WTW got stuck (i.e. the progress indicator show the same percentual number for a long time or the HD led is off etc.).
If this happen, click on the X button on the top right side of the titlebar to kill WTW.
Rename wtw.pyw to wtw.py and restart WTW. You'll see a Python console window and the gui opening togheter.
Restart WTW with the log caused the trouble. When WTW got stuck again some messages will be showned on the console
window. Cut & Paste all messages and send to me via email in a text file with the log in a zip file
so I can discover the problem.
Thanks.

Giampaolo "RainCloud" Russo.