Annotation of /t2matchlog/README

Tribes 2 Match Log
________________________________________________________________________________

There are two parts to t2matchlog:

+ logpositiondata.cs is installed on a Tribes 2 server and stores information on
  each game to a file

+ t2matchlog is a Perl script which processes these files and produces HTML
  pages with graphics showing the game
________________________________________________________________________________

Installing logpositiondata.cs

    Place logpositiondata.cs in tribes2/base/scripts/autoexec and restart the
    server (under linux, this can be placed in .loki/tribes2 in the home
    directory of the user which runs the server).

    Each game will produce a log file in tribes2/base/positiondata. An example
    file name is 1_CTF_Sanctuary_3. The first number is the game number since
    the server was restarted, and the last number is to prevent naming conflicts
    (files will never be overwritten).

    Log files can be large (over 1MB for a typical game), so you may want to
    grab the ones you want and delete the rest regularly. They compress well.
________________________________________________________________________________

Processing logs using t2matchlog

    t2matchlog should run on any machine with Perl and the Perl GD module. Place
    the icons directory and t2matchlog.css in the same directory as t2matchlog.

    The script takes two parameters: the filename of a log file, and a name for
    the output directory. For example:

      perl t2matchlog 1_CTF_Sanctuary_3 sanctuary

    will process the log 1_CTF_Sanctuary_3 and create the directory sanctuary
    with the output.

    The output can then be viewed in a browser or placed on a www server.
________________________________________________________________________________


1	james	39	Tribes 2 Match Log
2			________________________________________________________________________________
3
4			There are two parts to t2matchlog:
5
6			+ logpositiondata.cs is installed on a Tribes 2 server and stores information on
7			each game to a file
8
9			+ t2matchlog is a Perl script which processes these files and produces HTML
10			pages with graphics showing the game
11			________________________________________________________________________________
12
13			Installing logpositiondata.cs
14
15			Place logpositiondata.cs in tribes2/base/scripts/autoexec and restart the
16			server (under linux, this can be placed in .loki/tribes2 in the home
17			directory of the user which runs the server).
18
19			Each game will produce a log file in tribes2/base/positiondata. An example
20			file name is 1_CTF_Sanctuary_3. The first number is the game number since
21			the server was restarted, and the last number is to prevent naming conflicts
22			(files will never be overwritten).
23
24			Log files can be large (over 1MB for a typical game), so you may want to
25			grab the ones you want and delete the rest regularly. They compress well.
26			________________________________________________________________________________
27
28			Processing logs using t2matchlog
29
30			t2matchlog should run on any machine with Perl and the Perl GD module. Place
31			the icons directory and t2matchlog.css in the same directory as t2matchlog.
32
33			The script takes two parameters: the filename of a log file, and a name for
34			the output directory. For example:
35
36			perl t2matchlog 1_CTF_Sanctuary_3 sanctuary
37
38			will process the log 1_CTF_Sanctuary_3 and create the directory sanctuary
39			with the output.
40
41			The output can then be viewed in a browser or placed on a www server.
42			________________________________________________________________________________
43
44