Using autogame's channel/chat logging

Autogame will log your channel/chat if you select the log consoles checkbox. This need be done only once as autogame remembers its settings. When autogame is extracted it creates a folder called autogamelogs within the folder its extracted to (needs to be in the blitzin folder that is running autogame to make it save here otherwise it saves to the blitzin folder) and it will save all logs in this folder.

Also autogame will minimize to the system tray so once you minimize it, it will be out of the way. Autogame comes with a file called autogamelog.ini that determines what will be logged. Each line in the file is a different thing you want logged and you hit enter after every line ( including the last ) and you make the last line in teh file the $ symbol. If you forget to use the $ symbol to terminate the file then autogame may miss what you put on the last line.

Currently autogame will not be able to log chat during a rated game due to limitations plugins have under blitzin. Other autogame features like sending gamestart and gameend aliass will work if you turn them on. I have applied for the ablity to have autogame work in a rated game but no word back yet.

The default autogamelog.ini looks like this:

channels
shouts
tells
master
$

channels means log every channel that your in to autogam1207-channels.txt. ( autogame changes teh file names each month so no file gets to big by including the month and year in the file name).

shouts means log all shouts to autogam1207-shouts.txt.

When you first get a communication logged to a file during a login session, say the shouts file, autogame will timestamp it with the date and time before the communication is logged, If you get another communication and perhaps another and at least 15 minutes has gone by without a timestamp it will be timestamped again. If there is no activity autogame will not timestamp a file tell a new communication has arrived and 15 minutes has gone by since the last one. Any communication that arrives after its been 15 minutes since the last timestamp will have the date and time logged to the file before the new communication is logged.

tells means log all tells and says to autogam1207-tells.txt.

master means in addition to logging all shouts, kibs/whispers, tells, and channels to their respective files also log everything to autogam1207-master.txt. You dont have to have an option turned on to have it go to master. For example sshouts and kibs are not in the default ini file however master will still grab everything. SShouts are only logged to the master file and not logged to any more specific files. Same is true for announcements. You could just have an autogamelog.ini file that looks like this:

master
$

And autogame will log everything to the autogam1207-master.txt file and create only one file.

For a complete log its enough to have the master argument but the idea is to give you seperate logs for different things as well for an easier time finding stuff or reading the logs. However you can delete any of those lines from the autogamelog.ini file and save the new copy and it will stop logging that particular thing. For example if your not listening to shouts then delete the shouts line.

More options

In addition to the above options you can also choose to have a file for kibs/whispers. just add the line kibs to the autogamelog.ini file.

In addition to the channels argument you can also put a specific channel on a line in the autogamelog.ini file, and it will log that specific channel to a file. For example this month ( its December 2007 as i write this ) it would log 103 to autogam1207-103.txt.

You can put several channels on a line seperated by a space for example:

23 27 28

And autogame will create a file called autogam1207-23-27-28.txt and log all 3 channels to this file. Specifying a channel or several channels should go to a file does not mean, if you have the channels argument, that the channel chat wont also be saved to the channels log file and also the master log file as well. It will. You will have redundent copies of the channel chat. For example if you have in your ini file:

master
channels
103
$

103 will be logged to all 3 files. channels will also include all other channels, and master will have all text autogame is capable of logging.

If you just wanted to log one channel and nothing else its possible to delete what is in the ini file and just put that channel, say 103, on a line followed by $ on the last line and you will only log 103.

103
$

The master file will always have all shouts/sshouts/announcements/channels/says/tells/kibs and whispers. Other text do to the the nature of how datagrams work in plugins is mostly logged, like you will see the text that comes at login but some things for example in testing the result of typing who is not logged. Help files that display in the console are logged to the master file. On a final note a good deal of non channel chat text will show up in master but at this time not everything that is not channel/chat text.

names option

the names option is an idea I got from the internet relay chat client, Mirc. Every time you have a conversation with someone via their equivalent of personal tells, if you are logging in mirc it creates a file with their name saving just that conversation and not all conversations with different people in one file, like the tells option will do. If they talk to you again on a later session rather than creating a new file it just appends the conversation to the same name file. So if your freind sends you some tells the day you start logging and then over the next few weeks you have some more conversations, all the tells will be saved in a file with their name.

Here is how it works in autogame. if you put names in the autogamelog.ini file, every time you get or send a ptell to a new person, it creates a file, lets say potzy sent you a tell, like autogamelog-potzy.txt. This will only work for ptells and not says. If they send you more tells at a later time it will append to the file once it exists. Unlike the other file names the date is not included in the filename. This is because these files tend to be smaller and it will give you continuity of having for example one potzy file from month to month.

A sample auotgamelog.ini file with the names argument could look like this:

channels
shouts
tells
master
names
$

The names files are timestamped like other files When you first get a tell its timestamped with the date and time and each time you get another tell and at least 15 minutes has past since the last timestamp, it will timestamp the file again. If you get no more tells then no more timestamps.

final notes

Note: All file names change each month as the month and year is included in the filename. In January your channels file ( if you have one ) will become autogam0108-channels.txt. If your logged on just before the month changes, autogame will continue to use the 1207 date in files ( or whatever month it is) until your first login when the month changes as autogame only checks the date for file names at startup.

Note on timestamp: A timestamp (date and time) will appear before the first communication that arrives for each file after you log in. A file wont be timestamped during a login session unless a communication arrives. All the communications after the last timestamp in a file will always have occured within 15 minutes of that last timestamp. If a communication was to arrive greater than 15 minutes than the last timestamp, a new timestamp would be made before logging the next communication to the file.

Final note: In all my testing autogame needs its ini file to be in the blitzin folder so its recommended you extract the zip file with autogame and its default autogamelog.ini file to the blitzin folder. Autogame will create a folder in the folder its extracted in called autogamelogs to save log files to. For download and installation instructions see the link at the top of this page.

And finally

To give you an example of what you can do, this is the autogamelog.ini file i am using at the moment:

channels
ShOutS
kibs
1 2
27 28
43
103
97
250
107
master
tells
names
$

You might notice that ShOutS is typed in a mix of capital and lowercase letters. Autogame is case insensitive.