Ren-Ren's Channel Tracker (RCT)

Ren-Ren's Channel Tracker (RCT) v1.0

The latest version can be found at: http://adrian.saxtus.gr (Backup: http://www.geocities.com/renx2)

I'm very interested in knowing how many people actually use this script. If you find the script useful, please send me an email with your name/nick, network, and any comments/suggestions. Thanks! My email is: renx2@yahoo.com

If you want to be notified of new versions, please let me know in the email.

RCT is free for you to download and use. Please don't rip it off. I spent an enormous amount of time and energy writing, testing and improving my scripts. Although free, if you find RCT useful and want to reward my hard work, please consider making a donation. Thanks! :)

CONTENTS:

INTRODUCTION
INSTALLATION
HOW TO USE
NOTES
LICENSE AND DISTRIBUTION INFORMATION
HISTORY

Last updated on April 18, 2003

INTRODUCTION:

RCT is used for tracking various data in a channel. In this early version, it tracks users who join/part/quit the channel, different nicks of users, and the time a user was last seen. It can display various channel stats in tables. Various channel commands (eg. !seen) are available for channel users. It can also auto-op or auto-voice users.

The script was tested on DALnet and CoolChat using mIRC v6.03 32-bit on a Windows 2000 Pentium 4 2.40GHz system. RCT may or may not work correctly in other versions of mIRC. There is no guarantee that the script will work 100% correctly. Use this at your own risk. Remember, if it hangs, press Ctrl-Break.

The script consists of: rct-sys.mrc

rctdoc.htm is the file you're reading. The license agreement is in rct-license.txt.

Back to the top

INSTALLATION:

