Author Topic: [1.1][Release] NickAlert  (Read 2572 times)


  • Newbie
  • *
  • Posts: 5
[1.1][Release] NickAlert
« on: December 22, 2014, 06:48:06 PM »
[What is NickAlert?]

NickAlert is a script which lets you set up strings which when said by other users will either log their message to a custom channel (so you can find it later all in one place) , play a sound file of your choice, both or even make it run a custom command on top of all that or on it's own

NickAlert is made to be easy to use which is why it uses dialogs(UI)
To open it you type "/menu" in chat
There is also one more command which is "/pings" and will disable all sound events (coming from the NickAlert script)
until you type it again which will then enable them to be played once again


<Channel Include/Exclude>
The user can specify for every nick if they want it to only trigger in certain channels (Include Mode) or
if they want it to trigger when it's said in any channel BUT the specified channel(s) (Exclude Mode)

<Case Sensitivity>
For every nick there's also a "Case Sensitive" option which means that has to match exactly in a message for it to trigger
(Ex: Nick = Ndtm, if "ndtm" is said in a channel it won't trigger while "Ndtm" will)

While there is a "Global Sound File" you can set
Every Nick can also have it's own associated sound file (Any Nick set to Ping but does not have a Custom Sound File set will default to the Global Sound File)
It's recommended to put any file you want to use in the "wavs" folder at "%appdata%\Local\IceChat\Wavs"
and then just writing the filename in either the Nick Specific or Default/Global Editboxes.
You can use a fullpath to a sound file outside of the "wavs" folder but it's not always guarantee'd to work
(Global Sound File can be set in the "Extra Settings")

If a nick is set to log and someone mentions the nick in a channel it'll go to a custom channel window
in a format like below:
Message Form: "12:00 In #Channel <Ndtm> Hello"
Action Form: "12:00 In #Channel: * Ndtm said hello"

It's possible to change the form in the "Extra Settings" but the actual forms look like this:
Message Form: "In \%C9<CHANNEL>\%C <<CNICK>> <MESSAGE>"
Action Form: "In \%C9<CHANNEL>\%C:\%C4 * <NICK> <MESSAGE>"

When the script triggers it replaces all the various <Function>'s into text, you can move them around
in the form if you want but they need to stay uppercase.
<CHANNEL> = The channel the message was said in
<NICK> = A Plain version of the Nickname of the one who sent the message
<CNICK> = A Colored version of <NICK>, it'll color the name based on the Messengers mode/rank in the channel the message was sent in
<MESSAGE> = The Message that was said
<NETWORK> = If you're on multiple servers and the channels you're in on both servers are the same you can use this one to know on which server it was said

And As you can see in the technical message form there's "\%C" + a number And then a "\%C" after it
They basically color parts of the line which will appear in the custom channel window
(If you want to change a color to other colors you'll have to go to the Color picker in the bottom left of icechat, hover over a color and take the number which appears
and then put it after the "\%C", Note: <CNICK> cannot be colored like this, use the regular <NICK> if you want to color it)

<Custom Commands>
By using the tags from the Custom Window Form (<NICK>, <CHANNEL> etc other than <CNICK>) allows you to run custom commands when the item is triggered
For example:
Code: [Select]
<NETWORK> /msg <CHANNEL> Hello <NICK>This will Send a message to the channel where the item was triggered (On the right network if you happen to be on multiple networks)
You can also make it run multiple commands by using the built-in icechat vbscript commands "/!", "SendCommand" And a colon ":" to separate them like such:
Code: [Select]
<NETWORK> /! SendCommand "/msg <CHANNEL> Hello <NICK>" : SendCommand "/msg <CHANNEL> Welcome to <CHANNEL>"

** v1.1 **
   See reply down below for details
** v1.0 **
   Initial Release


Instructional Video:



Due to some limitation in the current UI you're required to press save whenever you change:
Global Ping Mute
The Following requires a nick to be selected first:
Case Sensitivity
Nick Setting (Off/Log/Ping/Both)
Channel Include/Exclude
NickSpecific Sound File
Custom Command

If you have any questions or bug reports you can either make a post in this thread and i might see it eventually or you may contact me directly on irc at: @ #icechat @ #ndtm
Usually on around ~3pm - 3am GMT+1

While i do accept any bug reports and suggestions there will be no guarantee that it'll be updated in the future

Disclaimer: using the dialogs may at times cause Icechat to freeze and stop responding it is however not very common and will only happen while a dialog window is open
« Last Edit: April 24, 2016, 06:27:47 AM by Ndtm »


  • Newbie
  • *
  • Posts: 5
Re: [1.1][Release] NickAlert
« Reply #1 on: April 24, 2016, 06:05:44 AM »
** v1.1 (24/04/2016) **
Finally an update!

-Added a Custom Command Editbox so when an item is mentioned it'll run a custom command you put in (Uses the same <NETWORK> <CHANNEL> <NICK> <MESSAGE> tags as the window forms, for example:
The <NETWORK> at the start is completely optional but it's where you'll want to put it if you're on multiple servers.
Code: [Select]
<NETWORK> /msg <CHANNEL> Hello <NICK>-And with the custom commands there is new a option besides Log and Ping (And Both) called 'CC' (Custom Command, straight forward enough) meaning it'll run the command when triggered but it won't log or ping (Custom commands will run on all modes other than 'Off').
-Added a Update checker to see if there is a new version available, default runs ever 7 days (Should've probably been once every month seeing as how long it took for this update to come out) but can be changed in the extras menu along with if you want it to check for updates at all.
-Added a [?] button next to the extras menu button which'll open this forum thread in the default browser.
-Some minor bug fixes
-Oh and the Strings can now have Spaces in them!

And that should be all for this update.
« Last Edit: April 24, 2016, 06:24:52 AM by Ndtm »