itseStats v1.0 (c)itse_Murhaaja

About itseStats

itseStats is a serverside mutator that counts player statistics and sends them to a stats server after the match. Player statistics can be seen at http://stats.itseclan.com

Clean installation

copy itseStats.u, itseStats.int and itseStats.ini to your ut/System directory
Setup the itseStats.ini as descipted in ini section.
add itseStats.itseStats to your sfservers startup script (or where ever mutators are added)
- eg. UCC.exe server SFTDM-map.unr?game=SFGame.SFTeamDM?mutator=itseStats.itseStats,SFMapVote.SFMapVote,...
- OR add itseStats as serveractor by adding ServerActors=itseStats.itseActor line to [Engine.GameEngine] section.
(Re)start SF-Server

Updating from 0.6 or later

copy itseStats.u, itseStats.int to your ut/System directory
restart SF-Server

Notes

This is a serverside mutator. It is not sent to clients, and clients should not/need not install it by themselves
stats.itseclan.com does not accept statistics before your server is approved (checked that it's real server).

Typical setup for itseStats.ini

If you are updating from previous version, set the serverID to the same as it was.
If your server is behind firewall, you can set the queryPort1 & queryPort2 to ports that are allowed to send data to stats.itseclan.com at port 80. QueryPort1 & 2 are not exact ports that are used for sending. If you choose port 50000 and that is not available when the statistics are goint to be sent, then 50001 is used and so going on.

[itseStats.itseStats]

Option Default value optional Info

debugMode False no When true, itseStats' serverlog messages are also broadcasted for all players.

statsWhenPW False no When false, Game Stats are not sent to stats when server gamepassword is used.

scoreCorWhenPW False no When false, ScoreCorrection is not used when gamepassword is in use

scoreCorrection false no When true, Players scores and medals are kept even if he/she reconnects and/or changes team. (This affects only scoreboard that can be seen after rounds. Scores are ALWAYS kept during reconnect for statistics)

itseSend True no When True, Game stats are sent to stats server at itseURL.

localSend False no When true, Game stats are also sent to other server

itseURL stats.itseclan.com no URL of Statistics server

itseIP yes IP of statistics server (ip of stats.itseclan.com). Use only if name resolvation doesn't work.

itsePort 0 no Port of statistics server. If 0, default port 80 is used or port number that is given in itseURL.

localURL yes URL of secondary (clan's own) Statistics server

localIP yes IP of optional (clan's own) statistics server.

localPort 0 no Port of optional statistics server. If 0, default port 80 is used or port number that is given in itseURL.

sendIPs True no When true, player ip:s are sent to stats server

minPlayersForRound 2 no Minimum number of human players that must be playing for the round to get counted. Please do not set this less than 2. Stats server does not accept rounds with less than 2 human players.

minRoundsForMatch 3 no Minimum number of counted rounds that must be for the match to get counted. Please do not set this less than 3. Stats server does not accept matches with less than 3 rounds.

statMessage See player stats at http://stats.itseclan.com yes Message that is sent to all players when match ends.

serverID yes id that is used to recognise the server. itseStats server gives new automatically new one if this is empy

queryPort1 0 no local port that is used when statistics are sent to itseURL. If 0, then OS chooses next free port.

queryPort2 0 no local port that is used when statistics are sent to localURL. If 0, then OS chooses next free port.

doPlayerLog False no When true, itseStats logs player IPs to Log/isYYMMDD-HHMM.log files

mutate commands

mutate itseInfo

Shows version number of itseStats and some settings, must be logged as admin.

Changes from 0.99(a) -> 1.00

doPlayerLog option in ini
itsePort & localPort
Works now with webservers that run port other than 80, address routing (http header, 301) implemented.

Changes from 0.9 -> 0.99

ServerName and ServerURL fields in itseStats.ini are not used anymore
serverID doesn't have to be set anymore, if left empty itseStats server gives new one.
mutate itseStats and mutate itseTest commands can not be used anymore.
itseStats can be loaded as serveractor.

Option	Default value	optional	Info
debugMode	False	no	When true, itseStats' serverlog messages are also broadcasted for all players.
statsWhenPW	False	no	When false, Game Stats are not sent to stats when server gamepassword is used.
scoreCorWhenPW	False	no	When false, ScoreCorrection is not used when gamepassword is in use
scoreCorrection	false	no	When true, Players scores and medals are kept even if he/she reconnects and/or changes team. (This affects only scoreboard that can be seen after rounds. Scores are ALWAYS kept during reconnect for statistics)
itseSend	True	no	When True, Game stats are sent to stats server at itseURL.
localSend	False	no	When true, Game stats are also sent to other server
itseURL	stats.itseclan.com	no	URL of Statistics server
itseIP		yes	IP of statistics server (ip of stats.itseclan.com). Use only if name resolvation doesn't work.
itsePort	0	no	Port of statistics server. If 0, default port 80 is used or port number that is given in itseURL.
localURL		yes	URL of secondary (clan's own) Statistics server
localIP		yes	IP of optional (clan's own) statistics server.
localPort	0	no	Port of optional statistics server. If 0, default port 80 is used or port number that is given in itseURL.
sendIPs	True	no	When true, player ip:s are sent to stats server
minPlayersForRound	2	no	Minimum number of human players that must be playing for the round to get counted. Please do not set this less than 2. Stats server does not accept rounds with less than 2 human players.
minRoundsForMatch	3	no	Minimum number of counted rounds that must be for the match to get counted. Please do not set this less than 3. Stats server does not accept matches with less than 3 rounds.
statMessage	See player stats at http://stats.itseclan.com	yes	Message that is sent to all players when match ends.
serverID		yes	id that is used to recognise the server. itseStats server gives new automatically new one if this is empy
queryPort1	0	no	local port that is used when statistics are sent to itseURL. If 0, then OS chooses next free port.
queryPort2	0	no	local port that is used when statistics are sent to localURL. If 0, then OS chooses next free port.
doPlayerLog	False	no	When true, itseStats logs player IPs to Log/isYYMMDD-HHMM.log files