ShieldBot Read Me File

Written by Chris Nevin Last Updated: December 20, 2006

Getting Started (Back to Top)

Getting started with ShieldBot is a very simple process involving 4 steps: 1. First open the "ShieldBot" executable file. 2. Learn how to Configure a Profile 3. Learn how to use a Database 4. Learn how to connect to Battle.Net 4. Why won't BNLS work? 5. (Optional) You can then setup the Options by selecting them from the Settings menu. 6. (Optional) Then I recommend that you get accustomed to the Commands available to you, just so you know how to change settings if you need to.

Configuring a Profile (Back to Top)

Adding/Editing a Profile The steps needed for setting up a profile are as follows: 1. Select Edit Configuration from the Bot menu. This will display a form with the title 'ShieldBot - Configuration' 2. Depending on whether you have used this bot in the past or not it will display a large number of fields (like 'Profile Name:', 'Username:', etc..) if these fields are visible continue to Step 4. 3. If these fields are NOT visible click on the + button in the top right, this will create a new configuration profile and prompt you for a name for the profile. 4. Filling out these fields is pretty straight forward: Profile Name - this field should only be edited if you want to rename the profile to something else. Username - this field is what Account you want to logon to the server with. Password - this field contains the Password to the Account (Username). New Password - this field should be blank unless you want to change the Account's Password. Reset Password - this field is here so that if you lose the Password to your Account you can receive an E-mail giving you a new generated Password (requires the account to be Registered). E-Mail - this field is here so you can Bind your E-mail with the Account so you can use Reset Password option New E-Mail - this field should be black unless you are registering the Account to another E-mail. (Requires E-Mail field to be filled in too) Server - this specifies which Battle.Net server to log the bot onto. BNLS Server - this specifies which BNLS server to use for hashing the client. ProductID - this specifies which Product to connect to Battle.Net on (this field affects the Verbyte, Cdkey and Expansion Cdkey fields) Hash Path - this specifies which folder the hashing files are in. (May be phased out for BNLS soon) Verbyte - this specifies the version byte of the Product for example: WarCraft II is 0x4F however only the 4F should be entered. Cdkey - this is the Original cdkey of the Product and is required by all products. Expansion Cdkey - this is the Expansion cdkey and is only required for Diablo II: Lord of Destruction and WarCraft III: Frozen Throne. Channel - this is the channel the bot will join apon logon. Trigger - the trigger is a preceding character before a message to determine if the message might be a command or just a message. Ping - this option allows you to spoof a ping which can help in hiding your real ping. 5. After you have configured all the required fields click the Save Profile button. 6. Click the Load Profile button to load the profile into the bot's main window. 7. Now click Close button. Removing a Profile The steps needed for removing a profile are as follows: 1. Select Edit Configuration from the Bot menu. This will display a form with the title 'ShieldBot - Configuration' 2. Select the Configuration Profile you want to delete. 3. Select the - button from the top right.

Using the Database (Back to Top)

The database can be edited via the Visual Database or by sending commands to the bot or entering them in the Main Window. This tutorial will ONLY cover the Visual Database. if you want to learn how to edit the database by command go to the Commands section. To open the Visual Database Select Edit Database from the Bot menu. This will display a form with the title 'ShieldBot - Edit Database' Adding a User to the Visual Database 1. Fill out the fields: Username - The name of the user you want to add including the realm they are connected to as seen by StarCraft ie. Joe, Joe@Lordaeron Rank - The rank depends on the ranks specified in 'Database Config.ini'. 2. Now click the Add New User button. Removing a User from the Visual Database 1. Select the user from the list. 2. Select the Remove Selected User button. Simple!

Connecting to Battle.Net (Back to Top)

Before you can connect to Battle.Net ensure that you have completed steps 1 - 4 of the Getting Started section. Once these have been fulfilled you can now select Connect from the Bot menu. You may encounter a connection error when connecting this may or may not reflect your configuration settings. Some common error numbers are: #10053 - If you get this error continuously and only on 1 server, your IP address may be banned from that server. #10060 - This means the server could not be connected to, it may not be the correct Server or it may be too laggy for you to connect to. #10061 - This means the connection was refused by the Server.

BNLS not working? (Back to Top)

Before you can connect to BNLS you may need to edit the hosts file which will create an alias for the BNLS ip address. To do this: 1. Goto your %systemroot%\system32\drivers\etc\ then open the 'hosts' file with Notepad (if on Win9x use %systemroot%\system\drivers\etc\) 2. Goto the end of this file and add the line: 63.161.183.91 bnls.valhallalegends.com 3. This will create the alias 'bnls.valhallalegends.com' for the IP address. 4. Save and close this file.

Options Available (Back to Top)

These options can be changed by configuring them from the Moderation menu which will take you to the Moderation Settings form.

