Skip to content
MSN Addons

nickLUST.dll

A TG007 community discussion started by sugarboy.

Discussion 1 post
Page 1 of 1
Open
Topic #4300 · 1 published post · 1,120 views

Well, I am somewhat new to scripting, and I am basically right now just working on the design its self of the script, and when i get more spare time i will actually sit down to learn more and work at this myself, but moving on, I have nickLUST.dll and I am wondering how i go about using this, i have read the help file that is included but it seems to not help me out cause i dont understand a few of the terms, and i cant get the nicklust to run or what ever.

 

This is what was included for support

How to use nickLUST

There are several areas you need to deal with when using this dll. First you need to know how to access dll function from within mIRC. This is typically accomplish in one of two ways. First by using /dll. This command in mIRC will call a named function from within a dll. The only downside is you cant return anything to the script using this command. To get return information from the dll you would use $dll. Almost all dll's return some form of confirmation in each of thier functions. This allows the script to determine if the command was sucessfull and if it wasnt what went wrong. Typically a scripter will write an alias to call the dll and return specific information. For exmaple mine looks like this

Alias nickLUST return $dll(nickLUST3.dll,$1,$2-)

I can call it using /nickLUST or $nickLUST. You can also define an alias for common tasks. I use the following alias for marking a channel

Alias nMark return $nickLUST(Mark,$window($1).hwnd nickLUST_CallBack $2-)

I can use /nMark #channel options. 

You must also use a callback alias in order to use some of the more advanced features in nickLUST. A callback alias is nothing more than an alias in your remotes that is called by nickLUST and not your script. The alias will work like any other alias. It will recieve a variable number of arguments but no less than 2. The first argument is always the event name. This is the reason nickLUST called the alias. The second argument will always be the channel name the event occured in. Any other arguments the alias may recieve will vary and depend on the event. Below is a list of events followed by my sample alias.

nickAdded - notifies the alias that a new nickname has been added. You can return any text you would like to be displayed. If you return nothing then the nickname is displayed as normal. in this case $3 in the alias is the name of the nick. 
nickDeleted - Notifies the alias that a nickname was removed. $3 is again the nick that was removed however the return value is not used in this event. 
Tooltip - Sent to notify the alias that the user has hovered over a nick and a tooltip is about to be shown. $3 is the nickname and you can return whatever text you want displayed in the tooltip. If you return nothing or an empty text then no tooltip is displayed. 
Collapsing - Sent when a group is about to collapse. if you return $false then the group is not collapsed. $3 in this event is the group id of the group collapsing. 
Collapsed - Provided only for notification this event is sent after a group has been collapsed. $3 is again the group id. 
Expanding - Sent when a group is about to expand. if you return $false then the group is not expanded. $3 in this event is the group id of the group expanding. 
Expanded - Provided only for notification this event is sent after a group has been expanded. $3 is again the group id. 
nickAdding - Sent just before a nick is added. $3 is the identifier of the group the nick will be added to. You can return the group id of any group and it will be placed there instead. This event is used in conjunction with Custom groups. See the example below. 
popups - Sent just before the default mIRC popup is displayed on a right click. $3-$6 are the position of the mouse in two coords. $3 and $4 is the mouse pos relative to the screen and $5-$6 are relative to the nicklist. You can return $false during this event in wich case the default popups will not be used.

Alias nickLUST_Callback {
 if ($1 == tooltip) {
   var %extra
   if ($3 == $me) %extra = (Your nick)
   nicklust SetTipTitle $2 3 > Info on $3 %extra
   return Status: Channel Operator $+ $crlf $+ Idle: $duration($nick($2,$nick($2,$3)).idle) $+ $crlf $+ IsNotify: $iif($notify($3),Yes,No) $+ $crlf $+ Address: $iif($address($3,4),$ifmatch,Unavailable)
 }
;The following code will place all nicks in your notify list in a custom group
;The custom group id is 15.
 if (($1 == nickAdding) && ($notify($3))) return 15
 
;The following code adds multiple lines to nicknames.
 if ($1 == nickadded) {
   if ($3 == $me) return 2 $rgb(255,0,255) > $me $crlf $+ This is your nick
   if ($3 == setile) return none $rgb(0,255,0) > $3 $+ $crlf $+ Genscripts Getter
   if ($3 == bamaboy) return none $rgb(255,0,0) > $3 $crlf $+ Channel Cofounder $+ $crlf $+ Programmer
   if ($3 == |3|acK_Kn|G||T) return 3 $rgb(255,0,0) > $3 $crlf $+ Beta Tester $+ $crlf $+ Genscripts Staff
   if ($3 == atrac) return none $rgb(0,0,255) > $3 (webmaster)
 }
;The following code allows you to use some other popup dll instead of mIRC's default popups
 if ($1 == popups) {
  ;call the popup dll here. $3-$4 are the screen coords of the mouse
  ;$5-$6 are the list coords
   return $false
 }
}


*Insert interesting signature here*