---- MTS DRAFT 8.2 - VERSION 1.1 Themer reference ---- *** This is for the MTS 1.1 draft. Few things have changed in this draft from the 1.0 version, so themes you make with this reference will most likely be compatible with engines that support the 1.0 draft. This smaller document is geared toward themers and is a scaled down and slightly edited version of the full MTS draft. To view the full MTS draft, please visit http://www.mircscripts.org/mts.php. Feedback and ideas can also be left there. Also, sample theme files can be found at www.mircscripts.org in the Themes section. ---- CONTENTS ---- Chapter 1 - Basic Format for an MTS Theme File Chapter 2 - Format of Events and Raws in MTS Theme Files Chapter 3 - Variables Used in Events and Raws Chapter 4 - MTS File Format - Settings and Information Chapter 5 - MTS File Format - Events and Raws Chapter 6 - MTS File Format - Sounds (Optional) Chapter 7 - MTS File Format - Schemes (Optional) Chapter 8 - Scripting and theming Notes ---- TERMINOLOGY ---- "MTS" is mIRC Theme Standard- this document, and any script that uses the concepts within to handle themes. "script" refers to a script that handles theme output- in other words, the theme engine. "theme" refers to an actual theme or theme file that has been loaded. "event" is something that occurs on mIRC that can have it's output reformatted. "raw" is a special type of IRC event referred to by a number from 001 to 999. "variables" are used to store information relating to an event or raw, to later be formatted by the theme. A "MTS" "script" will take IRC "events" and "raws", store relevant data in "variables", and use the information in a "theme" to format them for display. ---- CHAPTER 1 - BASIC FORMAT FOR AN MTS THEME FILE ---- All MTS theme files should have an extension of .MTS. MTS files are simple text files, where each line contains one event, raw, setting, or other piece of theme-related information. You may have blank lines, and any line beginning with a semicolon (;) will be treated as a comment and ignored. Themes may refer to external files such as images or a .MRC file. These files must be in the same directory as the theme .mts file. For example, ultra.MTS refers to ultra.MRC and BK.PNG. These files would be in the same directory as the ultra.mts file. IT IS HIGHLY RECOMMENDED THAT .MTS FILES BE PUT IN THEIR OWN SUBDIRECTORY SO THAT SUPPLEMENTAL THEME FILES DO NOT CONFLICT WITH OTHER THEMES. You can also find a public all purpose theme engine in order to test your themes out at www.mircscripts.org, made by Eric^^. Keep in mind that his engine is the most popular right now, but if you find problems in it, remember that they are problems with his engine, not with the MTS standard. Make sure you report any problems you find to him. ---- CHAPTER 2 - FORMAT OF EVENTS AND RAWS IN MTS THEME FILES ---- Each event or raw has one line in an .MTS file. The line starts with a code that signifies the event or raw. The remainder of the line is the text displayed for that event, but will contain special variable that will get replaced when the actual event occurs. For example- TextChan [] This is a basic theme line for text in a channel window. When it is displayed, the script will replace with the nickname of the user, and with what they said. Some (or all) events may instead refer to aliases or lines of code. For example- TextChan !Script theme.chantext A special variable, %:echo, contains the command the alias should use to display it's text. A short example alias that could be part of a theme's script file: alias theme.chantext { %:echo ( $+ $lower(%::nick) $+ ) %::text } These aliases are stored in a separate .MRC file. Note that "!Script" by itself is not an error- it simply "does nothing", preventing any output. This is equivalent not having anything after the first word on the line, such as TextChan by itself. ---- CHAPTER 3 - VARIABLES USED IN EVENTS AND RAWS ---- All-purpose variables: (these must be set in all events and raws) %:echo Command being used to display text. Use in place of /echo. %::me Your nickname. %::server The server you are currently connected to. (if connected) %::port The port you are currently connected to. (if connected) %::pre Set to the value of Prefix. (see Prefix option.) %::c1 Base color 1. (see BaseColors option) %::c2 Base color 2. (see BaseColors option) %::c3 Base color 3. (see BaseColors option) %::c4 Base color 4. (see BaseColors option) %::timestamp The current timestamp, using the script's Timestamp line format. Used by in theme files. Variables used in events: %:comments Used by all events. These comments are for a script to add any additional text to a line, and should therefore be appended to the end of any displayed line. A normal text line (one not using !Script) does not need to do anything with this- the script should append it automatically when used. For this reason there is no corresponding code. %::text The text or message from the event. (if any) For CTCP, CTCPSELF, CTCPREPLY, CTCPREPLYSELF- Additional text for the CTCP, beyond the command. For NOTIFY, UNOTIFY- Notify note, if any. %::parentext For KICK, KICKSELF, QUIT, PART, NOTIFY, UNOTIFY- This is the same as %::text, but surrounded with parenthesis. If there was no message, this is blank- not "()". The format for this can be changed by a script- see ParenText, chapter 6. %::nick Nickname of user triggering event. In cases such as you sending a private message, this is who you sent it to. %::address Address in ident@host format of %::nick, if available. %::chan Channel event occured in. %::cmode Current mode of %::nick on %::chan, such as @ or +. %::cnick Current color of %::nick on %::chan, as a number. %::target Equivalent to $target, useful for op notices and certain other cases. %::knick For KICK, KICKSELF- Nickname of user who was kicked. %::kaddress For KICK, KICKSELF- Address in ident@host format of %::knick, if available. %::newnick For NICK, NICKSELF- New nickname for user. %::modes For MODE, USERMODE- Channel modes or usermodes being set. %::ctcp For CTCP, CTCPSELF, CTCPREPLY, CTCPREPLYSELF- CTCP or CTCPREPLYcommand. (single word) The remainder of the CTCP, if any, is in %::text. Variables used in raws: (Note that if a raw only uses ONE of %::value, %::nick, or %::chan, then the script is allowed to place the SAME VALUE in all three, for simplicity. A theme should not rely on this behavior.) %::text The full text from the event, either $2- or $3-. (if $2 is placed in %::nick or %::chan, %::text should be $3-) %::numeric Number of the raw reply being triggered. %::value A single value of interest from a raw, usually $2. %::nick Nickname raw applies to. (usually from $2) %::chan Channel raw applies to. (usually from $2) %::fromserver The server that is sending the raw line to the user- this is determined using $nick in a mIRC raw event. This will NOT always match %::server. %::users For RAW.251, RAW.255, RAW.265, RAW.266- User count. %::modes For RAW.221, RAW.324- Channel/user modes currently set. %::address For RAW.302, RAW.352- Address of nickname. (USERHOST or WHO) Variables for WHOIS, WHOWAS, and WHO events and raws: (Note that there is no WHO event, just RAW.352, but it is listed as WHO below for clarity. A script is only required to use these variables in WHOIS/WHOWAS/WHO events and raws- they do not need to work in other events and raws.) %::away WHOIS- Away message, if any. WHO- H for Here, G for Gone. (away) %::nick WHOIS, WHOWAS, WHO- Nickname of user. %::address WHOIS, WHOWAS, WHO- Address of user in ident@host format. %::chan WHOIS, WHOWAS- Channels user is on, if any. WHO- A single channel user is on. %::cmode WHO- Current mode of user on specified channel. %::realname WHOIS, WHOWAS, WHO- The "full name" field. %::isoper WHOIS, WHO- Is this user an IRCop? Set to "is" or "is not". %::operline WHOIS- The text of the "is an ircop" line sent by the server, not including the nickname, as different users may have different levels of status described in this line. %::isregd WHOIS- Is this nickname registered? Set to "is" or "is not". %::wserver WHOIS, WHOWAS, WHO- IRC server the user is on. %::serverinfo WHOIS, WHOWAS- "Info" about the IRC server the user is on. (usually just useless text) %::idletime WHOIS- How long the user has been idle, in seconds. %::signontime WHOIS- When the user signed on, in $asctime() format. %::value WHO- Number of hops user is away. %::text WHOIS, WHOWAS- Any extra notes from a whois not covered elsewhere. WHO- Entire /who line. Variables for DNS events: (Other than %::nick, a script is only required to use these variables in DNS events- they do not need to work in other events and raws.) %::nick Nickname of user being DNS'd, if appropriate. %::address The address being looked up. This will be equal to either %::naddress or %::iaddress. (not %::nick) %::naddress Named address, if available. %::iaddress IP address, if available. %::raddress Resolved address, if available. List of all variables without duplicates- %:echo %:comments %::address %::fromserver %::newnick %::serverinfo %::away %::iaddress %::nick %::signontime %::c1 %::idletime %::numeric %::target %::c2 %::isoper %::operline %::text %::c3 %::isregd %::port %::users %::c4 %::kaddress %::parentext %::value %::chan %::knick %::pre %::wserver %::cmode %::me %::raddress %::cnick %::modes %::realname %::ctcp %::naddress %::server ---- CHAPTER 4 - MTS FILE FORMAT - SETTINGS AND INFORMATION ---- .MTS files contain more than just events and raws- they contain other lines with information and settings. These settings are covered in this chapter. Remember that all entries in an .MTS file take up one line. Actual events and raws are in the next chapter. Also note that the setting names are not case sensitive. Note that MTSVERSION and NAME are the ONLY required fields. The [mts] line is also required. Everything else is optional, and a script should use default values or no values for missing items. Informational items in an MTS file: [mts] This must appear before any MTS data. It should appear on a line by itself. (this is to ease MTS loading by allowing use of the mIRC /loadbuf -t switch.) Name This is the name of the theme, and is required. Author The name or nickname of the theme's author. Email E-mail address of the author. Website Website for the theme or author. Description A brief description of the theme. Version The version of the theme. A new version of the same theme should have a value that is greater than (>) the previous version's value. MTSVersion The version of MTS the theme is designed for. A theme will work on a later version of MTS but not an earlier one. This field is required and should be in the form "n.nn". Color options in an MTS file: These items allow a theme to change mIRC and theme colors. Colors These are the mIRC /color settings to use; the order is the same as in the mirc.ini file. The format is 26 numbers, separated by commas. If not present, use the default mIRC colors. See chapter 9 for the order of colors and defaults. RGBColors These are the RGB values to use for all 16 colors. Each color is three numbers (R,G,B) separated by commas; there are 16 such sets, separated by spaces. In other words, R,G,B R,G,B R,G,B etc. (where R,G,B are numbers) If this line is not present, you should reset all colors to their default mIRC RGB values (can be done with /color -r in mIRC) BaseColors This is four colors used in the theme itself. These will be used for %::c1 through %::c4 and through . The format is four numbers, separated by commas. It is recommended that these four colors be in a certain order. (see below) BaseColors help keep a theme "modular"- if you use them throughout a theme, you can then change the colors of your entire theme just by changing one or two color lines. (more details in chapter 9 - schemes) Scripts may also choose to use the colors in BaseColors for their own specialized echos and displays. For that reason, the order of the four BaseColors is recommended to be as close to the following as possible- Text color, Nickname color, Text highlight color, Bracket color These are merely recommendations- a theme can use these for anything it wishes. The reason for the recommendation is so a theme contains reasonable colors that a script can use for it's own purposes as well. All four colors should ideally produce readable text on the selected background color. Nicklist options in an MTS file: The first set of items are single numbers representing the color to use for nicknames in the nicklist. Each line either corresponds to a channel mode (OP, etc.) or a special status. (such as IRCOP) Not all scripts will use all colors (or even use nicklist colors at all) and remember that themes do not need to include all colors. A script should ideally not use any colors that are not present- in other words, if a user is both an OP and an IRCOP, but the theme does not define an IRCOP color, use the OP color. CLineOwner Mode . on certain servers (channel owner) CLineOP Mode @ (op) CLineHOP Mode % on some servers (half-op or helper) CLineVoice Mode + (voice) CLineRegular No special mode. CLineMe Your nickname. CLineFriend A friend. (notify list, userlist, protected, auto-op, etc.) CLineEnemy An enemy. (banned, ignored, blacklisted, etc.) CLineIrcOP IRCops. For scripts that can use /aline for custom windows (such as multiserver scripts), MTS provides for you to be able to change the mode character and color for each type of user. Keep in mind that CLineCharRegular probably wont use a character, but if the theme wants one, then you should accomodate for it. The syntax is the exact color and mode character to be prefixed before the above CLine colors. Note that, like the other CLine lines, you should not include the color control code itself. (Ctrl+K) CLineCharOwner 12. CLineCharOP 11@ CLineCharHOP 10% CLineCharVoice 09+ CLineCharRegular Font options in an MTS file: These options define the fonts to use for windows. A script may ignore these but the theme may not look correct. Some fonts apply to multiple windows or types of windows. Each font line is a font name, followed by a comma and a font size. The size should be a positive or negative number. To make a font bold, put ,B after the font size. FontDefault Font used for status window and any unspecified windows. This is basically a "default" font that can be used for any window. (for example, script windows or notify/url/finger windows) FontChan Font for channel windows. FontQuery Font for query, chat, and dedicated message windows. Image options in an MTS file: These options define image files to use for backgrounds and other areas of mIRC. A script is free to ignore some or all of these. The first word of each line defines the way to apply the background- center, fill, normal, stretch, tile, or photo. This is followed by the filename of the image. The ImageButtons item does not have a style. The ImageToolbar and ImageSwitchbar should include a style. (although mIRC currently only supports the fill style for these, this may change in the future.) ImageStatus Background for status window. (you may use this for other windows if desired) ImageChan Background for channel windows. ImageQuery Background for query, chat, and dedicated message windows. ImageMirc Background for main mIRC window. ImageToolbar Image to use for toolbar. ImageButtons Image to use for toolbar buttons. ImageSwitchbar Image to use for switchbar. Miscellaneous options in an MTS file: Prefix This value is simply used for %::pre and 
, so that a
                common prefix does not need to be rewritten on every event.
                
