Core settings


These are the scripts core settings. You shouldn't unload the file where they are contained. When you use the script for the first time, you'll be asked to set them up (its not mandatory, though). They are organized within the following sections:


Function keys

This section presents you with a list where you can customize which commands each one of the function keys will perform. Function keys are your keyboard keys from F1 to F12 also combined with Shift and Control keys. You can use identifiers and variables along with the commands. You can also set multiple commands per function key, using character pipe ("|"). Double-click on each key on the list to set the command(s) to use. You can reset every function key to its defaults, by pressing the "Defaults" button, and unset their assigned command by pressing the "Unset" button.


Lag meter

Here you can configure your lag meter. This feature is meant to fetch the time your messages take to arrive to the network and being visible to other users.

Display on active window/lagbar

If you choose "active window", the script will display a short message on your current active window containing the measured lag. If you choose "lagbar", you'll get a progressbar in the right side of the costumizable toolbar measuring your current lag within an interval of time specified.
Note: You can't use the lagbar if the toolbar is disabled.

Method

Select "CTCP" to measure the lag using a CTCP ping, "Notice" to use a standard notice, or "raw 421" to use an unknown command to the server.

Check every X second(s)

The script will update the lag each X second(s).

Max value

The maximun lag value that the lagbar should support.

Lagbar color

You can setup the lagbar colors here. Select the part of the bar you want to change the color, and click on the square at the site.

Warn if lag is above max

After updating the lag, if it is greater than the value specified at the "Max value" field, a short message will be delivered to the active window warning you about this fact.


Sound events

In this section you have a list of events, where each one of them can be associate to a sound. When an event in this list is triggered, its associated sound will be played. Double-click on each event on the list to set its sound. Each event is prefixed by an editbox. You can enable/disable each event from playing its sound by marking/unmarking their checkboxes. Its also possbile to set the list to its defaults by pressing the "Default" button, and disassociate each event from its sound by pressing the "Unset" button.


Quotes

Here you can write some quotes that will be displayed randomely at the advertisement, load, quit and kick message. Select each place on the combo box to display and edit its content on the editbox below.


CTCP's

With this feature, you're able to customize all your CTCP replies except for the DCC and VERSION replies. You have a list where you can add the CTCP request and its associated reply. To add/edit/remove CTCP's or to set the list back to its defaults, just right-click on the list or press the "options" button. You can use variables and/or identifiers on the replies.

Ignore all CTCP's

Blocks all CTCP request that other users might send to you. mIRC won't let the VERSION request be blocked, though.

For unkown CTCP...

If somebody sends you a CTCP request not contained in the list, you can either set the script to block it, or send a default reply that you can edit below.


Modules

Here you can load/unload the other modules of this script. This is very usefull if there is something on the script that you don't use/need at all. For example: lets say you don't use the protections. You don't need to have them loaded to the script just because they are a part of it. You can unload them and stop wasting memory.


Addons

Here you can load/unload addons with a dialog interface, instead of using the /load and /unload commands. All extra stuff you added to the script will be added to the list bellow.


Nick completion

Well, I consider this part the most difficult to understand, so, I'll try to explaining it the best I can. First of all, this feature allows you to perform nick completion. It's meant to, when you are typing a message to a channel, and you want to write on it a nickname of a user that is present on that channel, you won't need to type the entire nickname on your own, you'll just need to type a small part of his nick, and the script will replace that small part for the entire nick, after you send the message to the channel. Now, you have 2 kinds of completation: automatic and manual.

Automatic completation

This is the simple way to perform nick completation. The main idea is to write a small part of the nick anywhere on the message, and the script will automatically check every word of the message, and compare each one of them with the users nicknames that are present on the given channel. If it finds any matchs, them it will replace each word by it corresponding nickname. Ex: lets say you want to salute someone on a channel, and the user's nickname is "SolidSnake", and you don't want to type all the nick on your message. You can write:

Hello solid !

And if you have the automatic nick completion activated, the script will replace your message by:

Hello SolidSnake !

Now, you have to pay atention to one thing: if you type the "!" character close to "solid" (solid!) the completion won't work, because "!" is not a character present on the nickname "SolidSnake". Also you have to specify a minimum of characters so the script can know if a given word is available to be replaced by a matching nickname. Ex: lets say you specify that minimum to be of 5 characters. If you want to perform a nick completion on the nick "[47]" by typing "47", the script will ignore it, because "47" has 2 characters, and the minimum to perform completion, are 5. So, if you want the script to complete it, you must set that minimum to 2 characters. But you won't want to do this, because this way, the script will surely perform completions to words that you don't want to.

Manual completation

This is a kind of completation much more controlable, but also a little bit more complicated. The main ideia is to use a prefix on a message, and on the left side of the prefix, you will type one part of a nickname to be completed. Ex: lets say you want (again) to perform completion on "SolidSnake" using only "solid", but you want to use the manual completation. Lets say the prefix to use is the ":" character. You'll type:

solid: How are you?

