[Installation]
First step: Check out the requirements

  Windows 9x/ME/NT/2000/XP
  mIRC 32 Bit version 6.03 and above
  at least 56 KB of free hard disk space
  Keyboard
  Mouse
  Some time and an operating brain helps too :-)

Second Step: Unpack the Files

  Unpack the archive file nickcomp153 into a new directory.
  Note: You can install this Addon into any directory on your hard disk but I
        recommend you to use a subdirectory of mIRC.
  The archive file includes:
    - nickcomp.mrc (the Addon)
    - getdir.dll (a .dll extension for mIRC)
    - nickcompleter-readme.txt (this file)
  This Addon creates a file named "dnic.hsh" in the directory in which it was
  installed. (You need write authorities in the corresponding directory.)

Third step: Load the Addon

  Type the following line in the command line of mIRC:
    /load -rs x:\path\nickcomp.mrc
  Click 'yes', when a dialog box opens to ask whether you want to execute the
  initialization.

Fourth step: Tying Addon in KTE (if necessary)

  If you use KTE (MTS-Theme-Engine), please read the Notes-Section
[Remove]
To remove the Addon, choose the item "Unload" in the menu.

This takes care that all variables created in mIRC are removed and the Addon
gets unloaded. This also removes the configuration file "dnic.hsh". You should
copy this file before or restore it from the recycle bin if you want to keep
your settings.

You can delete all files you have unzipped at the installation after this.
[Configuration]
After the installation the Addon isn't activated yet.
The configuration is in the menu of mIRC.
As long as no other script has renamed this menu yet, it is called "Commands"
and can be found 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, automatically removes the colors in
                               the completed nick if used on a Channel with
                               Channel mode +c (Blocks messages with ANSI colour)
    . Force load as first script: Reloads the Script as first script everytime
                                  mIRC starts (most times this improves compatibility)
    . NickMarker: This marks a part of the nickname in texts of other users
                  which would be particularly well suitable as a shortcut for
                  this Nickname.
  - 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 Character out of the nickname
<rc> - Random Color

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]
Homepage : http://defcon-one-script.de
Email : Ecronika@defcon-one-script.de

IRC :
irc.quakenet.org - #cyberscripters
irc.phat-net.de - #mircscripte
irc.elementz.net - #scripting

[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.

How to get it work with the popular MTS-Theme-Engine KTE (1.5) ?

1.) Open the File "kte-dyn.dat" in an text-editor (i.e. notepad)

2a) Include the whole nickcompletion

 a) Use the Text-Search feature of your editor to find these lines

    on &*:INPUT:*:{
      if ($0) && ((/* !iswm $1) || ($ctrlenter)) && (($active ischan) || ($query($active)) || (=* iswm $active)) && ($window($active, 0) = 1) {
        say $1- | halt
      }
    }

    Note: These lines may change in future versions of KTE
          You should always find them if you search for ":input:"

 b) Add this new line BEFORE the line, beginning with "say $1-"

    if ($_dnc.get($1-)) tokenize 32 $ifmatch

2b) Include the NickMark-Feature

    If you want to use the NickMark-Feature you will have to change another part too.

 a) Use the Text-Search feature again and search for ":text:*:#:"
    You should find these lines:

    on &^*:TEXT:*:#:{
      if ($chan !ischan) { return }
      set -u1 %:echo echo $color(normal) -mlbfti2 $chan
      set -nu1 %::text $strip($1-, o)
      kte_set std nick address chanstd target parentext
      kte::TextChan
      kte_unset
    }

 b) Change the following line:

    kte_set std nick address chanstd target parentext

    to this :

    kte_set std address chanstd target parentext

 c) add a new line before the one you just edited:

    set -nu1 %::text $strip($1-, o)
    ; ADD NEW LINE HERE
    kte_set std nick address chanstd target parentext

    The new line is :

    set -nu1 %::nick $iif($_dnc.marknick,$ifmatch,$nick)

3.) Load/Reload your theme in KTE - that's it :)

[Updates]
Version 1.5.3

Fixed bug where matches wheren't displayed correctly when your nick was the first match
Added Workaround to display multiple spaces in on text events
Added Support for Theme Engine MX by Voice of Power and some other MTS-Engines

Version 1.5.2

Fixed GUI-Bug "editbox content get not selected when using Alt + E to edit <nick>-style"
Optimized <nick>-style and Nick-Search Performance
Added Support for Defcon Message Extension Addon version 0.4 and above
Added command /ncsetup to open the Nickcompleter preferences

Version 1.5.1

Fixed some problems with special Chars {}[]|\. in:
 - own nickname
 - as trigger (with Inline completion)
 - as Prefix

Version 1.5.0

Added an option to disable the Inline Completion
Added the description for <rc>-Tag in <nick>-Style in the readme
Optimized, Preview works around 35% faster now
The Text-Theme for the Nickmarker notices more settings for Nick Colors now
Fixed, You can now disable the Nickmarker with KTE too
Cleaned, started to make the code easier to read
Changed Homepage-URL to http://defcon-one-script.de/addons/nickcompleter/

Version 1.4.1

Optimized, NickMark-Feature had a performance problem with nicks like ]c00l[|Cl4N
Added a Description how to use the NickMark-Feature with KTE
Added a confirmation to delete settings/files while unloading

Version 1.4.0

Fixed, Recognize "c" in channel-key as Channel mode +c
Fixed, Do not search for nicks if _ is in the search mask
Optimized, Nick Search use a much faster way (up to 20 times on big channels)
Optimized, Nick Styler use completely rewritten code (around 30% faster)
Setup will check Styles for one-digit colour-codes to avoid problems with nicks that
  include numbers
Unload will move Settings-File to recycle bin instead of removing it
Added "In Sentence" Completion
Added "Nick Mark" Feature
Added "Force load as first script"
This Version will only work on mIRC v6.03 and above

Version 1.3.4

Changes in the Script :

Fixed Bugs, if installed into a dir with 2 or more sequential spaces in pathname
Fixed Bug, not showing updates-section in help
Fixed Bug, no display in help when just opened
Fixed Bug, mIRC 5.91 cant read readme.txt to show in help-dialog
Added workaround to prevent errors when processing large input-lines

Changes in readme/help :

Added 2 IRC-Channels to the Contact-Info where you can find me
Added a "How to" in Notes - How to use this nickcomp with KTE

Note: This will be the last Version for mIRC 5.91


Version 1.3.3

Forgot to remove some test code in v1.32 :-(


Version 1.3.2

Fixed 2 "invalid id" Bugs with File/New and File/Open


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...
