Teratos's Note: Copy&Pasted changelog to end of file.


// #autoload
// #name = jsutirc
// #version = 0.0.7
// #date = Sept 29, 2001
// #author = [PEN]jsut
// #warrior =  jsut
// #email = jsut@kabob.ca
// #description = jsut's T2 IRC client extentions
// #status = release?
// #config = JsutIrcConfigGui
// #readme = jsut/readme.txt
// #category = jsut


Jsut's IRC extentions

** this script requires writers support.vl2 **
** http://planettribes.com/lorne/support.vl2 **

-----------------------------------------------------------
FEATURES
-----------------------------------------------------------

AUTOJOIN CHANNELS
Auto joins any number of user specifed channels
 
AUTO OP
Optionally auto ops anyone in your tribe, in any channel you have ops in.  

WHOIS
Whois option added to context menu, and implemented on the command line (/whois).
Whois response is now shown in active window.

ADDED IRC COMMANDS
/whois, /who and /msg  all work from the command line.  You have to know the server
nick of the user though.
/amsg and /ame also work.  They send messages, or actions to all the channels you are
in.

DISPLAY SERVER NICK OPTION
added a switch to display server nicks when people join channels

AUTO AWAY ON JOIN GAME
Sets your away message to the server description string used in the server
link when you join a game.

LOGGING
If enabled, this script writes logfiles of all your channels and private messages.

TIMESTAMPED LOGS
If you play with PJ's (http://planettribes.com/pj/) TimeHUD.  You can enable this
feature to get timestamped logs.  If you enable it when you don't play, it should
just ignore the option.  If t2time.cs is still in your base folder but you don't
use TimeHUD anymore i'm not sure what will happen if you enable this option.  You'll
probably get an inaccurate timestamp.

REMOVED CHARACTER FILTER
I have removed the filter that wouldn't let people type colon's in IRC

ADDED SCROLLBACK BUFFER
If this is configured, you can hit the up arrow and get back previous things you've 
typed.  The number of things stored is configurable by the user, but they higher
you make it, the more RAM it uses.  

IN GAME IRC MODE
A keybind has been setup (Toggle IRC Mode).  When IRC Mode is enabled, messages sent
to channels you are in in IRC, are shown in the in game message HUD.  It also allows
you to send messages back to channels that you are in using the normal chat windows
(u, and y default binds).  To send a message to a channel, you enter:
#serverchannelname message
This will send "message" to #serverchannelname.  You have to use the server version
of the channel name.


-----------------------------------------------------------
INSTALL
-----------------------------------------------------------
just drop in in gamedata/base.
make sure you have support.vl2 installed.


-----------------------------------------------------------
CONFIG
-----------------------------------------------------------

To edit the channels that are autojoined, go to the scripts -> jsutirc -> options
and add or remove channels as you see fit.  You can choose to prefix the channel
names with # or not.  

There are some buttons to turn other features on and off.

In Game Join Announce
Toggles the announcement of IRC joins to your in game message HUD

Show Server Nicks
Toggles the display of peoples server nicks in IRC.  This is useful if you want
to use the / style commands i have implemented.  otherwise you might as well
leave it off.

jsut's Dinger
Plays a noise when people talk in channels that you are in while the CHAT pane
isn't focused.  Doesn't play noises while you are in game.

Enable Logging
Uh, yeah,  pretty straight forward i think.  Writes logs to base/just/logs/
with filenames that are a sanitized version of the channels servername (so 
that they are valid filenames).

