WC3banlist.de

Produced by Knarf

Help contents

  1. Introduction to WC3Banlist
  2. Quick setup
  3. Explanation of features
  4. Troubleshooting / FAQ
  5. Credits

Return to top Introduction to WC3Banlist

This program is created to make an effort at keeping your DotA games free of notorious leavers. Thereby it offers a local database (to which you can add people yourself) to alert you when a "leaver" joins your game or someone you've kept some information about.

The program can do this in various ways:

Further features include:

Return to top Quick Setup

After installing the program, there are a few things to be configured for the program to work correctly.

  1. Install the WinPcap drivers

    The WinPcap drivers are included with WC3Banlist and installed should you have checked the option in the installer.

    You can download them from the official homepage.

  2. Complete the First-Run Wizard

    On the first start of the program, a First-Run Wizard will appear. Completing it will setup WC3Banlist for using.

Return to top Explanation of features

Here follows a quick tour through the various tabs of WC3Banlist, to introduce you to some of the features.

  1. Warcraft III Snooping

    Gives a real-time report of your current game. It shows general information about the game, a graphical impression of the Warcraft III pre-game screen, a list of recent game events (to the left), a list of slot reservations (lower left) and a list of recent WC3Banlist events (at the bottom). When you exit a game, you will be able to look back here also. It will stay the same until you start or join another game. You can also ban people from here by right-clicking on their names.

  2. Local Database

    Shows your local database. Use the panel on the left to access the different sections. Infos are notes about players, mostly of private kind, that won't be shared through Buddies' Banlists.

    WC3Banlist keeps track of all games you played. When you double-click a game, you can issue scores to the players which participated. These scores will also be shown in the Scores section.

    Tip: Wrapping the comment in parentheses ( ) will stop banlist from trying to form a phrase with it when it encounters the player.

    From this screen you can also export your bans or infos to an XML or text file. It will include all the comments. This function is mainly used for backup purposes, although other people using this program also can import the file. They will also be able to see any comments you added to these names.

    You can also search the database using the search bar on the bottom.

    In the tools section, you can empty the recycle bin (remove all deleted bans and infos) and check a nickname against all available lists (Works the same as the in-game "/check" command).

  3. Online Banlists / Safelists

    This screen is related to the online banlists. Once downloaded, you can tell the banlist program to also check the usernames on these lists.

    Buddies' Banlists make it possible to login to banlist.nl, define buddies there, and automatically download your buddies' banlists and upload yours for your buddies to download.

    Server lists are banlists or safelists that are hosted on a web server. You need an XML file that defines a server list before it can be accessed.

    Note: If you want to use server lists, you must first go to Preferences → Online Lists and load a server list definition from an XML file.

  4. In-Game Commands

    This tab lists the commands that you can use inside Warcraft III and gives. If you enabled "View messages within Warcraft III" in Preferences → Messaging, there will of course be no need to press Ctrl-V for the feedback.

    You can activate double slash command mode here, which prevents overlapping with channel commands (i.e. /ban).

  5. Preferences

    1. Online Lists: Contains some settings for synchronizing with your buddies' banlists (a service provided by www.banlist.nl) and the Server Banlists / Safelists. Server lists enable members of clans or other organizations to easily include their lists in WC3Banlist. All the host needs to do is to distribute an XML file that contains all necessary data to their users. They import this file by pressing the "Load from XML file" button and from now on the hosted banlist / safelist will be loaded on each startup of WC3Banlist and checked by the program. If an online list shall not be downloaded for a while you can also disable particular entries. They won't be downloaded then, but you still can enable them for later use.
    2. Databases: Contains settings concerning checking of joining players and the save location and naming behavior for screenshots and replays.
    3. Phrases: You can add your own default text quotes here for usage with the /p command in-game. Add a new phrase using the "+" button, then edit the name and the text to be written. Example: Phrase: "ban1", Name of Phrase: "ban1", Text to be written: "$shiftenter I am using a banlist program. Leave my game and you will never join my games again." This will cause the specified text to be displayed in Warcraft III as if you was doing shift-enter, a.k.a. speaking to all. You can also map phrases to hotkeys (F2-F9) here. Remember that the F keys are also used to select heroes in Warcraft III, so for example don't map anything to F2 and F3 if you are playing ladder games and F9 if the map you are playing has a quest log.
      Note: Take care when entering the text to be phrased. Every character which you type will be sent to Warcraft III. Therefore don't forget to hit enter at the end of the phrase!
      Tip: Entering text here is best done without looking at the screen. Just look at your keyboard and hit the keys as if you were chatting in Warcraft III (Exception: If you are going to do a shift-enter, enter $shiftenter instead).
    4. Anti Download: Lets you prevent people from joining your game who don't have the map. You can also define a whisper that should be sent to the kicked downloader.
      Note: Whispering to the kicked downloader uses the Warcraft chat line. Hence you can't use the chat at the same time if this is meant to work.
    5. Auto Kick: Lets you prevent banned people from joining your game when their comment includes a certain keyword. You can select which lists are to be checked for people to be auto kicked.
      If you want all your buddies' banlists to be checked, enter an asterisk (*). Entering an asterisk also works for the keyword.
    6. Network: The default settings here should work fine. You can select the method for Auto-Kick and Anti-Download here.
      Note: If you're using both Windows XP SP2 and the NdisWan adapter, you are out of luck. You can use neither Anti-Download nor Auto-Kick. :-(
    7. Messaging: Allows you to specify if and how WC3Banlist should notify you of any events (besides sounds, which are configured in the Sounds tab). This program features a snooping of your Warcraft III whisper history (the Messages tab), and here you can define whether Warcraft III Banlist should alert you of new whispers. Warnings for multiple players with the same IP in your game can be disabled here too. Select a stylesheet to change the graphical layout of the Messages-tab to your personal preference.
    8. Sounds: Sets the audio files which will be played at certain events. Default sounds are found in the program folder, in the sounds directory.
      1. The sound Banned player joins will be played when a banlisted person enters your game.
      2. Player banned will play when a leaver is successfully banned.
      3. Response sound will play on confirmation of any other command, such as /ping, or /check.
      4. The sound Player leaves will be played if a player leaves the current game.
        If you are the host: Only players that have really left the game (not lagged out) will cause this sound to be played.
        If you are not host: This sound will play both when someone leaves and when someone lags out.
      5. Same IP sound will be played if someone enters a game with the same IP as someone else who has joined your games. This list is cleared every day, and will allow you to see if someone is changing accounts to get into your game.
      6. Whisper sound will play when someone whispers you.
      7. The sound Game countdown started will play when... the game countdown starts!
      8. The sound Not safelisted player joins will play when someone joins who isn't safelisted. Safelists are only available by using Server Lists.
      9. The sound Info found will play when a player joins who information is available upon.
    9. Custom Comments: Custom Comments enable you to set the comments for people to be banned within a second without losing important information about why that certain player has been banned. A keyword identifies the kind of reason. To each keyword belongs a string that contains variables. These will be substituted with the information they stand for. I.e. if you use "/ban BadGuy leaver" within Warcraft III, BadGuy will be banned with comment "leaver (5*v5) on Northrend (02/2005)". The asterisk is behind the first five, because he belonged to that team. Each team had had five players before he had left.
    10. Friend List: Allows you to specify friends to be used by the slot reservations function and exceptions to Anti-Download. Checking the box below the Warcraft friend list will have it always included in WC3Banlist's friend list.
    11. Miscellaneous: You can specify a default comment that will be tagged to a banlisted person when you have banned him using the in-game command /banlast (also works with custom comments). The other settings let you select which banlists to use when using this programs checking options and the safelist checking behavior. You can also make WC3Banlist minimize into the system tray notification area.
  6. Messages

    Shows the history of whispers you have received and sent since you loaded up Warcraft III Banlist (You can also store the messages by ticking "Store the messages to a file" on Preferences → Messages). Last message on bottom (as in the game). You can customize the looks of this section using the stylesheets available on the Preferences tab → Messages.

    In Version 2.7 the channel mode has been introduced. It offers a chat interface just like in WC3 itself. You can activate it by pressing on the little peon button at the right bottom corner. You need to have WC3 running in background and joined a channel.

    If you want the program to start in that mode by default, you can reach this by checking the related checkbox at Preferences -> Messaging.

  7. Help

    Displays this help document.

