From WikiChip
mirc/on events/on action
< mirc‎ | on events
Revision as of 01:40, 24 June 2014 by Zmodem (talk | contribs) (See Also)

The ON ACTION event monitors /me action events inside of a channel, or a query window.

Synopsis

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

Parameters

ONTurns on the event listener.

<level>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.

ACTIONThe specific event to be listened for; in this case the ACTION event.

<matchtext>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.

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

<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/08/95

See Also