MIRC script

mIRC script is the scripting language included with mIRC, an IRC client.

Table of contents

1 Primary uses
2 Script storage
3 Items that are scriptable
4 Data storage

4.1 Files
4.2 Binary variables
4.3 Hashes
4.4 Global variables
4.5 Local variables

5 External link

Primary uses

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

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 subprograms. 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-handling scripts. Remotes are called when the event they handle occurs.

Data storage

Files

Scripts can read from and write to files

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)

Hashes

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
Automatically disappear when exiting the alias that created them
Prefixed with % (%VariableName)

External link