********************************
Lin/Win Server Chat Logging
Version 1.02

Created by MSuLL - Dec, 2005
********************************

Requirements -
Windows or Linux >DEDICATED< UT Server



Information:
***************

Take the time to read through this file, and it will save you and I both a lot of time.




About:
*********

This is a new mod I created for UT servers that allows for chat to be logged to external log files.  While this may not sound special, this is the only chat logger that works on Linux servers that could write external logs (to my knowledge).  Feel free to use it on Linux or Windows servers, it works perfectly fine on either one.

This mod will log both chat (say and teamsay) and system events (including joins, exits, adminlogins, ASC actions, UTDC kicks, etc etc)

Lin-Win Chat Logging is a server-side actor, meaning two things:

1.) The clients (players) of your server will not have to download anything special.  All logging is done server-side.

2.) Since it is an actor, as long as you add the appropriate line into the server's INI file, this mod will start logging automatically at every game, without any special command-line options.




Installation:
****************
Upload to your server:
Lin-WinChatLogger-V102.u

Open LinWinChatLogger.ini and change any values you desire (their functions are found in the next section).
Upload it to your server as well.



Shut down your server and open your server's INI (usually UNREALTOURNAMENT.INI or SERVER.INI).

Find the section for [Engine.GameEngine]




Add the following line into the SERVERACTORS area:

ServerActors=Lin-WinChatLogger-V102.ChatLogger

(DO NOT ADD Lin-WinChatLogger INTO THE SERVERPACKAGES AREA - IT IS ONLY SERVER-SIDE)



Start your server up, and enjoy!






INI Settings:
****************

Defaults are:

[Lin-WinChatLogger-V100.SaveLog]
LogTo=../Logs
LogFileHeading=[ChatLog]
LogFileExtension=.log
bIncludeName=False
bIncludeMap=True
bLogLocalizedMessages=True;
bOutputToServerLog=True;




INI Settings Explained:
**************************

LogTo=
Path to where you want the logs saved to.  DO NOT ADD A TRAILING SLASH! ( None of this:  ../Logs/ )




LogFileHeading=[ChatLog]
Logs will be saved with a tag at the front to identify them as chat logs.  If you wish to change this tag, or remove it entirely, you should change this value.




LogFileExtension=.log
Extention to put on all log files.
.log should be fine for most people, though if you prefer, you can change this to another value (such as .txt).




bIncludeName=True
This adds/removes the server's name from your log's filename.

Example:

bIncludeName=True
[ChatLog] -- MSULL'S UTSERVER --.2005.07.30.23.28.25.log

bIncludeName=False
[ChatLog] 2005.07.30.23.28.25.log




bIncludeMap=True
This adds/removes the map's name from your log's filename.

Example:

bIncludeMap=True
[ChatLog].2005.11.23.20.37.05 CTF-TheChain.log

bIncludeMap=False
[ChatLog] 2005.11.23.20.37.05.log




bLogLocalizedMessages=True
This enables/disables logging of Localized Messages. Localized messages are death messages and other types of messages that come from the server (suicides, kills, sprees, etc etc).




bOutputToServerLog=True
This enables having chat output to external logs, AND ALSO your server's log file.





Changelog:
*************
---------------
| Version 1.02 |
---------------
- Public Release

[Added] Now logs TeamSay messages
[Added] Option to include the map name in the log filename
[Added] Option to log localized messages
[Added] Option to output to server's log

[Changed] Logfiles are only created if they are about to be written to; prevents 0 file size

[Removed] No longer will automatically log to the server's logfile
[Removed] The [ChatLog] tag will no longer appear on every line of logging

[Fixed] Logs not closing correctly
[Fixed] 'Accessed None' errors occured when a player used a voice pack sound




---------------
| Version 1.00 |
---------------
- Public Release

[Added] Support for custom configurations in an INI




---------------
| Version 0.70 |
---------------
- Initial Relase (Private Beta)

[Fixed] Most of the logging






----------------
| MSuLL - 2005 |
----------------