ParenText       This special value is used to surround part, quit, and kick
                messages with parenthesis. If not present, a script should
                use "()" for this. Whenever a part, quit, or kick
                occurs,  will contain the normal text, and 
                will use this. However,  will be blank if there
                is no message. This usage prevents events from showing empty
                parenthesis if there is no message.
                
Timestamp       Set to ON or OFF. Can be removed from a theme file so as
                to not affect the timestamp setting, or a script can
                ignore this setting in a theme.

TimestampFormat mIRC's /timestamp format is set to this. Note that a script
                should reset this on startup, because if it contains colors
                then mIRC will remove them on startup.

                A themer can also use the special  variable to
                put a timestamp anywhere in a line they want. The theme 
                engine should always set the %::timestamp variable when
                $theme.text is called.

Script          This item contains the filename of a mIRC script to load as
                part of the theme. This file should contain all aliases
                used in !Script lines. This file should be loaded using
                /load -rs, as it is a script file, not an alias file.

Scheme1         These lines contain names of color schemes that the theme
Scheme2         contains. See chapter 9 for details on this optional feature.
etc...




---- CHAPTER 5 - MTS FILE FORMAT - EVENTS AND RAWS ----

All possible theme events, and all common raws, are listed below. A script is
not required to use all events, but most should be used for full effect. Note
that if an event or raw is missing, a script should use some sort of default
display. A missing event or raw does NOT mean to hide that event or raw.

