Readme for Yardiff's Private Message Filter v1.1

This is actually a fairly old addon, that I created two or so years ago since I kept getting annoyed by the usual idiots who would a/s/l you in private message (among other things). Sometimes it's not easy being an op.

Anyway, in a nutshell, here is what it's for: this script is designed to stop those annoying little private messages, notices, and suchlike that you always seem to get from lamers on irc. It will send a little message to whoever has attempted to private message you, and then will ignore them for two minutes.

It will allow through private messages from people that you have set in your userlist to have a 2+ userlevel (if you're not sure what that means, press F1 in mirc and look at user levels). It will also allow through private messages from people who are opped or voiced on one of the channels you are on ('cause if they're opped or voiced they are at least worth letting through :p). It also lets through server notices (don't ask).

At any rate, if the script is triggered to ignore someone it brings up a little window "@V.Status" with a message in it saying what has happened. It will also send a private message to the person involved, and ignore them for a time set by you (the message and ignore are shown in the normal mIRC Status window).

If a legitimate user sends a private message/action/notice, it will send it to any open dcc chat or query windows. If there are none, the text will be echoed into the @V.Status window, and logged in a personal file (in the mirc install directory, called "V-Personal.log").


Loading It:

To load it, do the following (starting at the menubar):

Tools > Remote - in the window that pops up, go to File > Load > filter.mrc

mIRC may ask if you want to perform on-load actions - do so, it sets some defaults that are needed in a configuration file (if you're lazy and can't be bothered to set them yourself).


How to Set User Levels:

By highlighting a nick and right-clicking on it, you should get a new menu option show up: "User Levels". Under this are four submenus:

Add Level     - allows you to add a user level (ie 2)
Display Info  - displays the hostmask of the user
Remove Level  - removes a user level (ie 2)
Remove Ignore - removes an ignore, using the same hostmask as "Display Info"


How to Turn On/Off and do Individual Preferences:

On the main menu, under Commands, is another menu option: "Private Message". This has some sub-commands:

Filter is On/Off
  On  - turn it on (should be the default)
  Off - turn it off (duh!)
Settings
  Set Message - set the message that you want to send the people you ignore
  Ignore Time - how many seconds to ignore them for

Note: by default, these are set to "I don't accept private messages and stuff" and "120" seconds.

That's it. Easy, no?


Version 1.1 - Additions

I added some extras, to stop people opening a query or DCCing you without your permission (chats and files). Remember that to recieve any of this stuff from non-ops and non-voiced (it should now work with helpers also), you have to give people a level 2+ in the userlist.


Known Issues

Some ISPs are so inconsiderate that they can't provide decent/consistent hostmasks for their users. Also, sometimes people will have a numeric hostmask (which might even change upon occasion). Either of these can cause the script to trigger when you don't really want it to (ie on friends).

The solution here is to get into the userlist and edit the people involved manually. To do this, go (from the menu bar): Tools > Remotes > Users tab.
