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

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 (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 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)

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

Theser codes are in the aliases script format. On the remote script, the commands should be preceeded 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 <= 10) {
    echo -a %x
    inc %x
  }
}

External links

• Links to mIRC scripting websites
• An mIRC scripting wiki