Added logging support for rune match; logging is now called "event log".
[divverent/nexuiz.git] / Docs / eventlog.txt
1 cvars:
2 ______________
3
4    sv_eventlog                    master switch (default: 0)
5    sv_eventlog_files              print frags, scores and captures for separate files each match (default: 0)
6    sv_eventlog_console            print frags, scores and captures to serverconsole during the match (default: 1)
7    sv_logscores_bots              choose whether bot are included in stats or not (default: 0)
8                                 
9    sv_eventlog_files_counter      number of matches logged until now
10    sv_eventlog_files_nameprefix   file name prefix to be used (default: nexuiz)
11    sv_eventlog_files_namesuffix   file name extension to be used (default: .log)
12
13 log format:
14 ______________
15
16    :gamestart:<gametype>_<mapname>:<matchid>
17    :join:<ID>:<nickname>
18    :part:<ID>
19    :team:<ID>:<team>
20    :kill:frag:<ID of killer>:<ID of victim>:type=<death type>:items=<itemstring of killer>:victimitems=<itemstring of victim>
21    :kill:tk:<ID of killer>:<ID of victim>:type=<death type>:items=<itemstring of killer>:victimitems=<itemstring of victim>
22    :kill:suicide:<ID>:<ID>:type=<death type>:items=<itemstring>
23    :kill:accident:<ID>:<ID>:type=<death type>:items=<itemstring>
24    :ctf:steal:<flagcolor>:<ID of attacker>
25    :ctf:dropped:<flagcolor>:<ID of dropper>
26    :ctf:pickup:<flagcolor>:<ID of attacker>
27    :ctf:capture:<flagcolor>:<ID of attacker>
28    :ctf:return:<flagcolor>:<ID of defender>
29    :ctf:returned:<flagcolor>
30    :dom:taken:<previouscolor>:<ID of player>
31    :scores:<gametype>_<mapname>:<map runtime>
32    :player:<frags>:<deaths>:<playtime>:<team>:<ID>:<nickname>
33    :end
34    :gameover
35
36    Note that only the :join and :player lines ever contain player names.
37
38 team colors:
39     1 = No Team (Domination)
40     5 = Red Team
41    14 = Blue Team
42    10 = Pink Team
43    13 = Yellow Team
44
45 itemstring:
46    <weaponid><flags>
47    or
48    <weaponid><flags>|<runes>
49
50    where flags can contain:
51          F = player carries the flag
52          S = player has strength
53          I = player has the shield
54    
55    and weapon IDs are:
56          1 = Shotgun
57          2 = Uzi
58          4 = Mortar
59          8 = Electro
60         16 = Crylink
61         32 = Nex
62         64 = Hagar
63        128 = Rocket Launcher
64       4096 = Laser
65
66    runes/curses are stored as a bit mask with the following values:
67          1 = Strength
68          2 = Defense
69          4 = Regeneration
70          8 = Speed
71         16 = Vampire
72       8192 = Weakness
73      16384 = Vulnerability
74      32768 = Venom
75      65536 = Slow
76     131072 = Empathy
77
78 death type:
79    either a weapon ID (see above), or one of:
80      10000 = fallen to death
81      10001 = telefragged
82      10002 = drowned
83      10003 = killed by a trap / fallen into the void
84      10004 = lava
85      10005 = slime
86      10006 = console kill
87      10007 = (MinstaGib) out of ammo
88      10008 = swamp
89      10009 = team change
90      10010 = auto team change
91      10011 = camping protection
92
93 There will be a log analyzer parsing this file format soon. Note that weapon
94 IDs are below 10000.