Project

General

Profile

Scripting » History » Version 11

Per Amundsen, 04/01/2011 06:32 PM

1 1 Per Amundsen
h1. Scripting
2
3
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.
4
5 8 Per Amundsen
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.
6 1 Per Amundsen
7 2 Per Amundsen
As of build 010411.
8 1 Per Amundsen
9
In Commands -> Edit Commands you can enter a scripting line with the following syntax:
10
11
The line must start with <pre>OnEvent<whitespace></pre>
12
13
Followed by either an expression like this (works recursivly)
14
15
<pre>
16
if (SOMETING == SOMETHINGELSE) { EXECUTE HERE }
17
if (SOMETING != SOMETHINGELSE) { EXECUTE HERE }
18 11 Per Amundsen
if (SOMETING ismatch SOMETHINGELSE) { EXECUTE HERE }
19 1 Per Amundsen
</pre>
20 11 Per Amundsen
(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)
21
22 1 Per Amundsen
or by an executed command or function
23
24 2 Per Amundsen
You can now combine expressions with && (AND) and || (OR) like this
25
<pre>
26
if (SOMETHING == SOMETHING && SOMETHINGELSE != SOMETHINGELSE) { EXECUTE HERE }
27
if (SOMETHING == SOMETHING || SOMETHINGELSE != SOMETHINGELSE) { EXECUTE HERE }
28
</pre>
29
The logic behind these expressions is not fully tested, id love any feedback on this.
30
31 1 Per Amundsen
Executed commands are /slash commands already in the client e.g /msg #channel hello world.
32
Executed functions are predefined functions in the client, only two exists for now.
33
34
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>
35
36
Furthermore there is a lot of predefined variables for use with these functions, for now they are:
37
38
$event / current event, e.g PRIVMSG 001 MODE and so forth
39
$channel / the channel the event occurred on, if any
40
$msg / the message to the channel/user or the message in a raw irc line e.g whois [kr0n] is a registered nick
41
$nick / the nick the event was sent from, can be a irc.server.com, a nick or null
42
$me / my current nick
43
$network / the network the event occured on e.g Quakenet
44
$ident / the from user ident if any
45
$host / the from user hostname if any
46
$myident / my ident
47
$myhost / my host
48
49
Currently predefined functions are:
50
<pre>
51
.insert requires .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>
52
</pre>
53
54
<pre>
55
.eat <what (text or all)>
56
</pre>
57
.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.
58
59
.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.
60
61
Putting it all togheter, here are a few examples:
62
63
<pre>
64 2 Per Amundsen
OnEvent if ($event == NOTICE) { if ($msg ismatch hi there) { .insert $nick status MsgNotice $msg|.eat text } }
65 1 Per Amundsen
</pre>
66
67
insert the notice into the server window and tells adiirc to "eat" its own text output from this notice
68
69
<pre>
70 5 Per Amundsen
OnEvent if ($event == PRIVMSG && $msg == herp) { /msg $channel derp } }
71 1 Per Amundsen
</pre>
72
73 7 Per Amundsen
if the event is a PRIVMSG AND the $msg equals "herp", then show "derp" in the channel
74 1 Per Amundsen
75
<pre>
76 6 Per Amundsen
OnEvent if ($event == PRIVMSG) { if ($nick == Q || $nick == $me) { /msg $channel Q or $me is speaking! } }
77 1 Per Amundsen
</pre>
78
79 9 Per Amundsen
if the event is a PRIVMSG and the $nick equals "Q" OR $me then show "Q or $me is speaking" in the channel
80 3 Per Amundsen
81 4 Per Amundsen
A list of custom events that is also usable as $event ==
82 3 Per Amundsen
<pre>
83
OnOwner
84
OnDeOwner
85
OnSpecialOp
86
OnSpecialDeOp
87
OnOp
88
OnDeOp
89
OnHop
90
OnDeHop
91
OnVoice
92
OnDeVoice
93
</pre>