Whenever an event or raw refers to a variable in %::var format, remember that
the same value will be in  format when processing normal theme lines.
Note that only some %::vars are mentioned- others like %::nick are assumed.


Text IRC events:

TextChan         Standard text in a channel.
TextChanSelf     Your text in a channel.
ActionChan       Action performed in a channel.
ActionChanSelf   You perform an action in a channel.
                 
NoticeChan       You recieve a channel or op notice. Note that %::target
                 will contain @#channel for an op notice.
                 
Notice           You recieve a private notice.
NoticeSelf       You send a private notice.
NoticeSelfChan   You send a channel or op notice. The script should put
                 either #channel or @#channel into %::target to clarify.
                 
TextQuery        Private message in a query or chat window.
TextQuerySelf    You send a message in a query or chat window.
ActionQuery      Action performed in a query or chat window.
ActionQuerySelf  You perform an action in a query or chat window.

TextMsg          You recieve a private message, displayed in active or
                 dedicated messages window.
                 
TextMsgSelf      You send a private message, displayed in active or dedicated
                 messages window.


Basic IRC events:

Mode            Channel mode change. %::modes has full mode string.
ModeUser        You change usermodes. %::modes has full mode string.
Join            Another user joins a channel.
JoinSelf        You join a channel.

Part            Another user parts a channel. %::text has part message, if
                any. %::parentext will contain the message with parenthesis,
                if any. (See ParenText, Chapter 6)

