Scripting » History » Revision 43
Revision 42 (Per Amundsen, 10/25/2011 06:21 PM) → Revision 43/246 (Per Amundsen, 10/25/2011 06:22 PM)
h1. Notice: this is info for 1.8.8 and higher.
h1. Scripting
In the latest beta's, I am experimenting with a little more advanced scripting features and I will use this wiki to track progress and features.
Syntax, variables and functions will probably change a lot, so don't except previous scripts to still work in the next beta and so forth.
As of build 130411.
There are 2 types of scripting at the moment, one that have been here for a long time, and a new system.
All scripting is done in Commands -> Edit Commands where one line represent a script or a custom command and its trigger is one of 3 ways:
/something<whitespace>
keys<whitespace>
OnEvent<whitespace>
Please note that variables and functions are *different* for these 2 types of scripts.
You can comment out a command by putting a # in front of it.
h1. Normal custom commands:
<pre>Syntax = /something<whitespace>/somethingelse</pre>
Here are some variables which can be used in Custom Commands, its like creating aliases of already available commands, e.g <pre>/hi /me says hi to $chan</pre> will show <pre>* kr0n says hi to #adiirc</pre> when typing <pre>/hi</pre>
Current variables are $1 to $9, $params, $chan and $me. $1 to $9 represents what you type after /yourcommand e.g <pre>/sup /say whats up $1</pre> when typing <pre>/sup kr0n</pre> it will show like this <pre>User: whats up kr0n</pre>
$params represents everything written after /yourcommand, $chan replaces itself with current channel and $me replaces itself with your current usernick.
You can make combo commands by using | as a seperator, e.g <pre>/hi /me says hi to $chan|/me says hi again to $chan</pre>
$file[path] returns data from a file, $frand[path] fetchs a random line from a file and $floop[path] gets one line increasingly (line1, then line2, then line3 etc).
h1. Custom Commands by hotkeys
<pre>Syntax = key&key<whitespace>/something</pre>
In addition to making a custom command trigger by typing a /slash command, you make it trigger with a hotkey instead (note, these commmands will not be useable from the new scripting engine)
Useable modifies are ctrl, alt and shift and any character or number or F key.
An example
<pre>ctrl&o /msg $chan ohai i just pressed ctrl and o</pre>
Everytime you press ctrl and 'o' now, this command will be fired off.
<pre>ctrl&alt&o /msg $chan ohai i just pressed ctrl and alt and o</pre>
Everytime you press ctrl and alt and 'o' now, this command will be fired off.
h1. Unified Scripting
<pre>Syntax = OnEvent<whitespace>code</pre>
The new scripting tries to combine normal client commands, your custom commands, functions and events into one scripting language.
In Commands -> Edit Commands you can enter a scripting line with the following syntax:
Followed by either an expression like this (works recursivly)
<pre>
if (SOMETING == SOMETHINGELSE) { EXECUTE HERE }
if (SOMETING != SOMETHINGELSE) { EXECUTE HERE }
if (SOMETING ismatch SOMETHINGELSE) { EXECUTE HERE }</pre>
or by an executed command or function
You can now combine expressions with && (AND) and || (OR) like this
<pre>
if (SOMETHING == SOMETHING && SOMETHINGELSE != SOMETHINGELSE) { EXECUTE HERE }
if (SOMETHING == SOMETHING || SOMETHINGELSE != SOMETHINGELSE) { EXECUTE HERE }</pre>
The logic behind these expressions is not fully tested, id love any feedback on this.
It is also possible to use else if like this
<pre>if (SOMETHING == SOMETHING) { EXECUTE HERE } else if (SOMETHINGELSE == SOMETHINGELSE) { EXECUTE HERE }</pre>
In the future just "else" will be possible to.
(note: ismatch will check if SOMETHING exist inside SOMETHINGELSE e.g if something is "hello" and something else is "hello world" it would return True because "hello" exist)
Executed commands are /slash commands already in the client e.g /msg #channel hello world.
Executed functions are predefined functions in the client, only two exists for now.
An execution block can consist of both commands and functions if seperated by | (pipe) character like this <pre>/msg #channel hello world|.function bla bla|/msg #channel2 hello world</pre>
Furthermore there is a lot of predefined variables for use with these functions, for now they are:
$event / current event, e.g PRIVMSG 001 MODE and so forth
$channel / the channel the event occurred on, if any
$msg / the message to the channel/user or the message in a raw irc line e.g whois [kr0n] is a registered nick
$nick / the nick the event was sent from, can be a irc.server.com, a nick or null
$me / my current nick
$network / the network the event occured on e.g Quakenet
$ident / the from user ident if any
$host / the from user hostname if any
$myident / my ident
$myhost / my host
$server / host from the server e.g irc.server.com
Currently predefined functions are:
<pre>
.insert <nick (use null for nonick)>
<where (a channel or $channel, a nick or $nick, or status)>
<MsgType (MsgServer/MsgUser/MsgEmote/MsgCTCP/MsgNotice/MsgClient/MsgLog)>
<$msg or message></pre>
<pre>
.eat <what (text or all)></pre>
.insert is used for inserting a specific message type into a chat window, its intended for use in cases where you want to override how adiirc shows a given event, but can also be used for adding additional messages.
.eat is used to tell adiirc to either "eat" the text output from an event or "eat" everything and don't act on this event at all.
Putting it all togheter, here are a few examples:
<pre>
OnEvent if ($event == NOTICE) { if ($msg ismatch hi there) { .insert $nick status MsgNotice $msg|.eat text } }</pre>
insert the notice into the server window and tells adiirc to "eat" its own text output from this notice
<pre>
OnEvent if ($event == PRIVMSG && $msg == herp) { /msg $channel derp }</pre>
if the event is a PRIVMSG AND the $msg equals "herp", then show "derp" in the channel
<pre>
OnEvent if ($event == PRIVMSG) { if ($nick == Q || $nick == $me) { /msg $channel Q or $me is speaking! } }</pre>
if the event is a PRIVMSG and the $nick equals "Q" OR $me then show "Q or $me is speaking" in the channel
<pre>OnEvent if ($event == OnOp && $nick == $me) { /msg $channel Thx for op! }</pre>
if the event is OnOp and the target nick is me, then show "Thx for op!" in the channel
A list of custom events that is also usable as $event ==
<pre>
OnOwner
OnDeOwner
OnSpecialOp
OnSpecialDeOp
OnOp
OnDeOp
OnHop
OnDeHop
OnVoice
OnDeVoice
OnSongChanged</pre>
As of 1.8.10 Beta you can automatically announce song changes in a channel or to a user with:
<pre>
OnEvent if ($event == OnSongChanged) { /nmsg <network> <channel> $msg }
</pre>
Announce to several channels with:
<pre>
OnEvent if ($event == OnSongChanged) { /nmsg <network> <channel> $msg|/nmsg <network> <channel> $msg }
</pre>
Network is the network name where the channel is, e.g NordicIRC, freenode, Quakenet, look at the name of the server window you are connected on, to, to find it.