Return to top Troubleshooting / FAQ

Q: The program doesn't do anything. I am not receiving whispers in my Messages tab and my Recent Game tab does not show my game or the players.
A: Make sure that you have the right NIC selected. See chapter 2 on how to configure it.
A: Did you install the WinPCap drivers? Download them from the official homepage.
A: Try toggling "Promiscuous Mode" on Preferences → NIC Settings.
A: You can also use the diagnostic center (right hand of the NIC selection), it will tell you what's wrong.
Q: I do receive messages, and I do see players joining in "Recent game", but when someone joins who is on my banlist, nothing happens!
A: Make sure to enable at least one of the alert options provided by the program. Add a wav file to the event "Banned player joins" or enable the running text.
Q: Where do I input those commands you speak of?
A: Commands are used within WC3 at any chat line.
Q: Warcraft says the command I just used for managing the banlist doesn't exist. Am I doing something wrong?
A: No, everything's fine. Warcraft always says the command is unknown because for the battle.net server it really doesn't exist. But nevertheless the program listens to the network stream and reacts if it finds one of the WC3Banlist commands.
Q: This idiot has just left my game. What is the easiest way to add him to my local banlist?
A: In Warcraft III, hit enter. Then type "/banlast", without the quotes. Hit enter again. You can type "/check playername" (where playername is the name of the person that just left) to check if he is indeed added. If a sound is specified for the event "Ban Sound", this will also be played.
A: Since 2.7 it's also possible to use color substitutions instead of nicknames. For example if you want to ban the yellow player as leaver type "/ban $yellow leaver"
Q: What means "timed out" or "t/o" when I try to ping someone?
A: This means that no response was received (maybe due to a firewall that ignores pings), so that the ping time could not be measured.
Q: I want to put someone on the global banlist. What should I do?
A: There is no global banlist. But you have the opportunity to share you local banlist with others by using the Buddies' Banlists system.
Q: I completely lost my local database! What can I do?
A: If you use the Buddies' Banlist System, all is not lost. Go to Tools in the Local Database tab and click on "Restore local database".
Q: I'm on the banlist of someone. How can I get off it?
A: Depends on who banned you. The only person who can remove you is the host who banned you. Generally speaking, if you appeal to the host politely and ask them to remove you, they will do so without a problem. If it's an approved host, contact them at the Banlist.nl forums via PM and they will likely work something out.
Q: My NIC doesn't show up in the NIC selection box. What can I do?
A: Your NIC is not supported the version of WinPcap you have installed. If there is a new version of WinPcap available, try downloading it at the WinPcap homepage.
Q: When I use /fromall or /pingall the result shows up at the top of the screen, but I want it to appear in the chat! What should I do?
A: Press Ctrl+V to paste the results into the chat line. Then just press Return.

Return to top Credits

Valid XHTML 1.1 icon, XHTML 1.1 Specification Valid CSS icon, CSS 2.1 Specification