Kick            Another user is kicked. %::text has kick message.

KickSelf        You are kicked. %::text has kick message. Both this and Kick
                should place the message, if any, into %::parentext with
                parenthesis. (See ParenText, Chapter 6)

Quit            A user quits IRC. %::text has quit message, if any. This event
                will be called once for each place it appears. (usually, once
                for each channel the user was in)  %::parentext will contain
                the message with parenthesis, if any. (See ParenText,
                Chapter 6)

Topic           Topic changed in a channel. %::text has new topic.

Nick            Your or another user changes nickname. This event will be
                called once for each place it appears. (usually, once for
                each channel the user was in)

NickSelf        This appears in status when you change nickname. The NICK
                event will be used for each channel, also.

Invite          You are invited to another channel.

ServerError     The server reports an error. This is equivalent to the ERROR
                event in mIRC. %::text has full error string.
                
Rejoin          You attempt to rejoin a channel.

Ctcp            You recieve a CTCP. %::ctcp contains the CTCP command (one
                word) and %::text contains any additional CTCP text.
                
CtcpChan        You recieve a CTCP on a channel. %::ctcp contains the CTCP
                command (one word) and %::text contains any additional CTCP
                text. %::chan will contain the channel it was received on.
                
CtcpSelf        You send a CTCP. %::nick will contain whom it was sent to. 
                %::ctcp and %::text work like CTCP.
                
