Welcome to Heresy. I hope you enjoy the bot as much as I do. Here is a quick how-to on the bot followed by a F.A.Q. to help with the most common questions and problems. Heresy designed by Ro$eTh0rN. Versions 1.3 on up with help from +D+Stryfe+D+.

-`.unzip it

-`.open users.cfg and delete any and all the users/shitlisted tags in it by default that you don't want in there. note - it would be at least halfway INTELLIGENT to edit this file.

00 Shitlist - used when autoban is set to SHIT - format: 00 tag or 00 name

10 Safelist - used when autoban is set to ALL - format: 10 tag or 10 name

20 User - seen, ban, unban, and kick - format: 20 name password

30 User - shitadd, designate, and say - format: 30 name password

40 User - rejoin, join, shitdel - format: 40 name password

50 User - banall, banshit, banoff, useradd, userdel, replyon, replyoff - format: 50 name passwd

-`.open autodes.cfg and delete any and all the users you don't want in it. note - it would also be wise to edit this one.

format: Full_name_here

-`.open servers.cfg with notepad and put the battle.net servers you want the bot to use in it. it will try the first line first, etc. so put your favorite at the top. do not leave any blank lines or commented lines in this cfg file.

-`. run heresy.exe

-`.type in the appropriate info in the windows that ask for them. this will be your bot's name, bnet server, home channel, anti-idle, etc. you are free to change any of this info later on by right clicking in the @BoT window and going to the Bot Stuff menu.

Other:

For a user to control the bot, they whisper it in the format: /msg botname theirpass command blah, or outloud in the channel as #command blah. Ex.- /msg HeresyBot somepass ban Guest or just #ban Guest outloud in the channel.

Certain commands are ignored if used outloud: rejoin, join, useradd, and userdel require the user to whisper the bot with the password.

The bot ignores diablo shareware users for autodesignate and all #commands, however not for whispered commands with the password.

The bot will auto-unban users level 10 or higher if it has split ops.

-`. /refresh - will refresh all .cfg files

-`. /bj - will ban last person to join the channel

-`. /bl - will ban last person to leave the channel

-`. /wf <message> - will whisper the last person to whisper you

-`. /wf <message> - will whisper the last person you whispered to

-`. /w1 to /w4 <message> - will whisper the people set on whisper list.

-`. /wlist - will show the people currently set to whisper

-`. /wclear - will clear the whisper list

-`. /who1 to /who4 - will /who the channels set on who list

-`. /whoall - will /who all 4 channels you have set.

-`. /wholist - will show current who list

-`. /whoclear - will clear the who list

-`. /whoset1 <chan1> to /whoset4 <chan4> - set who list for /who channels 1 through 4

-`. /up - will show current uptime.. your uptime is time since you last rebooted your computer, not online time.

-`. /mp3 - activate nmp3 player.. note you must have nMp3 -> Options -> Display -> Say -> Active channel/query for msg to bnet.

-`. /gates <gate1> <gate2> <gate3> <gate4> <gate5> - set wingates to use on Nbbot.cfg autowrite

-`. /setdupe <name> - will set a person's name that you plan to dupe

-`. /dupe - will write the Nbbot.cfg to dupe <name> on 10 different servers

-`. /server -will display the b.net server you are connected to

-`. /squelchadd - adds a name/tag to the squelch.txt

-`. /safeadd - adds a name/tag to the safelist

-`. /shitadd - adds a name/tag to the shitlist

-`. /firethm /bnetthm /alienthm /defaultthm /redbluethm and /uothm will change the current theme file

F.A.Q. (and maybe some answers):

-`.Q.- It won't connect, what's wrong?

A.- Hell if i know...be more specific...

-`.Q.- I get /sockaccept bnetconnect ** Socket in Use ** or something like that, what's wrong?

A.- This is a rare occurance and usually happens when your internet connection drops while the bot is on bnet. I've had it happen to me 3 times now. Bascially port 2053 is still in use by windows and will not free itself up until you reboot. You can get the bot onto bnet again without rebooting by connecting to irc first with /server irc.core.com (or whatever irc server you prefer), but it will not autoreconnect properlly until you reboot. Another option is to change the default port used (2053) in heresy1.her and heresy2.her (1 entry of the port number in each file) if you are comfortable with mirc scripting. but keep in mind it will keep using your new port until you change it back.

-`.Q.- Ok it did the whole port 2053 connection thing, but i keep getting connection refused when it tries to log on bnet. What's wrong?

A.- The battle.net server is either down, badly lagged, or refusing to allow you to connect for some other reason. If you have a bot on already, that's most likely your problem. Leave it alone, and it will continue trying to connect. If you want to switch servers, go back to the Status window and goto Server Switch. From there pick another bnet server and try again.

-`.Q.- Yay! I got it on battle.net! what's that window for with all the numbers and server shit for? (note-this window will be called "heresy")

A.- That's just a raw dumpage window. It shows the information being sent to and from bnet. If you close this window you will disconnect from bnet. Do your chatting for bnet in the @BoT window (the one with all the colors).

-`.Q.- uhh ok, i got it online, and i can talk and stuff....what now?

A.- heh...where to begin?