Option NameDescription
Ban RotationSince the ban limit is capped by Battle.Net for each moderator at a specific amount this will remove the first entry each time another entry is added that exceeds the ban limit.
Bot SecurityBot security has been implemented to ensure that the bot remains stable and low on RAM, these settings will provide you with complete customizability of what you see.
Channel ProtectionThis feature is only recommended to be used when all the members you don't want banned in the channel are safelisted. This will ban everyone that tries to enter the channel.
Clan BanningThis is a WarCraft III feature that is designed to keep other clans out of your channel but allowing members using other products such as StarCraft to come into/stay in the channel.
Clan SecurityThis is a WarCraft III feature that is designed to keep the clan channel secure.
Client BanningThis feature is designed to ban users that are using one of the Checked products. This also contains the option for Plug Banning.
Flood BanningThis feature is designed to ban users that join and talk or leave really quickly (far too quick for a Client to do).
Idle KickingThis feature is designed to keep the channel empty of idle users, ideal when your channel gets full alot.
Massload BanningThis feature is designed to ban bots/users that appear to be part of a mass load.
Phrase BanningThis feature is designed to ban users that say a specific word or phrase in their message. This helps with massloads that are all spamming the same thing.
Ping BanningThis feature is designed to ban users with a specific ping or a ping higher than a regular users ping should be, this helps with floods or massloads that are often very laggy (high latency or ping).
Squelch BanningThis feature is designed to do two things, ban users who are ignored and/or ignore users before they are banned.
Spam BanningWhen users appear to be spamming quicker than a client should be, this setting will ban them.
Stats BanningThis feature is designed to ban users which have not yet played games, this can help in banning loads because they generally created random accounts which have not been played on.

Commands (Back to Top)

These commands allow users to perform certain actions or change settings without having the use of the User Interface. Commands are triggered when a user whispers/says a message that starts with the trigger of the bot, ie. !say hi The rank required for each of these commands is specified in Database Config.ini or can be seen in Display> View Ranks

CommandAlias(es)Description
say [message]copy, repeat, sendRepeats the [message]
designatedDisplays who is currently designated
addmail [recipient] [message]mailAdds mail [message] for the specified [recipient]
clearmail [recipient]Clears all mail for the specified [recipient] from you
whois [user]Finds the specified [user] in the database
finduser [string]find, searchLists all users in the database whos name matches the [string]
findflag [flags]ffLists all users in the database with the specified [flags]
adduser [username] [rank]addDepending on your rank as per defined in 'Database Config.ini' this will attempt to add [username] to the database with [rank]. [username] can be split by / to add multiple users at once.
deluser [username]del, rem, remuser, kill, killuserDepending on your rank and the [username]'s rank this will attempt to remove [username] from the database.
banrotation [mode]brIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. If [mode] is number/capacity it will set the ban limit capacity for each moderator.
channelprotection [mode]cpIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. If [mode] is password on/off it will toggle the password being asked before banning a user.
clanbanning [mode]clIf [mode] is on/off it will toggle the feature; ? or status will give u the current status.
clientbanning [mode]cbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. To change a client's feature, client can be PLUG/STAR/SEXP/W2BN/WAR3/W3XP/D2DV or D2XP and toggled using on/off.
floodbanning [mode]fbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. To change the sensitivity [mode] can be mode low/normal/high.
idlekicking [mode]ikIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. To change the time type time 15/30/60.
massloadbanning [mode]mlbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. [mode] can also be numbers on/off or joins on/off.
outsiderclanban [mode]osbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status.
phrasebanning [mode]phbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. You can set [mode] to 'list' to display all phrasebans or phrase [phrase] to find a certain phrase.
pingbanning [mode]pbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. [mode] can also be 0 on/off, -1 on/off, 300 on/off or 500 on/off.
safelistchecking [mode]slIf [mode] is bypass/check it will toggle the feature; ? or status will give u the current status.
spambanning [mode]spbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status.
statsbanning [mode]sbIf [mode] is on/off it will toggle the feature; ? or status will give u the current status. To change a stat's feature, client can be STAR/SEXP/W2BN/WAR3/W3XP/D2DV or D2XP and toggled using on/off.
addclan [string]This will add [string] to the clanban database.
addphrase [string]This will add [string] to the phraseban database.
sweep [channel]This will attempt to ban all users in the specified [channel].
kick [string] ([message])kThis will attempt to kick users matching the [string] with [message] (if provided).
qkick [username] ([message])qkThis will attempt to kick [username] with [message] (if provided). This will ignore the queue.
ban [string] ([message])bThis will attempt to ban users matching the [string] with [message] (if provided).
qban [username] ([message])qbThis will attempt to ban [username] with [message] (if provided). This will ignore the queue.
ipsweep [channel]This will attempt to ban and ignore all users in the specified [channel].
ignore [string]i, ign, squelch, sqThis will attempt to ignore users matching the [string].
qign [username]qiThis will attempt to ignore [username]. This will ignore the queue.
unignore [string]ui,unign,unsquelch, unsqThis will attempt to ignore users matching the [string].
qunign [username]quThis will attempt to ignore [username]. This will ignore the queue.
rejoinrj, resignThis will quickly rejoin the current channel.