And if you have the manual completion activated, the script will replace your message by:

SolidSnake: How are you?

Note that some "rules" using this type of completion are different from the automatic one. Now, you must place the ":" right after "solid" and it can't be separated by spaces. Also, now you don't have a minimum of character, you have a maximum. Ex: lets say you set that maximum to 5 characters; if you try to perform completion on the nick "|[Rammstein]|" using "rammstein", the completion won't be performed, because "rammstein" has 9 characters, so it exceeds the maximum of 5. You'll have to type only "ramm" or "ramms" in order to execute the completion.

Big note: be carefull using this feature, it may perform nick completation on words that aren't meant to be matched, and your message will be sent messed up.

One more big note: you can use both manual and automatic completion on the same message: Ex: lets say you want to perform manual completion to "XMASTER" and automatic completion to "SolidSnake". You'll type:

x: I really want to kill solid !

And the output shall be:

XMASTER: I really want to kill SolidSnake !

Toolbar

Here you can setup a custom toolbar, replacing the mIRC's default one. The list you see displays each item present in the toolbar, which can be either a button or a separator. Bellow the list, there's a couple of editboxs where you can define each item. For buttons, you can specify an icon, a name and a command to be executed when you click the button. Separatores don't need any of this. To manipulate the list, there is a popup menu that can be displayed by right-clicking the list, or by clicking the "options" button. The following is the description of each option present at this menu:

Add

Adds a new item to the list, using the settings specified at the editboxes bellow.

Remove

Removes the selected item from the list.

Save to selected item

Saves the settings specified in the editboxes bellow the list into the selected item in it.

Move up

Moves the selected item up. This will change the order of the items in the toolbar.

Move down

Moves the selected item down. This will change the order of the items in the toolbar.

Clear toolbar

Clears the list of items.

Defaults

Sets the items list back to its default items.

Show connect/disconnect item

Adds a button to the beginning of the toolbar that will connect/disconnect to/from a server.

Show MP3 player controls

Adds buttons to the end of the toolbar that offers you control over the playlist of the MP3 player. You can skip to the previous/next song on the playlist, start/stop the playlist, and pause/resume the current song being played.


Systray balloons

This is the place where you can select which systray balloons should be displayed at the triggering of some events. This feature will work only in Microsoft Windows versions 2000, Mellenium and XP. You have a list contaning every event that supports these balloons. You can select which one of them will triggers its respective balloons by marking/unmarking the checkbox that is prefixing each event in the list


Titlebar

This is the place where you can costumise mIRC's titlebar. You can set an appearance to be used while connected and other while disconnected. The titlebar is updated every 1/2 of a second. You can use the following tags to make it displayed updated information:

<downstream> - Your current downstream (in KB per second).
<upstream> - Your current upstream (in KB per second).
<theme> - Your current MTS theme.
<mp3> - MP3 currently being reproduced by the MP3 player.
<lag> - Your current lag.
<cid> - Active connection ID.
<network> - Network of the active connection ID.
<server> - Server address of the active connection ID.
<mirctime> - Time elapsed since mIRC was started
<online> - Time elapsed since you connected to the active server
<idle> - Time elapsed since you last typed anything in any editbox
<lt> - the "less than" character.
<gt> - the "greater than" character.

Spell checker

Here you can set a list of words that should be replaced for whatever text you want while you're chating with other people. The list you see contains the words to be replaced followed by the text which will replace them. To edit this list, use the popup menu that can be displayed when right-clicking on the list, or when clicking the "options" button. The following is a description of each option available at this menu

Add

Adds a word to be replaced and its respective text to be replaced by

Edit

Edits the select word to be replaced and its respective text to be replaced by

Remove

removes the select word to be replaced and its respective text to be replaced by

Clear

Clears the entire content of the list

Defaults

Resets the content of the list to its defaults

Display first letter in upper case

Displays the first letter of your messages in upper case when sent to its target

Append period to the end of the text

Appends a period mark to the end of your message when sent to its target


psyBNC

Here you can configure the script to make your login to your psyBNC automatically, by supplying your psyBNC server, port, and account(s). Your accounts can be stored at the list bellow. To edit this list, you can use a popup menu that can be displayed when you right-click on the list, or when you click on the "options" button. The following is a description of each option available at this menu

Add

Adds a new account into the list

Edit

Edits the selected account in the list

Remove

Removes the selected account from the list

Clear

Clears the entire content of the list

Set psyBNC trigger

Here you can set a wildcarded text macthing the notice that the psyBNC sends you requesting you to identify with your accounts password. In most cases, you can use "*Please type /QUOTE PASS yourpassword to connect*"

Set identification command

Here you set the command that identifies you to the psyBNC, usually it is "/quote pass <pass>". Use the <pass> tag to refer to the account's password