Timestamp Logs
If you are using PJ's TimeHUD, then this option will timestamp your logs.  If 
you aren't, it won't.  if you aren't running pj's scripts, you can get them 
here (http://planettribes.com/pj/).

Enable Status Window
If this option is turned on, the WELCOME pane will show the stuff that the 
STATUS window used to show, instead of the newbie IRC help that it does post
24834.

ScrollBack Buffer Length
This setting sets how many previous messages you can get to by hitting the
up arrow in the ChatSendText window.  The higher the number, the more you 
can go back, and the more RAM it uses.  It is NOT channel specific.


-----------------------------------------------------------
KNOWN BUGS
-----------------------------------------------------------

Timestamping logs when you used to use TimeHUD but don't anymore and t2time.cs
is still getting compiled.  Not much to be done about this.


-----------------------------------------------------------
TODO
-----------------------------------------------------------

if you have suggestions email me. (jsut@kabob.ca)


//******************************************************************************
//******************************************************************************


CHANGES
v0.0.7
added a toggle for auto ops

change gui so llamas playing at 640x480 (bleh) can see all the buttons.

v0.0.6
added option to turn the WELCOME window into the STATUS window, should
you so desire.

changed the in game chat back to irc so you can talk in your currently
active channel by just typing #, instead of #channel_name

removed jsut whois, because removing the status pane made the built in
functions useless.  whois now runs as if jsut's whois was turned on, 
meaning, it echo's exactly what the server spits back, and it does it
in the active window.

added an option to have little noises play when someone chats in any 
channel that you are in while you don't have the ChatGui selected.  the
option is called jsut dinger, if it's off, you will never hear the noises.

v0.0.5
fixed the crappy appending code i had.  Thanks to the DMWChat people for 
using .openForAppend, and for releasing the source of their scripts so
llama's like me can learn stuff.

added an ingame keybind for "Toggle IRCMode".  When IRC Mode is enabled, all
the crap going on in channels you are in is echoed into the games messagehud
along with all the other in game stuff.  The irc messages are a funny colour
though.

Made it so you can send messages to IRC from within the game by prefixing
you message with the channel name.  The way this works is any message (team or 
global) that has a # as it's first character is interpreted as message that
should be sent to IRC.  Everything up to the first space is interpreted as the 
channel name.  You have to use the server version of the channel name for this
to work right.

implemented /ame and /amsg.  the send actions, or messages (respectively) to
all the channels you are in (excluding private chats).

Changed the /msg handler so that if you do /msg jsut (or just the white part
os someone's nick) it works.  This has a big caveat though.  It'll only work 
if you are in a chat room with that person.  It does work well for starting 
up private chats with people though.  The way it works is, it checks if the 
nick you are /msging exists in one of the channels you are in, and if it does
it sends the message to them.  If not, it treats the nick you entered as a 
server nick, and sends the PRIVMSG to the server with the same nick you typed.

Change the onNoSuchNick Function to print out the message in the current
window.

Changed the Whois Functions to display the results in the currently active 
window, since the status window is gone in the beta patch. 

fixed the ChatSendText window so it disappears when you click on the WELCOME 
pane (beta patch)

v0.0.4
"Fixed" Dynamix's colon filter.  This was *really* annoying to me :) 
(thanks Koko for the spot)

"Fixed" The chat message entering box to have a user configurable history.  this 
is an option too. (again, thanks koko for the spot)

Implemented logging.  added timestamping if you are running with PJ's TimeHUD.  
Logging and having timestamped logs are both new options.

changed the in game join announce to be a funny colour.

v0.0.3
Implemented /whois, /who and /msg in the chat bar, you have to use the server
version of the nick for these to work correctly though.

Added an option to display people's server nick's when they join channels

Added an option to display join messages in the ingame Message HUD when you are 
connected to a server

added an option to have the raw whois return messages show in the STATUS window
instead of the mangled ones

v0.0.2
Altered the autojoin to make it not automatically rejoin channels that you have left.
So if you have three channels in your autojoin.ini, and leave one of them, you
will no longer rejoin those channels if you click off the chat pane and return to
it.

Altered the autojoin to rejoin all your autojoin channels if you make changes to the
autojoin.ini on the options page for the script.

Storing the autojoin channels in memory so we don't have to go to disk to get the list
everytime.

Took out some debugging messages.


v0.0.1
Initial release
