MIRC script
|
|
- The title of this article is incorrect because of technical limitations. The correct title is mIRC script.
mIRC script is the scripting language included with mIRC, an IRC client.
| Contents |
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 [$read | write]
- Scripts also can copy and delete files. [write -c | copy -o]
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 <= 10) {
echo -a %x
inc %x
}
}
External links
- Links to mIRC scripting websites (http://www.mirc.co.uk/links.html#8)
- An mIRC scripting wiki (http://wiki.scriptsurge.org/)