[Installation]

1. Unpack the nickcomp131 archive file into a new directory.
   Note: You won't have any problems installing this add-on in any Dir on your
         Hard disk, but I recommend you to use a dir within your mIRC-Dir.
         This File contains: - nickcomp.mrc (the Script)
                             - getdir.dll (a .dll extension for mIRC)
                             - readme.txt (this file)
   The Script creates a file called 'dnic.hsh' in the dir it was installed to.

2. Type /load -rs x:\path\nickcomp.mrc at the mIRC command line.

3. Click 'Yes', when a dialog box popups up to ask if you want to run the
   Initialization.

Note: These script requires mIRC 32 Bit v5.91 and above. To get the latest
      Version of mIRC, visit http://www.mirc.co.uk/

How to Uninstall

Please use menu popup from menu bar to unload the script.
It will unload the script file, delete the dnic.hsh where all settings are Stored
and will delete some temporary variables.

[Configuration]

After the first installation, the Add-on is still deactivated. You can find the
Configuration in the menu. As long as no other script renamed the menu bar it's
Called 'Commands'. You can find it in the mIRC-Menu between 'Dcc' and 'Window'.

Commands
.Nickcompleter
..Setup
..------
..Help
..About
..------
..Unload

Below are descriptions of the functions of the add-on-setup.

Setup Dialog
- Menu
  - File
    . New: Set anything back to default
    . Open: Loads Settings and/or Styles from a File
    . Save As: Saves Settings and/or Styles to a File
    . Quit: Ask to Save changes and close the Setup
  - Options
    . Use Channel Popup: If enabled, the menu for setup/unload also appears in
                         the Channel Popup
    . Strip Colors on Mode +c: If enabled, automaticly removes the colors in the
                               completed nick if used on a Channel with
                               Channelmode +c (Blocks messages with ANSI colour)
  - Help
    . Contents: Open the Help file
    . Homepage: Run the Homepage in the default Browser
    . About: Opens the About-Dialog with some Information and Comments
- Settings
  . Enable nick completion: Enable/Disable the Add-on
  . Trigger(s): This Characters are used as trigger to complete a nick
  - If more than one nick matches...
    . ask: It will popup a box with all found nicks and you can select the nick
           you want to talk to
    . use first match: It will use the first nick it founds
    . don't complete: It will send the line unchanged
- Styler
  . Edit Style: You can style the output of the nickcomp with colors, extra chars
                or whatever you like. You can enter here anything you could enter
                in the input-line of a chat-window in mIRC. <nick> represent the
                completed nick and <char> represent the used trigger - both will
                be replaced in the output.
  . Edit <nick>: If you want to change Style within the completed nickname, you
                 can do that here. As above, you can do any input as in the
                 miRC-Chat-Window Input-Line. You can use <mid> and <[-]N> here.
                 Where N is a number in <N> and <-N>, which identify the
                 character. <1> is the 1st, <2> the 2nd while <-1> is the last
                 character and so on ... <mid> represent any unused character, so
                 you can style <1><mid><-1> if you want to change the style of
                 first and last char for example.
- Preview: Shows you a preview of the current style.

[Tags]

Tags on General Style :

<nick> - The completed nickname
<char> - The used Trigger

Tags on <nick> Style :

<mid> - Unused Chars between the <[-]N> Tags
<[-]N> - One Charachter out of the nickname

Examples for the Usage of <[-]N> on "nickname"

<1> - "n" in this case (first char)
<-1> - "e" in this case (last char)
<2> - "i" in this case (second char)
<-2> - "m" in this case (the char before the last)

I think this it pretty much self explaining now ...

<1><mid><-1> - underline anything except first and last char
04<1><2><mid> - first and second char red (04), anything else colourless

[Usage]

This Add-on trigger on the first word in your text and for the last char, which
must be one of the Trigger(s) in your setup.

Say one of your Trigger is ":" and you want to tell me, Ecronika, something and
you type: 

Ecro: Hi - I want to ask you something...

It will be displayed as:

Ecronika: Hi - I want to ask you something...

You can use any part of the nickname, which is useful for nicks like {-nickname-}
You could just type: nick: Text

[Description]

defcon nickcomp is a very fast nick completer for mIRC for those who don't like
having to use TAB, want to style the nicks or just don't want to type special
Characters for mIRC's TAB-Completion like {,[ or ^. I hope you find this add-on
useful and that it makes your IRC-life more enjoyable.

[Contact]

IRC : irc.phat-net.de - #mircscripte
Email : Ecronika@defcon-one-script.de
Homepage : http://defcon-one-script.de

[Notes]

This Add-on uses the on Input event, which can cause trouble with other add-ons
like replacer, theme systems or something like this, that works with user
input. Sorry, but I can't fix that in many times - anyway feel free to contact
me about needed add-ons like this and I will help you if I can.

[Updates]

Version 1.3.1

Fixed a bug with mIRC Versions lower than 6.02
Optimized the performance of the nick-styler
You can now choose the nick you want to talk to also with double click on it
  in the list with multiple matches

Version 1.3.0

Redesigned the Setup Dialog
Added "Help" and "About" to the Menus
Added new option: Strip Colors on Channel Mode +c
Updated Search Method to work faster on many matches
Search will not find yourself anymore
New Help-Entry: Tags - Explains the usage of the Tags in Styler

Version 1.2.1

New Option added: Use Channel Popup
Added an Apply-Button in the setup
The OK-Button will no longer be disabled if nothing changed - this feature now
  disable/enable the new Apply-Button
File/Save will no longer store a tag-information if you don't select Style
Replaced the email-text in about dialog with an email link (text was too long)
Help now also shows you the updates-section from readme.txt
It will no longer create a new message if nothing has changed, so it will not
  remove your spaces in normal text where you didn't used the nick completer

Version 1.2.0

Changed Email to Ecronika@defcon-one-script.de
Changed URLs to http://defcon-one-script.de/addons/nickcomp/
Now works too if you press Control Enter
Performance optimizations in the nick-styler
This Version only works on mIRC 5.91 and above
Removed the limit of N being 1-9 in nick-styler, now works unlimited

Version 1.1.2:

Work with my new add-on 'defcon autocorrecter'
Some little performance optimizations

Version 1.1.0:

Some Fixes to get it work on mIRC 6.0

Version 1.0.1:

This Update fixes a little bug in the nickstyler.

If you want to use <mid> at the beginning or the end it could happen, that not
all defined chars will be styled in short nicknames - this is fixed.

Version 1.0.0:

This was the first Final Version...