CtcpChanSelf    You send a CTCP to a chan. %::chan will contain where it was 
                sent to. %::ctcp and %::text work like CTCP.
                
CtcpReply       You recieve a CTCP reply. %::ctcp contains the CTCP reply (one
                word) and %::text contains any additional reply text. %::chan
                will contain the channel it was received on, if any.
                
CtcpReplySelf   You send a CTCP reply. Not all scripts use this when sending
                replies. %::chan or %::nick (but not both) will contain whom
                it was sent to. %::ctcp and %::text work like CTCPREPLY.
                
Notify          A user on your notify list is on IRC. %::text contains any
                notify note.
                
UNotify         A user on your notify list has left IRC. %::text contains any
                notify note.
                
Wallop          A wallop, contained in %::text.

NoticeServer    A server notice, contained in %::text. %::nick will contain
                the server that sent the notice, which may differ from
                %::server.
                 

Non-IRC events:

These events are not directly related to an IRC connection.

DNS             Displayed when you start a /dns request. Either %::nick or
                %::address (but not both) will contain what you are
                /dns'ing, as appropriate.
                
DNSError        A /dns request has failed. One of the following will be true-
                
                1) Only %::nick is filled. You tried to /dns a user that was
                   not found.
                2) Only %::address is filled. You tried to /dns an address and
                   failed.
                3) Both are filled. You tried to /dns a user and failed, but
                   the user was online.
                
                If %::address is filled, either %::iaddress or %::naddress
                will also be filled, but this isn't usually used.
                
DNSResolve      A /dns request has been resolved. %::nick will contain a
                nickname if appropriate. %::address, %::naddress,
                %::iaddress, and %::raddress will all be filled.
                
Echo            Used for anything a script wants to display. %::text contains
                the actual text to display.
                
EchoTarget      Used for anything related to or displayed in a channel.
                %::target contains the target window name, %::text contains
                the actual text.
                
Error           Used for any error messages a script displays. %::text
                contains the text to display.
                
Load            Displayed (or run) when the theme is loaded. (after any script
                is loaded and any settings changed.)
                
Unload          Displayed (or run) right before the theme is unloaded.


Whois and Whowas raws and events:

/whois (and /whowas) replies are handled a little differently in MTS. Each raw
is called normally as expected- and if this is enough for a script (displaying
the /whois line-by-line) then nothing more is needed. Some themes, however,
like to wait until the entire whois reply is collected and then display it,
for formatting purposes. In this case, leave the /whois raws blank, and add
Whois and Whowas events. These will be called after the data for a full /whois
or /whowas is collected. Since a /whois may reply on multiple nicknames, this
event will either be called right before the end of whois raw (RAW.318) or
right before the start of the next whois. (RAW.311) Most themes will use
either the line-by-line raw method, or the Whois method- but a theme is
allowed to use both if it needs to for any reason.

If a theme does not have a Whois or Whowas event, then a script should use
default /whois or /whowas behavior if the raws are also not present.
Otherwise, hide output even if a specific /whois or /whowas raw is not found.

Note that any unrecognized raws seen between RAW.311 and RAW.318 should be
treated as part of a /whois, and stored in or appended to %::text. This isn't
a requirement, but suggested for ideal /whois operation. (if not done, %::text
will be blank in the WHOIS or WHOWAS event.)

RAW.311         Start of whois- %::nick, %::address, %::realname.
RAW.314         Start of whowas- %::nick, %::address, %::realname.

RAW.319         Channels- %::chan. This raw may occasionally appear multiple
                times per nick. %::chan will contain -all- channels in the
                final WHOIS event.
                
RAW.312         Server- %::wserver, %::serverinfo. (in a whowas, %::serverinfo
                often contains signoff time)
                
