Advanced Chat Log System
FOR : UT 436-440-451 Windows/Linux >DEDICATED< Servers
Version 2.20 - August, 2006
Created By MSuLL
WebSite: http://www.atomicunreal.com/msull/



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.

THIS CHAT LOGGER IS FOR UT (UNREAL TOURNAMENT 1999 / GOTY)
ONLY.  IT DOES NOT WORK WITH UT2003, UT2004, or, UT2007!




About:
*********

This is a new mod I created for UT servers that allows
for in-game chat to be logged to external log files.
Unlike WebChatLogger, this logger works on BOTH Windows
and Linux UT servers.  It can log to raw .log files, OR it
can also create web pages for easy viewing.

This mod will log joins (and the new player's IP address,
if desired), chat (say and teamsay) and system
events (including adminlogins, ASC actions,
UTDC kicks, etc etc).  Optionally, it can also log localized
messages such as kills and team switches.  It also keeps
track of players on the server and will log name switches.


The Advanced Chat Log System is a server-side actor, meaning
two things:

1.) The clients (players) of your server will not have to
download anything.  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:
ACLSv220.u


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=ACLSv220.ChatLogger

(DO NOT ADD ACLSv220 INTO THE SERVERPACKAGES!!)
Save / Close


If you run ONE server from your /SYSTEM folder (for most admins):
-------------------------------------------------
Open ACLSv220.ini and change any values you desire (their
functions are found in the next section).  Upload it to your
server as well.

Start your server up, and enjoy!



If you run MULTIPLE servers from your /SYSTEM folder:
-------------------------------------------------
Open your server's INI file and add the following two sections
to it:

[ACLSv220.ChatLogger]
bUseSystemIni=True

[ACLSv220.CLConfigUT]
bDisabled=False
bHTMLMode=False
bLogIPAddress=False
bLogTeamSayMessages=True
bLogLocalizedMessages=False
bMsgSpecMode=False
bOutputToServerLog=True
bDisableIPDetect=False
LogTo=../Logs
LogFileHeading=[ChatLog]
bIncludeName=False
bIncludeMap=True
BodyBackGroundColor=#AAAAAA
TableBackGroundColor=#BBBBBB
TextColor=#000000
HeaderBackGroundColor=#666666
HeaderTextColor=#FFFFFF
FontSize=12

Change any values you desire in the [ACLSv220.CLConfigUT]
section (their functions are found in the next section).
Do not change the bUseSystemIni choice!
Save your changes.

Start your server up, and enjoy!





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

bDisabled=
To disable logging, set this to True.

bHTMLMode=
Set True for HTML Mode (HTML-Based Logs).
False will default to plain-text logs.

bLogIPAddress=
Log a player's IP address on join? (Note that if the public will
see these logs, you should leave this False!)

bLogTeamSayMessages=
Log TeamSay messages during matches?

bLogLocalizedMessages=
Log Localized Messages?  (Localized Messages are death messages
and other special types of messages (suicides, kills, sprees, etc).

bMsgSpecMode=
Act as a Messaging Spectator?
(special broadcasts from mods like CSHP, Pure, and EUT)
NOTE: By enabling this, you risk having another mod send a player's
IP address for logging, so be careful if you share your logs publically!

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

bDisableIPDetect=
Disable automatic detection of the server's IP address and port.

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

LogFileHeading=
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.

bIncludeName=
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=
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
+

BodyBackGroundColor=
Web page background color.
(Only works with HTML Mode enabled)

TableBackGroundColor=
Web page table background color.
(Only works with HTML Mode enabled)

TextColor=
Web page text color.
(Only works with HTML Mode enabled)

HeaderBackGroundColor=
Web page header background color.
(Only works with HTML Mode enabled)

HeaderTextColor=
Web page header text color.
(Only works with HTML Mode enabled)

FontSize=
Web page font size.
(Only works with HTML Mode enabled)




Changelog:
*************
----------------
| Version 2.20 |
----------------
- [Added] Messaging Spectator ability
- [Added] Server IP detection
- [Fixed] Misc. small bugs



----------------
| Version 2.10 |
----------------
- [Added] HTML Mode
- [Added] Name change tracking
- [Added] IP display on join


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






+-------------+
|  Thanks To  |
+-------------+
- |KOA|The_Dave: For servers to test on, a website,
and a lot of support for all this time!

- Azazel: For the hosting of UnrealAdmin.org,
which is my little base of operations.

- BDB (Bruce Bickar): This mod was inspired by your
work.  Many thanks for all that you've done for
the UT community - we appreciate it.






----------------
| MSuLL - 2006 |
----------------