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

(Created On dccserver event - mIRC)
 
(Examples)
Line 24: Line 24:
  
 
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 - mIRC|DCC Send]] if the file extension is [[.exe file type - Windows|.exe]]:
 
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 - mIRC|DCC Send]] if the file extension is [[.exe file type - Windows|.exe]]:
<source lang="mIRC">ON *:DCCSERVER:Send:if ($right($filename,4) == .exe) { halt }</source>
+
<source lang="mIRC">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 }</source>
  
 
The use of the [[/halt command - mIRC|halt command]] in this instance prevents any further action, even from any confirmation windows from popping up. The [[/halt command - mIRC|halt command]] can also be used on the other '''ON DCCSERVER''' events to prevent anything from happening.
 
The use of the [[/halt command - mIRC|halt command]] in this instance prevents any further action, even from any confirmation windows from popping up. The [[/halt command - mIRC|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 - mIRC|DCC Chat]]:
 
Echo when a user attempts to initiate a [[Dcc chat - mIRC|DCC Chat]]:
<source lang="mIRC">ON *:DCCSERVER:Chat:echo User $nick ( $+ $address $+ ) is attempting to initiate a DCC Chat</source>
+
<source lang="mIRC">ON *:DCCSERVER:Chat:echo User $nick ( $+ $address $+ ) is attempting to initiate a DCC Chat.</source>
  
 
== Compatibility ==
 
== Compatibility ==

Revision as of 19:20, 24 June 2014

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

<Chat|Send|Fserve>The text that to be matched. Can also be a wildcard.

ChatTriggers if the event is caused by a DCCSERVER Chat.
SendTriggers if the event is caused by a DCCSERVER Send.
FserveTriggers 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/12/97

See Also