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

(See Also)
 
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The '''ON ACTION''' event monitors [[/me command - mIRC|/me]] action events inside of a channel, or a query window.
+
{{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.
  
 
== Synopsis ==
 
== Synopsis ==
Line 5: Line 6:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 105px;">'''ON'''</span>Turns on the event listener.
+
* '''<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;">'''<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.
+
* '''<*><?><#[,#]>''' - 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;">'''ACTION'''</span>The specific event to be listened for; in this case the '''ACTION''' event.
+
** '''?''' - Any query windows
 
+
** '''#''' - Any channel window
<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'''.
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<span style="display: inline-block; width: 105px;">'''<*><?><#[,#]>'''</span>The place, or places where the event listens.
 
 
 
<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 23: 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 31: Line 28:
  
 
== Compatibility ==
 
== Compatibility ==
Added: mIRC v3.5
+
{{mIRC compatibility|3.5}}
 
 
Added On: 07/08/95
 
  
 
== See Also ==
 
== See Also ==
 
* [[List of on events - mIRC|mIRC Events]]
 
* [[List of on events - mIRC|mIRC Events]]
  
[[Category:mIRC on events]]
+
[[Category:mIRC on events|action]]

Latest revision as of 14: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]