MIRC script

mIRC script is the scripting programming language included with mIRC, a popular Internet relay chat client for Windows.

=Primary uses=

*IRC bots that provide automated IRC channel management, trivia or other games, and other desired functions for chatters *Commands that save typing or otherwise simplify life on IRC (such as automatically identifying as the owner of a nickname)

=Other uses=

*MP3 players *mIRC games

=Script storage=

Scripts are stored in files, usually with a .mrc or .ini file extension. Multiple script files can be loaded at one time.

=Items that are scriptable=

*Aliases are subprogram. Aliases that return a value are known as custom identifiers. Aliases are called from the command line or other parts of a script. *Popups are scripted context menu items. Popups are called when they are selected by the user. *Remotes are event handler scripts. Remotes are called when the event they handle occurs.

==Files==

*Scripts can read from and write to files [$read | write] *Scripts also can copy and delete files. [copy | remove]

==Binary variables==

*Contain unlimited (8192 bytes prior to mIRC 6.1) raw data *Globally accessible via commands and identifiers *Automatically disappear when script returns control to mIRC (and not to another part of a script) *Prefixed with & (&VariableName)

==Hash tables==

*Contain keys (which are identical to binary variables except with no prefix) *Globally accessible via commands and identifiers *Automatically disappear when exiting mIRC *Not prefixed

==Global variables==

*Contain 945 bytes of space-delimited data (variable names use up that space: %a can store up to 944 bytes of data and %ace can store up to 942 bytes of data) *Cannot store NUL (ASCII 0) or consecutive spaces *Globally accessible *Do not automatically disappear (stored automatically in a mIRC initialization file) *Prefixed with % (%VariableName)

==Local variables==

*Contain 945 bytes of space-delimited data (variable names use up that space: %a can store up to 944 bytes of data and %ace can store up to 942 bytes of data) *Cannot store NUL (ASCII 0) or consecutive spaces *Accessible only by the alias that created them *Only existing in the context of the alias that created them *Prefixed with % (%VariableName)

=Code Example=

These codes are in the aliases script format. On the remote script , the commands should be preceded by the word alias .

Here is the Hello World code example:

hello { echo -a Hello }

Here is an example to count to ten:

ten { var %x = 1 while (%x