From WikiChip
mirc/on events/on dccserver
< mirc‎ | on events
Revision as of 17:17, 6 February 2016 by Ouims (talk | contribs) (Parameters)

Template:mIRC Guide The ON DCCSERVER event triggers a connection attempt is made on mIRC's DCC Server. This event allows easy monitoring of connections and the ability to prevent someone from connecting to mIRC by invoking the /halt command.

When triggered by a Send, this event fills the $filename identifier with the file name attempting to be received.

Synopsis

ON <level>:DCCSERVER:<Chat|Send|Fserve>:<commands>

Parameters

  • <level> - The corresponding access levels for the event to trigger.s
  • <Chat|Send|Fserve> - The text that to be matched. Can also be a wildcard.
    • Chat - Triggers if the event is caused by a DCCSERVER Chat.
    • Send - Triggers if the event is caused by a DCCSERVER Send.
    • Fserve - Triggers if the event is caused by a DCCSERVER Fserve.
  • <commands> - The commands to be performed when the event listener's criteria is met.

Examples

Echo to the active screen some information when a dcc send is being received:

ON *:DCCSERVER:Send:echo User $nick ( $+ $address $+ ) is attempting to send: $filename

The ON DCCSERVER event can also prevent certain events from happening, based on a certain criteria. For instance, the following event will decline a dcc send if the file extension is .exe:

ON *:DCCSERVER:Send:if ($right($filename,4) == .exe) { echo -a User $nick just tried to send a file with an .exe extension. It has been declined. | halt }

The use of the halt command in this instance prevents any further action, even from any confirmation windows from popping up. The halt command can also be used on the other ON DCCSERVER events to prevent anything from happening.

Echo when a user attempts to initiate a DCC Chat:

ON *:DCCSERVER:Chat:echo User $nick ( $+ $address $+ ) is attempting to initiate a DCC Chat.

Compatibility

Added: mIRC v5.3
Added on: 13 Dec 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also