RAW.301         Away- %::text.
RAW.307         Registered nick- %::isregd.
RAW.313         IRCop- %::isoper, %::operline.
RAW.317         Idle/signon- %::idletime, %::signontime.

RAW.318         End of whois- %::nick will contain the nickname or nickname(s)
                that were /whois'ed.
                
RAW.369         End of whowas- %::nick will contain the nickname or
                nickname(s) that were /whowas'ed.
                
Whois           Display whois- Called right before 318. (or 311 in a
                multi-user whois)
                
Whowas          Display whowas- Called right before 369. (or 314 in a
                multi-user whowas)


THIS IS NOT A COMPREHENSIVE LIST OF RAWS. ANY raw can be listed in a theme.

Simply use RAW.nnn, where nnn is the three digit raw number. If a raw is not
found, RAW.OTHER should be used, if present. If not, the script can display
the raw however it pleases. If you wish to hide the output from a raw, you
should just write "!Script" for the event, with nothing to run. This will
essentially "do nothing".

Any raw not listed here should have $2 in %::nick and %::chan, $3 in %::value,
and $3- in %::text if $2 is a nickname or channel, or $2 in %::value and $2-
in %::text otherwise.

Note that if a raw only uses ONE of %::value, %::nick, or %::chan, then the
script is allowed to place the SAME VALUE in all three, for simplicity. A
theme should not rely on this behavior.


RAW.001         Welcome to IRC.

RAW.002         Server and version- %::server (this is always set anyways) and
                %::value.

RAW.003         Server created on- %::value.
RAW.005         Protocols supported by server- %::text.
RAW.221         Current usermode- %::nick, %::modes.
RAW.250         Total connections- %::value.
RAW.251         Users, invisible, servers- %::users, %::text, %::value.
RAW.252         Operators- %::value.
RAW.253         Unknown connections- %::value.
RAW.254         Number of channels- %::value.
RAW.255         Local clients, servers- %::users, %::value.
RAW.265         Local users, max- %::users, %::value.
RAW.266         Global users, max- %::users, %::value.

RAW.302         Userhost- %::nick, %::address, %::value. Called once for each
                user in the userhost. (value contains + for here, - for away,
                and also contains a * for an ircop.)
                
RAW.315         End of /who- %::value contains exactly what was /who'd.
RAW.324         Channel modes- %::chan, %::modes.
RAW.332         Channel topic- %::chan, %::text.
RAW.333         Topic set by and when- %::chan, %::nick, %::text.
RAW.341         User was invited- %::nick, %::chan.

RAW.352         /who data- %::nick, %::address, %::cmode, %::away, %::chan,
                %::wserver, %::realname, %::value, %::text, %::isoper
                
                (nick, address, cmode, chan, wserver, realname, and isoper are
                 exactly like a /whois. away is H for here and G for gone.
                 value is number of hops. text is the entire line, so the
                 script can parse it manually if desired.)
                 
RAW.353         Channel names list- %::chan, %::text.
RAW.366         End of names list- %::chan.
RAW.372         Message of the day- %::text.
RAW.375         Begin message of the day.
RAW.376         End message of the day.
RAW.391         Time/date at server- %::text.
RAW.401         No such nickname- %::nick.
RAW.403         No such channel- %::chan.
RAW.404         Unable to send message- %::chan.
RAW.421         Invalid command- %::value.
RAW.433         Nickname in use- %::nick.
RAW.471         Channel full- %::chan.
RAW.473         Channel invite only- %::chan.
RAW.474         Banned from channel- %::chan.
RAW.475         Channel key required- %::chan.
RAW.482         Not opped- %::chan.

RAW.Other       Used for any raw not found in the theme.




---- CHAPTER 6 - MTS FILE FORMAT - SOUNDS (OPTIONAL) ----

This chapter describes a method of adding sound events to a theme.
Sounds can be defined for events by simply making another line in
the theme in the form of:

SndEventName filename.wav

"EventName" should match a MTS event or a mIRC event or command,
if possible. An event that matches an IRC event affecting you should
include the "Self" suffix. Some more commonly used sound events-

SndNotice
SndJoin
SndJoinSelf
SndPart
SndPartSelf
SndKickSelf
SndOpSelf
SndDeopSelf
SndBanSelf
SndInvite
SndNotify
SndUNotify
SndError
SndStart
SndConnect
SndDisconnect
SndOpen
SndDCC
SndDialog
SndAway
SndBack
SndPager




