NOP v1.1

NOP v1.1

NOP's a tiny tool to generate ranking-tables out of logfiles written

by q3test server logfiles (not client logfiles!).

---------------------------------------------------------

NOP v1.1, 30jul99

written by denis moeller, [email protected], www.dead-calm.net

---------------------------------------------------------

NOTE:

As far as I know, id will totally change the logfile in the near future,

this simply means that NOP will probably not run with a newer version

of Q3Test. I'll do my best to update NOP as soon as it is needed.

What is NOP?

NOP's a tiny tool to generate ranking-tables out of logfiles written

by q3test server logfiles (not client logfiles!). See above website

for example rankings.

Features?!

- reads log-files of any size

- generates ranking tables by calculating 'points' for every player

- saves the player information seperately, unlimited number of players

- reads a template-html file to generate the ranking tables

- you can change the table design via style-sheets

- uses a ban-list to avoid ranking of certain players

- strips color-codes from playernames and converts q3test's special

characters to ascii-characters

- you control the number of lines per page and the overall number

of users in the list

- re-run feature: e.g. let NOP update rankings every 20 minutes

Changes in version 1.1

- fixed 2 name bugs, which caused NOP to crash

- changed calculating of points, much better now

- added to new arguments: -mintime and -mingames, see "rank.bat"

- fixed the zero bug (doh)

- added overall display: Games, Players, Fraghits and Timehits

- added columns Ping and Games/Won

How the f?

if you are the guy running a q3test server, you just activate the

server logging of your server either in the console or a cfg-file

which is being loaded at startup. "set logfile 1" activates the

logfile. whenever a game ends, either by timelimit or fraglimit,

q3test appends the scores to a file called "games.log".

NOP then reads this log-file and generates the rankings. NOP saves

the player-information in a seperate database and clears the logfile

of the server.

here's a simple example of how to use NOP with your q3test-server:

1. unzip the NOP-archive anywhere you like

2. run the server with logfile set to 1

3. open a dos-box, change to the NOP-directory and run NOP:

NOP c:\q3test\baseq3\games.log htmlout/rank -time 20

in this example the first parameter is the path and name of the

server-logfile, the second is the html-output-path and name of

the html-file(s) that are generated. that means, NOP will write

rank0.html, rank1.html ... rankx.html to the path "htmlout/".

(which would possibly be the path of your webpage)

the last parameter "-time 20" makes NOP to re-run every 20 min,

doing the same thing over and over again: reading its player

database, reading the log-file, calculating the new scores and

updating the html-files.

i've made a file rank.bat for easier use of NOP. edit this file

to change path/options and run it instead of typing the above

line. see "rank.bat" for details.

[of course you can run NOP without any parameters. NOP will then

search for a file called "games.log" in the same directory and

write rankings to files "rankX.html" to the same directory.

this way you could copy all files coming with NOP into your

q3test/baseq3 directory and run it there...]

Banning certain players...

NOP uses a file called "banned.txt" to avoid certain players

from being ranked. each line of this file contains only one

name. you may add up to 100 banned names, but be careful:

NOP searches usernames via substrings and case-insensitive.

e.g. adding the name "ass" to the file, kills all names

containing the phrase: "asshole", "massive" and "MaSsIvE".

Editing the html template

the file t_rank.html is the html-template for the ranking

tables. it must be in the same directory as NOP itself.

you may want to change the colors of the tables by editing

the style-sheets - see the template file for details.

you may also add as much html-stuff as you like, e.g. info

about your server, webpage, name, links... do whatever you

want, but remember:

- do not delete the style-sheet part, it'll probably still

work, but don't look too good

- the ranking tables will be placed at the position of

this tag: "<--STATS-->" - so do not remove it!

A deeper view...

[Note: this has changed in version 1.1, let me know if you

need to know how the points are calculated]

Points is a value calculated by using the following values:

- Won games

- Number of players

- Percentage of frags of the game

- Frags per hour

- Avrg. Ping / Playerping

Future, ideas, bugs?

i'm not running a server, but NOP was tested with local files

which 'look' real. i've also tried NOP with a list of about

10000 players and it all worked great. the number of players

is limited by your system memory only.

Bugs:

please report any bug you're encountering, attach the files

that cause the bug (logfiles, NOP.dat etc.) if possible.

thank you.

Ideas:

- maybe add sorting by Frags, FPH, Time etc. not just Points

- more options (minimum Games for a player to appear in the

list?, minimum Time? would that make sense?)

- a cfg-file for the options, instead of typing a bunch of

parameters?!?

if you've got NOP running with your server, please let me know.

if you've got any ideas for NOP, let me know as well.

if you're able to make NOP compile for use under Linux -

LET ME KNOW!!!

EOF, 31jul99, [email protected], www.dead-calm.net