Secondly, You can set menus dedicated to your psyBNC This script already comes with a psyBNC menu, but you might want to costumize it, or make your own. To do that, you'll have to do 2 things: first, learn something about mIRC's popups and how to edit them (or try to understand the psyBNC menu that comes with the script, you can find it in the script's folder "Popups", name "psyBNC.ap"). You might want to read the mIRC's help. So go for it........................ Have you done it already? OK, nice. Now, lets say you'll want to make your own menu. Lets say you want to put a menu in the menubar (you know, that menu that says "AnacųnŠa"). You'll create a text file named bnc.ap. Next, you have to edit it. Since you want to insert the menu on the menubar, you will write:

[menubar]

You'll also want to make organized popups, so, for BNC commands that add, delete and list information, you can make the menu like this:

[menubar]
Add
Delete
List

And now, you'll want to write the commands. Lets say that you want to add the commands that adds/deletes/lists servers, auto-ops and bans. You'll write something like this:

[menubar]
Add
.Server: /addserver $$?="Server:" : $+ $$?="Port:"
.Auto op: /ADDAUTOOP #$$?="Channel:" : $+ $$?="Hostmask:"
.Ban: /ADDBAN $$?="Reason:" : $+ $$?="Hostmask:"
Delete
.Server: /delserver $$?="Number:"
.Auto op: /delautoop $$?="Number:"
.Ban: /delban $$?="Number:"
List
.Server: /listservers
.Auto op: /listautoops
.Ban: /listbans

Since you've learn how to write mIRC popups, you have no problems understanding this quick and small example. When you're finished, you'll have to add the filenames path to the field "Command Menus".

Additially, You can start a new psyBNC session using the "connect" button. If you mark "new connection" before clicking that button, the psyBNC session will take place in a new connection ID rather then in the active one.

After you had setup everything, you just have to use the /connectbnc command to automatically connect and login to your psyBNC. If you have the script's toolbar activated and the connect/disconnect button enabled, you can also click on the arrow pointing down to display a menu with networks. The last item on that menu, is a submenu containing all the accounts you have added to the list. Select the one you want to use to connect and login to the psyBNC


Auto-connect

Here you can set a list of servers to connect at startup. Required paramaters for each server are only its address and port. Everything else is optional (unless of course, the server requires a password). If you leave blank the nickname, alternative nickname, E-mail and full name while adding a server, the script will use the values stored at mIRC's options dialog box. To edit this list, you have a popup menu that can be displayed by right-clicking the list, or pressing the "options" button. The following is a description of each options contained in this menu

Add

Adds a new server into the list

Edit

Edits the selected server in the list

Remove

Removes the selected server from the list

Clear

Clears the entire content of the list

Additially, You can connect to a selected server using the "connect" button. If you mark "new connection" before clicking that button, a new connection ID will be opened.


Messages

This is where you can edit the messages sent by the /bandwidth, /timestatus and /winampshow commands, as well as the kick counter display. All messages can use tags in order to display updated information. The following are the discriptions of each tag, grouped by the messages that use them

Bandwidth

<dstream> - Your downstream, in KB/s units
<ustream> - Your upstream, in KB/s units

Time status

<uptime> - Time elapsed since your computer was activated
<mirctime> - Time elapsed since mIRC was started
<ontime> - Time elapsed since you connected to the active server
<idletime> - Time elapsed since you last typed anything in any editbox
<localtime> - Your local time
<date> - Your current date

Winamp advertisement

<title> - Songs's name
<artist> - Songs's author/band
<album> - Album where the music was taken from
<channels> - The audio channels available (Stereo or Mono)
<filename> - Filename of the song, with no path
<path> - Path for the filename of the song
<bitrate> - Bitrate of the song, in kbps units
<sample> - Song's sample, in khz units
<length> - The length of the song
<pos> - Current position relative to the length
<size> - Size of the file, in bytes units
<version> - Winamp's version

Kick counter

<msg> - Your kick message
<kicks> - Number of kicks you performed from the the last time the /reset -k or /resetall was used until now

The following tags are available to all messages:

<lt> - the "less than" character.
<gt> - the "greater than" character.

Miscellaneous

Here you can set some minor options that don't fit in any of the sections documented above. Each one of these options can be enabled/disabled by marking/unmarking their checkboxes.

Use kick-counter

When you kick users from channels, the total number of kicks performed will be appended to the kick message. You can set up the layout of the counter at the Messages section

Get news on connect

Connects to the website and get the latest news on AnacųnŠa. This will only work if the sockets module is loaded. You can load/unload it at the Modules section

Check for new version on connect

Connects to the website and know if there is an update to AnacųnŠa. This will only work if the sockets module is loaded. You can load/unload it at the Modules section

On join/part/kick/quit, notify on queries

If you have a query opened with a user that has joined/parted/quitted/been kicked from a channel, you can set the script to display a short notice in the user's query notifing you about the join/part/kick

Close queries on users quit/unotify/chat

If you have a query opened with a user that has quit or opened a DCC chat, you can set the script to close the query automatically

Enable mIRC version warning at startup

Finally, you can choose whether or not you want the script to warn you if you're using a version of mIRC that wasn't meant to run the script under it, at startup.