User Tools

Site Tools


on_dcc_list

Synopsis:

on [<modes>]dcc_list [<serial#>] [-|^]<match> { <action> }

Summary:

Triggered by each line when you do dcc list. Useful for a script to see what dccs are open.

Description:

This hook is triggered whenever a /dcc or /dcc list command is issued. The 'banner' of the list can be determined when $0 is “Start”, and the end of the list is determined when $0 is “end”.

Parameters:

$0 The type of DCC connection
$1 “1” if encryption is on, “0” if its not (future exp)
$2 Nickname of the peer
$3 Status of connection
$4 $time() when connection established, 0 if not connected.
$5 Size of the file transfer, 0 if not applicable
$6 Number of bytes transfered, 0 if not connected
$7 Description field (usually the full filename)

Default Action:

If you don't suppress this event, the client will display the dcc list item to your screen.

Examples:

To display some extra info about dcc:

 on -dcc_list * (type, encrypted, peer, status, est, size, numbytes, desc) {
    if (numbytes / size > 0.9) { 
       echo File $desc from $nick is almost done! 
    };
 };
 dcc list;

History:

on_dcc_list.txt · Last modified: 2011/10/31 20:07 (external edit)