right click in the @BoT window you'll see a popup menu. this has some of the more common shit you'll wanna do, like: add users, shitlist people, set/change anti idle, as well as bnet comands. Highlight a name in the right side nicklist, and then right click...it'll show that person's name on the top of your popup menu. this is showing that all the popup commands related for a specific person will be for this person. Clicking on their name in the menu (up top) will open a box to type a whisper message into, this is called "Quickwhisper" Example of menu commands: I wanna ban Guest3 from my channel. i highlight Guest3 by clicking on his name once, then right click and go down to "Ban"...it'll ban Guest3. You can always use just /ban Guest3 btw :P

now hit F1. this will spam a list of hotkey commands on your screen for you. now highlight a name on the right side nicklist and hit F1 again. it'll show that you can perform some of these commands on that person. F2 thru F12 are all hotkeys. want more added? contact me.

now hit Control F1. this will spam a loooong list of /commands you can type in the @BoT window and a brief explanation of each.

the popup menu, hotkeys, and /commands listed are not all-encompassing...there are tons of features that you might not know exist till they take effect. If i made a list of all of em, i'd be one tired puppy. just play around with the bot (make sure you don't have ops when you try something you aren't sure about though) and you will learn what it can do.

-`.Q.- Can the bot flood off bnet?

A.- Yes, only if you flood it yourself though :P You can drag your mouse over text on the screen and it'll auto-copy it. Control+V or Right Click+Paste will paste whatever you highlighted to bnet. If it's over 3 lines or so, you WILL flood. Also if you keep typing away while your bnet server is frozen in lag, everything you typed may appear at once and flood you. By itself, the bot cannot be flooded, however you can flood your own bot by being stupid on the copy/paste, or typing incredibly fast, or unlucky with lag :)

-`.Q.- Does the bot autorejoin for ops when it's alone in a channel? And does it have a /rejoin command?

A.- Yes, and yes. The bot will rejoin for ops when it's left alone in a channel. The /rejoin command is still in the bot for when you have ops, plus we've added /rej to it to simulate a rejoin when you don't have ops. The bot joins another (random) channel and joins the channel it was in. The /rej command skips the anti-flood timer (we figured if you were gonna rejoin, you wanted it to be fast) so be careful, typing it just twice in a row will flood you. That's 4 joins going to the battle.net server.

-`.Q.- The anti-idle choices confuse the hell outta me... can you explain them?

A.- Timer idle is like normal anti-idles where you type in some message and have it appear every so many seconds/minutes. This is totally blank to begin with, no -- Heresy 1.41 -- tacked onto it or /me added to the front. The Random Idle is set to read from quotes.txt in your main bot directory. It will randomly pick a line from quotes.txt each time it idles. Make sure you have no blank lines at the end of the .txt file or you will have a blank idle sometimes. Feel free to edit this file. Uptime idle will show your computer uptime (time since last reboot) followed by a random message. The uptime idles are found in reboot.txt in your main bot directory. Feel free to edit this file. Null idle will idle your Timer idle message, but only when the channel is silent (ie - when the bot receives a 2000 NULL from battle.net). Off - well, you figure it out :)

-`.Q.- My anti-idle isn't working, what's up with it? Or I cannot change the time between idles.

A.- If your idle isn't working at all, right click in the @BoT window and go to Bot Stuff -> Anti-Idle. Make sure you don't have it turned off. the timer idle is set to 4 minutes, the uptime is set to 2 minutes, the random is set to 2 minutes, and the Null will only trigger on a silent channel. i didn't give the option to change the length of these idles, they are fast enough to please me, and slow enough not to be annoying. i *hate* 60 second idles and will not give anyone that option on heresy.

-`.Q.- I keep getting **error: no such nick - line # heresy2.ini (or something to that effect). What's the problem?

A.- Somehow your bot got disconnected from bnet and the anti-idle didn't shut off. (Probably). To fix this open shit_to_do.mrc with notepad and delete all the lines in it. This .mrc file holds everything the bot is waiting to send to the bnet server. I have yet to see this error in the most recent versions of heresy, but it could happen ;)

-`.Q.- Can the bot log on with wingates or proxies?

A.- you cannot wingate heresy, and for all you geniuses out there planning to use sockscap to proxy your heresy onto battle.net, let me give you a warning. the bot is programmed to send your username and password when it detects a connection. when you sockscap it, it detects TWO connections, and sends your info twice. sometimes the 2nd time will be said outloud in blizzard chat. this doesn't happen everytime, you could be lucky and log on heresy 100 times before it happens to you, but it *will* happen to you eventually. don't come to me bitching that your bot spammed your password on battle.net if you sockscapped it. you are forewarned :)

-`.Q.- Can I log on tons of bots?

A.- Did i name it massbot???

-`.Q.- Can I rename the bot, and claim it as mine? (yes people, this was actually asked of me more than once)

A.- Can I stick a large object in your anus sideways?

-`.Q.- What language did you write this in?

A.- duh... it's an mIRC bot... i wrote the scripts that mirc.exe evalutates. it's called *gasp* mirc scripting....

-`.Q.- is the bot stable?

A.- it is for most people... unfortunatley nothing is stable on my computer, but most i've asked haven't had a problem with it staying online. version 1.4 on up seem to be very stable for everyone i've talked to, i haven't had mine crash once, or drop without my isp dropping me yet.

-`.Q.- will you marry me? (ok.. so it's not bot related, but it IS a f.a.q. heh)

A.- No.