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

 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{mIRC Guide}}
+
{{mirc title|On Action - Events}}
 
The '''ON ACTION''' event triggers on an action ({{mIRC|/me}} or {{mIRC|/describe}}) 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.
  
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 levels}} 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, you can specify specific name of window, seperate them by comma.
 
+
** '''*''' - 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>
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<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 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 ==
Line 28: Line 20:
 
The above code listens for the action event, looks for if the user used the word ''slap'' in any channel, and then responds accordingly.
 
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.
+
'''Note:''' The {{mirc|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'''
 
'''Listen for any action inside of a private message and responds'''
Line 40: Line 32:
 
== See Also ==
 
== See Also ==
 
* [[List of on events - mIRC|mIRC Events]]
 
* [[List of on events - mIRC|mIRC Events]]
 
{{mIRC on event list}}
 
{{mIRC on event list}}
 
  
 
[[Category:mIRC on events|action]]
 
[[Category:mIRC on events|action]]

Latest revision as of 13:19, 20 October 2018

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

Synopsis[edit]

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

Parameters[edit]

  • <level> - The corresponding access levels for the event to trigger.
  • <matchtext> - The corresponding matchtext for the event to trigger.
  • <*><?><#[,#]> - The place, or places where the event listens, you can specify specific name of window, seperate them by comma.
    • * - Any query/channel window
    • ? - Any query windows
    • # - Any channel window
  • <commands> - The commands to be performed when the event triggers

Examples[edit]

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[edit]

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[edit]