Extract the files into a directory (preferrably one without spaces in the name). Open mIRC v6.03 (or above). Then type the following command in any mIRC window (replace "C:\mIRC\RCT\" with the directory you extracted the script to; the quotes are only needed if there are spaces):

/load -rs "C:\mIRC\RCT\rct-sys.mrc"

Back to the top

HOW TO USE:

rct-[channel].txt: All users who enter/leave the channel are tracked here.
rct-[channel]#data.txt: Various data for the channel are tracked here, sorted by date (joins, parts, quits, nick changes, kicks, and bans).
rct-[channel]#nicks.txt: Different nicks for each user are tracked here.
rct-[channel]#welcome.txt: Individual welcome messages for users are listed here.

RCT

Turn on/off RCT: Toggles channel tracking on and off. Default is on.
Modify list of tracked channels: Modifies the channels you want RCT to track.
Unload RCT: Unloads RCT and removes all RCT variables.
Display channel data: Enter the channel name to display its data in a table.
Display user data: Enter the channel name to display its user data sorted in a table.
Display single user data: Displays a nick's data in a window.
Change data path: Changes the path where you want RCT to save data to. Default is the script directory.
Open data file: Selects a data file to open in your default text editor.
Purge old data: Enter the channel name and date [yyyy/mm/dd] to remove data older than that date. Related data in the nicks and welcome message files are also removed. Channel data stored in rct-[channel]#data.txt are not removed. If you want to remove these, you must do so manually.
Remove duplicate entries: Enter the channel name to remove duplicate entries in its file.
Turn on/off channel command replies: Toggles replying to channel commands. Default is on.
Target for channel command replies: Toggles between sending channel command replies to user and channel. Default is user.
Set welcome message (new users): Enter the channel name to set the welcome message to new users for that channel. Color, bold, underline and reverse codes may be used.
Set welcome message (old users): Enter the channel name to set the welcome message to old users for that channel. Color, bold, underline and reverse codes may be used.
Turn on/off welcome message (new users): Toggles welcome messages to new users (if set). Default is on.
Turn on/off welcome message (old users): Toggles welcome messages to old users (if set). Default is on.
Target for welcome messages: Toggles between sending welcome messages to user and channel. Default is user.
Set general message color: Sets the color of messages. Double-click on the right to select. Default is cyan.
Set general message background: Sets the background color of messages. Double-click on the right to select. Default is transparent.
Help: Opens rctdoc.htm file (what you are currently reading).
Go to homepage: Opens my homepage in your web browser.

RCT

Turn on/off tracking [channel]: Adds/removes the channel to/from the tracking list.
Display channel data: Displays the channel data in a table.
Display user data: Displays the channel's user data sorted in a table.
Display single user data: Displays a nick's data in a window.
Purge old data: Enter the date [yyyy/mm/dd] to remove data older than that date for the channel. Related data in the nicks and welcome message files are also removed. Channel data stored in rct-[channel]#data.txt are not removed. If you want to remove these, you must do so manually.
Remove duplicate entries: Removes duplicate entries in the channel's file.
Set welcome message (new users): Sets the welcome message to new users for the channel. Color, bold, underline and reverse codes may be used.
Set welcome message (old users): Sets the welcome message to old users for the channel. Color, bold, underline and reverse codes may be used.

RCT

Display single user data: Displays the selected nick's data in a window.
Set welcome message for [user]: Sets the welcome message for the selected user when he/she joins the channel (the message is assigned to the user's address, not the nickname). Color, bold, underline and reverse codes may be used.
Auto-op [user] on join: If you are an op, you automatically op the user when he/she joins the channel.
Auto-voice [user] on join: If you are an op, you automatically voice the user when he/she joins the channel.
Remove auto-op/voice for [user]: User is not automatically opped/voiced.

!help: Shows the list of channel commands.
!seen [user]: Shows when the user was last seen.
!data chan: Shows various channel statistics.
!data nick [user]: Shows various data about user.

Back to the top

NOTES:

RCT stands for Ren-Ren's Channel Tracker. It has absolutely nothing to do with root canal treatment. :)

Thank you for trying Ren-Ren's Channel Tracker. Feel free to tell your friends about it. If you find RCT useful, please consider making a donation via PayPal. If you find a bug or think of a cool feature, you can send me an email at renx2@yahoo.com or tell me on DALnet or CoolChat IRC. I use the nick Ren-Ren.

For now, there is only one CTCP command the script responds to: RCT Version
The response is: RCT-Version [script name and version] [page address]

Back to the top

LICENSE AND DISTRIBUTION INFORMATION:

License Agreement: RCT is released as freeware. RCT may be distributed freely only in its entirety and as long as the files remain unmodified. RCT may not be sold or distributed as part of any product or package without express permission from the author. RCT is provided as is without warranties of any kind, expressed or implied. The author cannot be held responsible for any possible damage from the use of RCT. The user must assume the entire risk of using RCT.

I spent an enormous amount of time and energy on this. Please don't copy the script or any of its portions and call it your own.

Back to the top

HISTORY:

Added "Display Single User Data" commands to menubar, channel popup and nick list popup.
Fixed bug of not tracking nick changes.
Fixed bug of !help and !data commands responding when RCT is off and channel commands off.
Fixed bug of !data command for nicks showing data for the first matching nick rather than first matching address.

Added "Set welcome message (old users)" and "Turn on/off welcome message (old users)".
Added "!data chan" and "!data nick [user]" channel commands.
Added "Target for channel command replies »" and "Target for welcome messages »" options.
Fixed bug of only keeping track of current day's join/part/quit/nick/kick/ban stats.
When RCT is turned off, channel commands are also turned off.
Removed "Start tracking [channel]" and "Stop tracking [channel]" from channel popup. Added "Turn on/off tracking [channel]" to channel popup.
Changed "Turn on/off !seen response" to "Turn on/off channel command replies" in mIRC menubar.
Renamed "Channels to track" to "Modify list of tracked channels" in mIRC menubar.
Renamed "Set message color" and "Set message background" to "Set general message color" and "Set general message background" respectively, in mIRC menubar.
Reorganized popups.

First released version. I think it's safe.

Back to the top