From WikiChip
Difference between revisions of "mirc/on events/on action"
< mirc‎ | on events

(Parameters)
Line 6: Line 6:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
+
* '''<level>''' - The corresponding {{mIRC|access level}} for the event to trigger.
 
+
* '''<matchtext>''' - The corresponding {{mIRC|on text|matchtext}} for the event to trigger.
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text to match in the event.
+
* '''<*><?><#[,#]>''' - The place, or places where the event listens.
 
+
** '''*''' - Any query/channel window
<span style="display: inline-block; width: 105px;">'''<*><?><#[,#]>'''</span>The place, or places where the event listens.
+
** '''?''' - Any query windows
 
+
** '''#''' - Any channel window
<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''*'''</span>Any query/channel window</div>
+
** '''#channel''' - A specific channel
 
+
** '''[,#]''' - more channels
<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''?'''</span>Any query windows</div>
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''#'''</span>Any channel window</div>
 
 
 
<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''[,#]'''</span>Specific channel names</div>
 
 
 
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
 
  
 
== Examples ==
 
== Examples ==

Revision as of 18:02, 21 January 2016

Template:mIRC Guide The ON ACTION event triggers on an action (/me or /describe) events inside of a channel, or a query window.

Synopsis

ON <level>:ACTION:<matchtext>:<*><?><#[,#]>:<commands>

Parameters

  • <level> - The corresponding access level for the event to trigger.
  • <matchtext> - The corresponding matchtext for the event to trigger.
  • <*><?><#[,#]> - The place, or places where the event listens.
    • * - Any query/channel window
    • ? - Any query windows
    • # - Any channel window
    • #channel - A specific channel
    • [,#] - more channels
  • <commands> - The commands to be performed when the event triggers

Examples

Listens for if anyone uses the word slap anywhere in an action inside of any channel

ON *:ACTION:* slap *:#:msg # $nick $+ ! Why would you slap anyone?!?!?

The above code listens for the action event, looks for if the user used the word slap in any channel, and then responds accordingly.

Note: The wildcard search, with a space between them and the word, means this event will not trigger if any other characters are touching the word slap. This includes words such as: slaps, slapper, myslap, etc.

Listen for any action inside of a private message and responds

ON *:ACTION:*:?:msg $nick Well, I have no idea why I'm responding to this automatically, $nick $+ . You said: $1-

This code will listen for any action event in a private message, and respond with a silly message.

Compatibility

Added: mIRC v3.5
Added on: 07 Aug 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also