Scripting » History » Revision 181
Revision 180 (Per Amundsen, 02/07/2014 10:40 AM) → Revision 181/246 (Per Amundsen, 02/07/2014 10:41 AM)
h1. Scripting changes as of 1.9.1
[[Scripting Events|Implemented mIRC events so far]]
<pre>
raw <numeric>:<matchtext>:<commands>
ctcp <level>:<matchtext>:<*|#|?>:<commands>
on 1:sockopen:name:commands
on 1:sockread:name:commands
on 1:socklisten:name:commands
on 1:sockclose:name:commands
on *:SIGNAL:name:command
on <level>:LOGON:*:<commands>
on <level>:DNS:<commands>
on <level>:CTCPREPLY:<matchtext>:<commands>
on <level>:OPEN|CLOSE:<?|@|=|!|*>:<matchtext>:<commands>
on <level>:ACTIVE:<*#?=!@>:<commands>
on <level>:HOTLINK:<matchtext>:<*#?=!@>:<commands>
on <level>:INVITE:<#[,#]>:<commands>
on <level>:TABCOMP:<*#?=!@>:<commands>
on <level>:WALLOPS:<matchtext>:<commands>
on <level>:ERROR:<matchtext>:<commands>
on <level>:RAWMODE:#:<commands>
on <level>:DEHELP:<#[,#]>:<commands>
on <level>:HELP:<#[,#]>:<commands>
on <level>:DEVOICE:<#[,#]>:<commands>
on <level>:VOICE:<#[,#]>:<commands>
on <level>:DEOP:<#[,#]>:<commands>
on <level>:OP:<#[,#]>:<commands>
on <level>:INPUT:<*#?=!@>:<commands>
on <level>:UNBAN:<#[,#]>:<commands>
on <level>:BAN:<#[,#]>:<commands>
on <level>:CHAT:<matchtext>:<commands>
on <level>:KICK:<#[,#]>:<commands>
on <level>:NOTIFY:<commands>
on <level>:UNNOTIFY:<commands>
on <level>:NICK:<commands>
on <level>:QUIT:<commands>
on <level>:LOAD:<commands>
on <level>:UNLOAD:<commands>'
on <level>:START:<commands>
on <level>:EXIT:<commands>
on <level>:DNS:<commands>
on <level>:CONNECTFAIL:<commands>
on <level>:CONNECT:<commands>
on <level>:DISCONNECT:<commands>
on <level>:TOPIC:<#[,#]>:<commands>
on <level>:USERMODE:<commands>
on <level>:MODE:<#[,#]>:<commands>
on <level>:PART:<#[,#]>:<commands>
on <level>:JOIN:<#[,#]>:<commands>
on <level>:SNOTICE:<matchtext>:<commands>
on <level>:NOTICE:<matchtext>:<*><?><#[,#]>:<commands>
on <level>:ACTION:<matchtext>:<*><?><#[,#]>:<commands>
on <level>:TEXT:<matchtext>:<*><?><#[,#]>:<commands>
This event is added as a replacement for OnSongChanged
on <level>:SONG:<commands>
</pre>
Supported prefixes so far are ^ to enable halt events (hide default text output from the event), ! to ignore events made by you, @ to only trigger if you have channel op, $ to indicate the wildcard text is a regular expression.
User access will come later.
h1. identifiers added so far
<pre>
$0
$active
$activecid
$activeserver
$activewid
$adate
$address
$adiircdir
$adiircexe
$adiircini
$album
$anick
$appactive
$appbits
$appstate
$artist
$asctime
$audio
$away
$awaymsg
$awaytime
$beta
$bitrate
$bits
$builddate
$bwdown
$bwdownb
$bwname
$bwrec
$bwsent
$bwspeed
$bwup
$bwupb
$cb
$chan
$chanmodes
$channel
$channelbar
$chantypes
$cid
$clevel
$cmdline
$comerror
$comment
$cpucache
$cpucount
$cpuident
$cpuload
$cpumhz
$cpuname
$cpuvendor
$cr
$crlf
$ctime
$date
$day
$daylight
$dccport
$ddename
$disk
$diskfree
$disktotal
$dlevel
$docked
$dotnet
$duration
$error
$event
$false
$feof
$ferr
$frequency
$fulladdress
$fulldate
$fullscreen
$fulltitle
$genre
$getdir
$gfx
$gfxram
$gmt
$highlight
$host
$ial
$ident
$idle
$ifmatch
$ifmatch2
$ignore
$inmidi
$inpaste
$insong
$inwave
$ip
$isid
$lactive
$lactivewid
$lag
$layer
$left
$length
$lf
$locked
$logdir
$logstamp
$logstampfmt
$ltimer
$maddress
$matchkey
$me
$memfree
$memfreep
$memtotal
$menubar
$mircdir
$mircexe
$mircini
$mnick
$mode
$modespl
$motherboard
$mouse
$mversion
$myhost
$myident
$network
$newnick
$nick
$nickmode
$now
$null
$numeric
$online
$os
$osbuild
$osedition
$osinstalldate
$osmajor
$osminor
$osname
$osservicepack
$osversion
$percentl
$percentp
$pi
$playcount
$player
$port
$portable
$position
$prefix
$progress
$quitmessage
$randomcolors
$rating
$rawbytes
$rawmsg
$realname
$remote
$result
$screen
$screenb
$screenh
$screenw
$script
$scriptdir
$scriptline
$server
$serverip
$show
$sidebar
$site
$size
$snicks
$sockbr
$sockerr
$sockname
$song
$ssl
$sslready
$status
$statusbar
$switchbar
$target
$ticks
$time
$timestamp
$timestampfmt
$timezone
$title
$toolbar
$totaltracks
$track
$treebar
$true
$ulevel
$updays
$uphours
$upmins
$usermode
$v1
$v2
$version
$volume
$volumeb
$volumep
$wid
$wildsite
$window
$year
$0
$abs
$acos
$active
$activecid
$activeserver
$activewid
$adate
$address
$addtok
$addtokcs
$adiircdir
$adiircexe
$adiircini
$adilang
$album
$and
$anick
$appactive
$appbits
$appstate
$artist
$asc
$asctime
$asin
$atan
$audio
$away
$awaymsg
$awaytime
$base
$beta
$bfind
$bindip
$bitoff
$biton
$bitrate
$bits
$builddate
$bvar
$bwdown
$bwdownb
$bwname
$bwrec
$bwsent
$bwspeed
$bwup
$bwupb
$bytes
$calc
$cb
$ceil
$chan
$chanmodes
$channel
$channelbar
$chantypes
$chat
$chr
$cid
$clevel
$cmdline
$cnick
$color
$colour
$com
$comchan
$comerror
$comment
$cos
$count
$countcs
$cpucache
$cpucount
$cpuident
$cpuload
$cpumhz
$cpuname
$cpuvendor
$cr
$crc
$crlf
$ctime
$date
$datediff
$datematch
$day
$daylight
$dccport
$ddename
$decode
$decrypt
$deltok
$dialog
$did
$didreg
$didtok
$didwm
$disk
$diskfree
$diskmenu
$disktotal
$dlevel
$dll
$dllcall
$dns
$docked
$dotnet
$duration
$editbox
$encode
$encodingmenu
$encrypt
$error
$event
$exists
$false
$feof
$ferr
$fgetc
$file
$finddir
$findfile
$findtok
$findtokcs
$fline
$floop
$floor
$fopen
$frand
$fread
$frequency
$fulladdress
$fulldate
$fullscreen
$fulltitle
$genre
$get
$getdir
$getdot
$gettok
$gfx
$gfxram
$gmt
$group
$height
$hfind
$hget
$highlight
$host
$ial
$ialchan
$ibl
$ident
$idle
$iel
$ifmatch
$ifmatch2
$ignore
$iil
$inellipse
$ini
$inmidi
$inpaste
$inpoly
$input
$inrect
$insert
$insong
$instok
$int
$invitemenu
$inwave
$ip
$iptype
$isalias
$isbit
$isdir
$isfile
$isid
$islower
$istok
$istokcs
$istype
$isupper
$lactive
$lactivewid
$lag
$layer
$left
$len
$length
$lf
$line
$lines
$lock
$locked
$lof
$log
$logdir
$logstamp
$logstampfmt
$longfn
$longip
$lower
$ltimer
$maddress
$mask
$matchkey
$matchtok
$matchtokcs
$md5
$me
$memfree
$memfreep
$memtotal
$menubar
$mid
$mircdir
$mircexe
$mircini
$mkfn
$mklogfn
$mknickfn
$mnick
$mode
$modespl
$motherboard
$mouse
$mp3
$msfile
$mversion
$myhost
$myident
$network
$newnick
$nick
$nickmode
$nofile
$nopath
$noqt
$not
$notify
$now
$null
$numeric
$numtok
$online
$or
$ord
$os
$osbuild
$osedition
$osinstalldate
$osmajor
$osminor
$osname
$osservicepack
$osversion
$percentl
$percentp
$pi
$pic
$playcount
$player
$port
$portable
$portfree
$pos
$poscs
$position
$prefix
$progress
$prop
$puttok
$qt
$query
$quitmessage
$r
$rand
$randomcolors
$rating
$rawbytes
$rawmsg
$read
$readini
$realname
$regex
$regml
$regsub
$regsubex
$remote
$remove
$removecs
$remtok
$remtokcs
$replace
$replacecs
$replacex
$replacexcs
$reptok
$reptokcs
$result
$rgb
$right
$round
$scid
$scon
$screen
$screenb
$screenh
$screenw
$script
$scriptdir
$scriptline
$sdir
$send
$server
$serverip
$sfile
$sha1
$shortfn
$show
$sidebar
$sin
$site
$size
$slapsmenu
$sline
$snick
$snicks
$sock
$sockbr
$sockerr
$sockname
$song
$sorttok
$sorttokcs
$sqrt
$ssl
$sslready
$status
$statusbar
$str
$strip
$style
$submenu
$switchbar
$tan
$target
$ticks
$time
$timer
$timestamp
$timestampfmt
$timezone
$tip
$title
$token
$toolbar
$totaltracks
$track
$treebar
$true
$trust
$ulevel
$updays
$uphours
$upmins
$upper
$uptime
$url
$user
$usermode
$utfdecode
$utfencode
$v1
$v2
$var
$version
$vol
$volume
$volumeb
$volumep
$wid
$width
$wildsite
$wildtok
$wildtokcs
$window
$xor
$year
</pre>
All operaters are added.
h1. Example scripts
Simple kickcounter script:
<pre>
alias kick {
if (!%kickcount) %kickcount = 0
inc %kickcount
if (!$3) {
kick # $$2 Kick number %kickcount
halt
}
}
</pre>
Kickban example
<pre>
alias kb {
if (!$1) {
echo /kb - Nick missing
return
}
var %msg = $iif(#, $2-, $3-)
var %chan = $iif(#, #, $2)
; Set this for default ban reason, or remove for no default reason
; Can be shortened to %msg = $iif(%msg, %msg, GTFO)
if (!%msg) %msg = GTFO
if ($me isop %chan) {
MODE %chan +b $wildsite
KICK %chan $1 %msg
}
else echo You are not oper on %chan
}
</pre>
Simple calculator script:
<pre>
alias calc {
if (!$1) {
echo /calc - Parameters missing
return
}
; typing /calc -p <expression> sends output to channel
if ($1 == -p) {
msg # Calculating : $2-
msg # Result is : $calc($2-)
} else {
echo Calculating : $1-
echo Result is : $calc($1-)
}
}
</pre>
Colored version
<pre>
alias calc {
if (!$1) {
echo /calc - Parameters missing
return
}
# typing /calc -p <expression> sends output to channel
if ($1 == -p) {
msg # $chr(3)4Calculating : $2-
msg # $chr(3)4Result is : $calc($2-)
} else {
echo $chr(3)4Calculating : 4$1-
echo $chr(3)4Result is : $calc($1-)
}
}
</pre>
CTCP flood detection example
<pre>
CTCP *:*:*:{
if (!%count) set -u10 %count 1
else inc -u10 %count 1
if (%count > 4) ignore -tu30 $wildsite
}
</pre>
Mass mode example
<pre>
alias mass {
if (!$2) {
echo /mass - Parameters missing [+/-<mode> <nick> <nick> <nick>]
return
}
%len = 2
; equal to while (%len <= $count(%1-, $chr(32)))
while (%len <= $0) {
if ($(%len) ison #) mode # $1 $($ $+ %len)
inc %len
}
}
</pre>
Shows info about servers, channels and users
<pre>
on *:JOIN:#: {
var %s = $scon(0), %c = 0, %u = 0, %t = 0, %c2 = 0;
while (%t < %s) {
inc %t
scon $scon(%t);
inc %c $chan(0)
%c2 = 0
while (%c2 < $chan(0)) {
inc %c2
inc %u $user($chan(%c2), 0)
}
}
/echo You are on ( $+ %s $+ ) servers, ( $+ %c $+ ) channels with ( $+ %u $+ ) users
}
</pre>
It is possible to use scripts as functions.
These functions are fully nested like the client functions.
Lets say you make a /mycalc like this.
<pre>
alias mycalc {
return $calc($$1 + $$2);
}
</pre>
Then you can call this function with eiter /mycalc <number> <number> the normal way or $mycalc(<number, <number>)
Typing /testcalc will show the result.
<pre>
alias testcalc {
echo -a $1 + $2 is $mycalc($1, $2);
echo -a 5 + 4 is $mycalc(5, 4);
}
</pre>
Simple convert temperature C to F or F to C
/temp C 20 will print 68 F
<pre>
alias temp {
if ($1 == C) echo $calc(($2 * 9/5) + 32) F
else if ($1 == F) echo $round($calc(($2 - 32) * 5/9), 1) C
else echo Temp missing
}
</pre>
Announce song changes in a channel or to a user
<pre>
On *:SONG:{
nmsg <network> <channel/Nick> $1-
}
</pre>
Announce to several channels with:
<pre>
On *:SONG:{
nmsg <network> <channel1/Nick>,<channel2/Nick> $1-
nmsg <network2> <channel3/Nick> $1-
}
</pre>
Automatically find the summary of a imdb url
<pre>
On *:TEXT:*:#k: {
var %reg = $regex($1-, http://www\.imdb\.com(/title/[a-z0-9]+/))
if (!%reg) { return }
sockclose imdb
unset %data
%imdb = $regml(1) $+ plotsummary
%imdbchan = #
sockopen imdb www.imdb.com 80
}
on *:sockopen:imdb: {
sockwrite -n imdb GET %imdb HTTP/1.1
sockwrite -n imdb Host: www.imdb.com
sockwrite -n imdb User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/536.5 (KHTML, like Gecko) Chrome/19.0.1084.24 Safari/536.5
sockwrite -n imdb Referer: http://www.imdb.com
sockwrite -n imdb Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,video/x-mng,image/png,image/jpeg,image/gif;q=0.2,text/css,*/*;q=0.1
sockwrite -n imdb Accept-Language: en-us, en;q=0.50
sockwrite -n imdb Connection: Close $+ $crlf $+ $crlf
}
on *:sockread:imdb:{
sockread %text
%data = %data $+ %text
}
on *:sockclose:imdb: {
if ($regex(%data, <p class="plotpar">([\s\S]*?)<i>)) {
msg %imdbchan $regml(1)
}
unset %data
}
</pre>
h1. More information
You can find many mIRC scripts at places such as http://www.mircscripts.com/ and http://www.mircscripts.org/
Not everyone will work, if you find one that dosen't, please open a new issue with a link to the script.
For more on mIRC scripting and how it works, check out http://www.zigwap.com/mirc/docs/ and http://www.mirc.org/mishbox/index.htm