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

m (Bot: Fixing compatibility)
Line 1: Line 1:
The '''ON ACTION''' event monitors {{mIRC|/me}} action events inside of a channel, or a query window.
+
The '''ON ACTION''' event triggers on an action ({{mIRC|/me}} or {{mIRC|/describe}}) events inside of a channel, or a query window.
  
 
== Synopsis ==
 
== Synopsis ==
Line 5: Line 5:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger. For instance if a user has an access level of 10, but this event triggers at level 15, the event would not fire.
+
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
  
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text to match in the event. This can be a single wildcard, '''*''', for all matches or wildcard matches in general, such as: '''*end''' In this case, the event looks for any text ending in '''end'''.
+
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text to match in the event.
  
 
<span style="display: inline-block; width: 105px;">'''<*><?><#[,#]>'''</span>The place, or places where the event listens.
 
<span style="display: inline-block; width: 105px;">'''<*><?><#[,#]>'''</span>The place, or places where the event listens.
  
<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 window</div>
+
<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>
  
<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>Query windows</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>Any query windows</div>
  
<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</div>
+
<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>
 
<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>

Revision as of 17:31, 23 July 2014

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 level for the event to trigger.

<matchtext>The text to match in the event.

<*><?><#[,#]>The place, or places where the event listens.

*Any query/channel window
?Any query windows
#Any channel window
[,#]Specific channel names

<commands>The commands to be performed when the event listener's criteria is met.

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