---- CHAPTER 7 - MTS FILE FORMAT - SCHEMES (OPTIONAL) ----

This chapter describes a method of supporting multiple color sets
in a theme, hereafter referred to as "schemes". Support for this in
a script is entirely optional. Themes do not need to contain any
schemes.

The concept of schemes is to allow a theme to have a few things that
change for each scheme, and let the rest remain the same across all
schemes. Usually, the items changing will be Colors, RGBColors, and
similar items, but this is not required. For example, a theme could
contain a "red" scheme, a "blue" scheme, and a "green" scheme,
which would contain different Colors lines; however, everything else
would remain the same.

Schemes prevent having to create entire new themes just to change minor
things such as colors.

For each scheme included in a theme, you need to add a SchemeN line to
the main theme section, containing a description or name for that
scheme. Then, add a [schemeN] section to the theme containing all
items that are changing in that scheme. Here is a short example-


[mts]
Name This is an example theme.
MTSVersion 0.97

; (normal theme lines would go here)

; We include a default colors line for scripts that
; don't support schemes.
Colors 1,2,3,4,5,6,7,8,1,2,3,4,5,6,7,8,1,2,3,4,5,6,7,8,1,2

; These are our schemes
Scheme1 Red
Scheme2 Green

[scheme1]
; Colors for the 'Red' scheme
Colors 8,7,6,5,4,3,2,1,8,7,6,5,4,3,2,1,8,7,6,5,4,3,2,1,8,7

[scheme2]
; Colors for the 'Green' scheme
Colors 9,1,6,5,4,7,3,2,3,5,1,3,5,9,3,8,4,5,2,7,3,2,4,1,0,5

; We also change the prefix for this scheme
Prefix [*]

; (end of file)


When a script (that supported schemes) were to load this theme,
it would first load everything in the [mts] section. Then, it would
grab all of the scheme names from the SchemeN lines, and prompt the
user for the scheme to load. Then, it would load the associated
[schemeN] section, overriding anything in the original theme.

Note how the theme includes a Colors line in the main section. This
is so that a script that doesn't support schemes will still load the
theme properly.




---- CHAPTER 8 - THEMING NOTES ----

Order of items in a Colors line-

Background, Action text, CTCP text, Highlight text, Info text, Info2 text,
Invite text, Join text, Kick text, Mode text, Nick text, Normal text,
Notice text, Notify text, Other text, Own text, Part text, Quit text,
Topic text, Wallops text, Whois text, Editbox, Editbox text,
Listbox, Listbox text, Grayed text

Default mIRC colors for a Colors line-

0,6,4,5,2,3,3,3,3,3,3,1,5,7,6,1,3,2,3,5,1,0,1,0,1,15

Default mIRC RGB values for an RGBColors line-

255,255,255 0,0,0 0,0,128 0,144,0 255,0,0 128,0,0 160,0,160 255,128,0
255,255,0 0,255,0 0,144,144 0,255,255 0,0,255 255,0,255 128,128,128
208,208,208


Important notes for theme files-

1) A theme alias should never use /halt. Use /return instead.

2) A theme alias should never modify (or unset) %::variables.

3) A theme file should not contain the mIRC ON LOAD and ON UNLOAD events. Use
   the MTS LOAD and UNLOAD events instead.

4) A theme that contains schemes should still include all settings (that it
   uses) in the main [mts] section, in case a script that doesn't support
   schemes tries to load it.
   
5) Remember to begin your theme with the [mts] line. This is required so
   that scripts can ease theme (and scheme) loading. (even if your theme
   or script does not support schemes, all themes must still use this line
   for compatibility.)
   
6) Do not worry about %:comments for normal text lines, but when you !Script
   an event, you should display it. This doesn't apply to raws.

7) Color codes should ALWAYS BE DOUBLE DIGIT. Although, most people still
   aren't used to doing this, so a theme engine should IDEALLY try and 
   compensate for a theme that doesn't have double digit color codes and
   adjust accordingly. 

8) !Script can not be used on ParenText, Prefix, or Timestamp (doesn't make
   sense to do this)

9) Themes should NOT USE /echo. They should only use %:echo.

10)  are not to be used on !Script lines - use the correct
    %::variable instead.

11) An item in a theme file with no value, such as TextChan by itself,
    should do nothing.
    This especially applies to schemes - a scheme should have the capability
    to override (or remove) a setting in the main theme.