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
|
|
||||||||
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.