===========================
SpamFilter v1.3, 2008-06-21
===========================

About
-----
SpamFilter is a D2Loader plugin for Diablo II v1.12. It is designed to reduce
and / or eliminate spam from within the chat channels and whispered text. Many
spam bots are catching your account name if you enter any of the chat channels
and you can end up receiving whispers even after leaving the channel, in some
cases, up to 1 hour after being in the channel!

These new spambots annoyed me, so I made this plugin to help stop them.

Version 1.2 also supports blocking of in-game spambots. An account on the
internal blacklist will be completely ignored - you won't even see any
join or exit messages.

Features
--------
Account blacklisting - any account on the internal blacklist will be unable to
communicate with you via whispers or chat channels. You can press a single key
to add highlighed users to the list as well as setup automatic filters. To add
a user account to the blacklist, click the user's portrait and press F1. To
remove, press F2.

Spam / text filter - blocks and optionally blacklists any messages containing
the text of your choice. See config section below for more information on how
to set this up.

De-dupe - removes duplicate messages from the chat channels. Each account has
previous message history kept and duplicates within 90 seconds of each other
are removed. This helps keep the scrolling to a minimum. Dupe whispers are also
filtered.

Non-D2 filter - ignores any messages that aren't from Diablo II accounts. This
will stop the "open character" spam bots or bots that are logged in using
different product codes (eg Starcraft).

Flood protection - some kiddy flooding you with whispers? Not any more. Flood
activity is blocked and the account blacklisted with minimum disruption.

Verbose output. Want to see what spamfilter is up to? Press F3 to toggle
verbose mode. Note that you can only toggle verbose mode in the chat channel,
even though it will also cause output in-game.

Whitelisting - if you run your own non-spamming channel bots, you can add them
to a whitelist so they will never be filtered, eg by the open characters
filter. F4 / F5 control adding accounts to the whitelist in the chat channels
as with blacklisting.

In-game spambot filter - the same filters that apply to the chat channels and
whispers also apply in game. Since chat messages are not sent with account
information, spambots that are in the game prior to your joining will not be
as effectively blocked as ones that join after you have joined.

Installation
------------
Extract the .zip to your Diablo II directory with folders enabled, then run D2
as usual using D2Loader.

Config
------
The config files belong in your Diablo II directory and can be edited with any
text editor, eg Notepad.

spamfilter-accounts.txt
 Blacklisted accounts. You won't see a thing from them in the chat channels,
 whispers or in game. Simple text file format, put the *accountName, one per
 line. This file can be updated in-game using the hotkeys mentioned above.

spamfilter-exceptions.txt
 Whitelisted accounts. You will always see messages from these accounts, even
 if it contains blocked words or is from an open character. Simple text file
 format, put the *accountName, one per line. This file can be updated in-game
 using the hotkeys mentioned above.

spamfilter-spam.txt
 Lines of text that might be found in spam messages. If any of these appear in
 a message, the account that sent the message is blacklisted and you are
 notified with a red message. One line of text per line. Be conservative of
 what you add to this file, as any occurance of this text in any chat channel
 or in-game message will cause the account to become blacklisted.

spamfilter-text.txt
 Normal lines of text. If any of these appear, the message is simply ignored
 (account isn't blacklisted). Use if you don't want to see certain things, but
 don't want to risk blacklisting the account. One line of text per line.

History
-------
Version 1.3, 2008-06-21

  * Support 1.12 patch.
  
Version 1.2, 2007-07-26

  * Support in-game spambot filtering.
  * Fix blacklist/whitelist removal failing if the account had uppercase
    letters. Thanks to PortalDeamon for reporting this.

Version 1.1, 2005-12-19

  * Support exception list.
  * Fix F3 showing verbose message in-game.

Version 1.0, 2005-12-09

  * Public release.
