Event-logging.md

   1 ## CVars (see xonotic.org/tools/cacs for more up-to-date information)
   2
   3 * `sv_eventlog`: master switch
   4 * `sv_eventlog_files`: print frags, scores and captures for separate files each match
   5 * `sv_eventlog_console`: print frags, scores and captures to serverconsole during the match
   6 * `sv_logscores_bots`: choose whether bot are included in stats or not
   7 * `sv_eventlog_files_counter`: number of matches logged until now
   8 * `sv_eventlog_files_nameprefix`: file name prefix to be used
   9 * `sv_eventlog_files_namesuffix`: file name extension to be used
  10 * `sv_eventlog_files_timestamps`: prefix log lines in the files with time events
  11 * `sv_eventlog_ipv6_delimiter`: change : in IPv6 addresses to _
  12
  13 ## Log format
  14 ```
  15 :logversion:3
  16 :gamestart:<gametype>_<mapname>:<matchid>
  17 :gameinfo:mutators:LIST:mutator1:mutator2:...
  18 ```
  19 (note that mutators are listed by their cvar name with g_ removed, unless such a cvar is 1 by default - then the mutator is listed with a no_ prefix if the cvar is 0)
  20 ```
  21 :gameinfo:end
  22 :join:<ID>:<slot>:<ip>:<nickname>
  23 :join:<ID>:<slot>:bot:<nickname>
  24 :name:<ID>:<nickname>
  25 :part:<ID>
  26 :team:<ID>:<team>:<jointype>
  27 :kill:frag:<ID of killer>:<ID of victim>:type=<death type>:items=<itemstring of killer>:victimitems=<itemstring of victim>
  28 :kill:tk:<ID of killer>:<ID of victim>:type=<death type>:items=<itemstring of killer>:victimitems=<itemstring of victim>
  29 :kill:suicide:<ID>:<ID>:type=<death type>:items=<itemstring>
  30 :kill:accident:<ID>:<ID>:type=<death type>:items=<itemstring>
  31 :ctf:steal:<flagcolor>:<ID of attacker>
  32 :ctf:dropped:<flagcolor>:<ID of dropper>
  33 :ctf:pickup:<flagcolor>:<ID of attacker>
  34 :ctf:capture:<flagcolor>:<ID of attacker>
  35 :ctf:return:<flagcolor>:<ID of defender>
  36 :ctf:returned:<flagcolor>
  37 :dom:taken:<previouscolor>:<ID of player>
  38 :keyhunt:capture:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  39 :keyhunt:carrierfrag:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  40 :keyhunt:collect:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  41 :keyhunt:destroyed:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  42 :keyhunt:destroyed_holdingkey:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  43 :keyhunt:dropkey:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  44 :keyhunt:losekey:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  45 :keyhunt:push:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  46 :keyhunt:pushed:<ID of player>:<points for player>:<ID of key owner>:<points for key owner>:<name of key>
  47 :scores:<gametype>_<mapname>:<map runtime>
  48 :labels:player:<head1><flags>,<head2><flags>,...
  49 :player:see-labels:<score1>,<score2>,...:<playtime>:<team>:<ID>:<nickname>
  50 :player:see-labels:<score1>,<score2>,...:<playtime>:spectator:<ID>:<nickname>
  51 :labels:teamscores:<head1><flags>,<head2><flags>,...
  52 :teamscores:see-labels:<score1>,<score2>,...:<team>
  53 :end
  54 :restart
  55 :gameover
  56 :vote:suggested:<mapname>:<playerid>
  57 :vote:keeptwo:<mapname>:<mapvotes>:<mapname>:<mapvotes>:::<mapname>:<mapvotes>:...:didn't vote:<notvoters>
  58 :vote:finished:<mapname>:<mapvotes>:::<mapname>:<mapvotes>:<mapname>:<mapvotes>:...:didn't vote:<notvoters>
  59 :vote:suggestion_accepted:<mapname>
  60 :vote:vcall:<ID of player>:<vote command display string>
  61 :vote:vyes:<yescount>:<nocount>:<abstaincount>:<notvoters>:<mincount>
  62 :vote:vno:<yescount>:<nocount>:<abstaincount>:<notvoters>:<mincount>
  63 :vote:vtimeout:<yescount>:<nocount>:<abstaincount>:<notvoters>:<mincount>
  64 :vote:vstop:<ID of stopper>
  65 :vote:vlogin:<ID of player>
  66 :vote:vdo:<ID of player>:<do command display string>
  67 :time:<YYYY-MM-DD HH:MM:SS>
  68 :recordset:<ID of player>:<time in seconds>
  69 ```
  70 Note that only the :join and :player lines ever contain player names. The :time event only appears in the log files if sv_eventlog_files_timestamps is 1; there is no way to log these time stamps to the console (for console timestamps, set timestamps to 1).
  71
  72 ### Team colors
  73 * 1 = No Team (Domination)
  74 * 5 = Red Team
  75 * 14 = Blue Team
  76 * 13 = Yellow Team
  77 * 10 = Pink Team
  78
  79 ### Join types
  80 * 1 = connect
  81 * 2 = auto
  82 * 3 = manual
  83 * 4 = spectating
  84 * 6 = adminmove
  85
  86 ### Label flags
  87 * !! = primary sorting key
  88 * <!! = primary sorting key, lower is better
  89 * ! = secondary sorting key
  90 * <! = secondary sorting key, lower is better
  91 * < = lower is better
  92
  93 ### Item string
  94 `<weaponid><flags>` or `<weaponid><flags>|<buffs>`
  95
  96 where flags can contain:
  97 * F = player carries the flag
  98 * S = player has strength
  99 * I = player has the shield
 100 * T = player is typing (console, menu or chat)
 101
 102 and weapon IDs are:
 103 * 1 = Blaster
 104 * 2 = Shotgun
 105 * 3 = Machine Gun
 106 * 4 = Mortar
 107 * 5 = Electro
 108 * 6 = Crylink
 109 * 7 = Vortex
 110 * 8 = Hagar
 111 * 9 = Rocket Launcher
 112 * 10 = Port-O-Launch
 113 * 11 = Vaporizer
 114 * 12 = Grappling Hook
 115 * 13 = Heavy Laser Assault Cannon
 116 * 14 = T.A.G. Seeker
 117
 118 Weapon IDs are below 10000.
 119
 120 ### Death type
 121 either a weapon ID ORed with weapon death flags, or one of the notifications in common/deathtypes.qh in the form of a string.
 122
 123 weapon death flags are:
 124 * 256 = secondary fire
 125 * 512 = splash damage
 126 * 1024 = bounced projectile
 127 * 2048 = head shot (Vaporizer only)
 128 * 4096 = unused flag
 129
 130 There will be a log analyzer parsing this file format soon.