NewerthBot [0.9.5]

[Keshoon]

NewerthBot
Version 0.9.5
__________________________________________________

About
This is one of the very first "chat bots" created for Heroes of Newerth, it comes with basic commands such as: say, whisper, etc. It is written in C# and uses CupHead's HoNClient library to pass the process of making the connection. It is also capable of allowing integration of .NET plug-ins that inherit the LibBot.IPlugin interface in LibBot.dll. This allows fellow .NET programmers to create their own features using the events given from the LibBot library.
__________________________________________________

Screenshots

http://dl.dropbox.com/u/2683550/Heroes%20of%20Newerth/Images/ScreenNB1.png

http://dl.dropbox.com/u/2683550/Heroes%20of%20Newerth/Images/ScreenNB2.png
__________________________________________________

Installation and Requirements
DOWNLOAD HERE (http://dl.dropbox.com/u/2683550/Heroes%20of%20Newerth/NewerthBot.zip)

Download the application ZIP file from here (http://dl.dropbox.com/u/2683550/Heroes%20of%20Newerth/NewerthBot.zip) and extract it anywhere on your computer, it really doesn't matter. After extracting, run the 'NewerthBot.exe' and follow the instructions below!


Requirements? What? Yes! In order to use this program to its full extent, you will need Microsoft's .NET Framework of v2.0 or higher.
__________________________________________________

Instructions
Using the bot is simple, press Connect, input your username and password and BAM! Connected!

Here are a list of current hardcoded commands (not including any plug-ins):
whisper, leave, join, say.
__________________________________________________

Upcoming Features

Many new games for the bot, hoping to do poker.
More interesting commands for clan members.
Pre-processing UI events for plug-ins along with adding new events.


__________________________________________________

Known Issues

Bot doesn't have a flood protection.
Bot can't leave first channel it joins and sometimes HoN # channels.

__________________________________________________

Currently focusing development on

Plug-in integration and documentation.
Building a new Settings form to work with options from plug-ins.
Flood protection.

__________________________________________________

Open-source
I've documented (to an extent) the LibBot project, found here (http://code.google.com/p/newerth-bot), which contains all of the main functions used by NewerthBot. This includes EVERYTHING that I use to compile the application, no more half-assed SkeletonBot. It is open-source, you can release it as your own work if you use parts of it, but PLEASE GIVE CREDIT! I didn't go through all that finding out you've taken credit for all the work. All information about becoming an active developer for the project is on the wiki page.
__________________________________________________

Credits
Keshoon for the creation of this application.
S2Games Team for this excellent game!! :D
__________________________________________________

Changelog (http://dl.dropbox.com/u/2683550/Heroes%20of%20Newerth/NewerthBot/changelog.txt)
__________________________________________________

[B]Feedback is appreciated and I'm always taking suggestions!
Also, remember that this is a BETA!

[Keshoon]

Reserved~

Thread was remade since I went through a whole remake of the application straight from the bone. I was able to improve a lot of the mistakes I made when I made my first attempt, so I thought it was reasonable to clear any old feedback.

[DracroniC]

Everytime I try to run it I get an error msg from windows saying "newerthbot has encountered a problem and needs to close". And yes I do have .net framework 2 or higher. Happens on multiple computers for me too.

[HowHigh2]

Yay gonna try it live

[Aizen`]

Crashing upon startup.
Ran as Administrator, and as Windows XP Service pack 3.

Running Windows 7 64 bit

[Keshoon]

Alright, what OS are you on DraconiC? I know for sure that the bot should be able to run on a Vista 32-bit, because I was able to test it a few times before posting. I already know what's causing it if it's a problem commonly found in XP and Windows 7 users. I hadn't a chance to confirm it though, I wanted to get the bot out before I hit the bed to get feedback, so I didn't have time to test it on my VMs.

If either of you know how to check the event of the crash, I'd like to know the error that showed up. It should be something like "System.IO.FileNotFoundException". If it is, thanks for confirming and I'll figure out a fix when I get home.

[DracroniC]

Windows XP sp3 and yea. P9 for the error signature is system.io.filenotfoundexception.

[HowHigh2]

Some how i cannot run the program : soon i start i got an error which say : the program have stop functionning..... and doesnt give me the error.......

I got win 7 64 bits........... what should i do ? I need this bot :(

[DracroniC]

Also, thanks for the continued work on this Keshoon.

[Keshoon]

Updated to v0.9.1, tested and confirmed to work on XP, Vista and Windows 7 [32-bit] (Confirmed through VMs). Issues with start-up should be fixed, and a bunch of other stuff I'm sure no one even got to test.

[DracroniC]

Works. Tools>Settings brings up nothing.

[Keshoon]

Works. Tools>Settings brings up nothing.

Intentional, it's not complete yet. I guess I could've at least put a message box or something. Thanks for telling me anyways. :)

[DracroniC]

Also, does Trivia work? If so how do you initiate it?(can you initiate it using the bot). And can you add to the trivia.xml following your current options?

[Keshoon]

Trivia works the same as the other one. !trivia <category> <questions>. The only one available at the moment is THS with 33 questions. Maybe I'll add an information window for each plug-in to include commands and such somehow.

You'll be able to add trivia categories/questions when I get the settings thing to work. For now you need to add it yourself manually in settings.xml in its plug-in folder.

[DracroniC]

Nice, works. Although the hint system seems to be off. After I answered a question properly it gave me 2 auto hints toward the next question. Also can't wait for the bot to support whispers.

[HowHigh2]

Thx lot its work now : just miss tool : settings o-O lol :)

[Goonik]

is this the bot which can invite players to clan if the player whispers them?

[Keshoon]

It used to be able to do that in the older bot, I haven't added any clan commands yet for the beta. But I'll do it eventually. Unless someone wants to test the plug-in integration and try doing it themslves. ;)

[HowHigh2]

i dont know why some time im stil getting frame work error.... than the program close.... and can be reopened and work again......

[Keshoon]

i dont know why some time im stil getting frame work error.... than the program close.... and can be reopened and work again......

Can you explain your situation a bit more? Does it error at random times? Approximately how long does the bot last before it errors? Is there anything you specifically do before it commonly errors? You're on 64-bit, so that might be it. I'll try making a second build.

[DracroniC]

Hey Kesh, I was playing some trivia today and out of nowhere the bot crashed. I checked for detailed info and got this:


EvenType : clr20r3 P1 : newerthbot.exe P2 : 1.0.0.0 P3 : 4cbdeb6f
P4 : honclient P5 : 1.0.0.0 P6 : 4cbe35db P7 : 278 P8 : 6fd
P9 : system.exception


Also the bot doesn't seem to understand when it gets kicked for chat flooding or reconnect after being kicked.

[Keshoon]

Hey Kesh, I was playing some trivia today and out of nowhere the bot crashed. I checked for detailed info and got this:


EvenType : clr20r3 P1 : newerthbot.exe P2 : 1.0.0.0 P3 : 4cbdeb6f
P4 : honclient P5 : 1.0.0.0 P6 : 4cbe35db P7 : 278 P8 : 6fd
P9 : system.exception


Also the bot doesn't seem to understand when it gets kicked for chat flooding or reconnect after being kicked.

It looks like the bot crashed from attempting to send a packet to the chat server while the socket was already either disconnected or disposed (Probably from being disconnected by the chat server for flooding). I'll try to fix it to correctly know when it was disconnected from the server. Thanks.

[Keshoon]

[10.21.2010] v0.9.2 -----
* Added documentation to LibBot events and public voids.
* Added new LibBot events
- onClanInvite: Occurs when the bot receives a clan invitation from a player.
- onDiceRoll: Occurs when a player rolls dice in a channel.
- onNameChanged: Occurs when a player's name changes in a channel.
- onPlayerDemoted: Occurs when a player is demoted in rank of a channel.
- onPlayerPromoted: Occurs when a player is promoted in rank of a channel.
* Added new commands
- !uptime: States the timespan in which the bot application has been open.
- !whoami: States a the user's flags.
- !whois <username>: States the specified user's flags
* Added parsing for dice rolls and channel promotion/demotion.
* Fixed the bot to properly detect when it is disconnected from flooding.
* Fixed the emotes from displaying the username twice.
* Disabled Settings menu option until it's actually ready.

Note: Not to confuse a user's "flags" as nationality flags.

[DracroniC]

Well, I didn't see this update till just now. But using the version I just was. Every new whisper I received kept opening in a new window and I could not respond to them and on the 3rd window opening the bot crashed.

Don't know if you fixed it this version or not, just trying to help get this running smooth =)

[HowHigh2]

It used to be able to do that in the older bot, I haven't added any clan commands yet for the beta. But I'll do it eventually. Unless someone wants to test the plug-in integration and try doing it themslves. ;)

i would like to do it..... since i already made come code in past but i dont know xml :(..... if u had a kind of min draft of how it's made i could give a try :P SAME for trivia : i dont know how all your bot work .... i would require mini tutorial ^^!

your doing good :) waiting clans commands & Bot access + flags much as stealthbot for wc3!

keep the good work man !

[SaintKnightz]

thx for this great tool

[hanzlo]

im scared to type my pass in that **** rofl

[HowHigh2]

Can you explain your situation a bit more? Does it error at random times? Approximately how long does the bot last before it errors? Is there anything you specifically do before it commonly errors? You're on 64-bit, so that might be it. I'll try making a second build.

i got win 7 : 64 bits : 4 gb rams, quad core , geforce gts 250


the problem happen after a couple of hour. i cant tell you how exactly it happen : but it said framework error : next time im goonna screenshot it.... if i found the way to edit my own post o_O


the bot long ast least 1 hour most of time. the only thing we did with bot : was the trivia and !say hi... since i dont know other command

[Doogal]

opens application but does nothing else no connecting no errors no nothing

[Keshoon]

What OS and bit? Does the application freeze up after putting in your credentials?

[Doogal]

win xp home edition service pack 3 intel pentium 4 2.40gh 2g ram

[Keshoon]

win xp home edition service pack 3 intel pentium 4 2.40gh 2g ram

What bit? 32-bit? or 64? And did it end up freezing when you put in your credentials?

[Doogal]

32 bit sorry for the late reply.. it doesnt do anything as soon as i click logon. even if i delibrately enter wrong logon details it still does nothing

[DrRisan]

How do you start trivia?

[Keshoon]

Look through the thread to see the trivia commands. I mentioned them already. I'll also look onto why it isn't logging in.

[DracroniC]

How do you start trivia?

In case you didn't get it "!trivia THS 5" in chat would give you a series of 5 questions. Obviously change the 5 to however many questions you want.

[Emin3m]

do you remind the link of the trivia tutorial ?

[DracroniC]

If the bot is in the middle of a trivia game, and it gets kicked from the chat server and reconnects it stops giving hints for the question it was on.

[Keshoon]

[11.03.2010] v0.9.3 -----
* Added an auto-updater.
* Added message replying (/r).
* Added bot flags for users.
- Bot flags are used to determine what commands a user is capable of using.
- A flag can be any character and is case-sensitive when used by plug-ins/commands.
- The 'z' flag is an all-purpose flag. Designed to remove the process of "adding every flag" for full access.
- No two plug-ins may use the same bot flag. If it so happens to occur, the bot will only load the FIRST plug-in it scans.
* Added new LibBot public voids and events.
- GetBotFlags(): Overloaded. Can return a List or a boolean.
- onPluginConflict: Occurs when two plug-ins attempt to use the same bot flag.
* Added new IPlugin properties.
- List BotFlags: Character list containing the bot flags reserved by the plug-in. Bot flags are case sensitive and two plug-ins may not use the same bot flag.
- List Commands: String list containing the commands used by the plug-in. Commands are case in-sensitive.
* Added new commands.
- !admin [parameters] (Requires flag 'a')
> add [username] [flags]: Adds a new user to the local database with bot flags.
> remove [username]: Removes an existing user from the local database.
> update [username] [flags]: Updates an existing user from the local database with new bot flags.
* Changed !whoami and !whois to reflect bot flags rather than channel flags.
* Removed IM windows.
- IMing will now be done in the same fashion as whispers, clan messages, etc.

No testing was made, but I guess that's why I have you guys. ;) Sorry that I took so long to get another update out, been rather distracted. I might do a small update next just to test how my new updater works with the manifest idea.

I'm also setting up a GoogleCode SVN repository with the FULL source, no half-assed SkeletonBot anymore. This'll allow people to submit tickets and patches if they wish to contribute to the development, expect it in maybe 1-2 days.

Edit: Comes to show how long it's been since I updated... I forgot to change the version in the title. I can't seem to change it on my iPod so I hope people will notice I've finally updated it *-*.

[Keshoon]

[11.04.2010] v0.9.4 -----
* Added user ID to the attributes of admins in newerthbot.xml.
- Changed !admin to work accordingly.
* Added new LibBot public voids.
- GetUserID(): Gets a player's user ID using his/her username.
- GetUsername(): Gets a player's username using his/her user ID.
- ScanAdmins(): Makes the core scan for any admins.
* Actually added newerthbot.xml to the zip. Doh!

Completely forgot to add the XML for admins... Doh! :3 I guess this is my opportunity to test out the new updater. Give it a whirl and let's hope it works! *crosses fingers*

SVN repository is also up and running! Check it out here (http://code.google.com/p/newerth-bot)!

[DracroniC]

Mmmm, update loop. I check for an update, it says there is one, asks if I want to d/l it. I say yes and then we repeat that over and over =P

[Keshoon]

Whenever you make an update, can you check the manifest.xml? Is the checksum for any of the files changing? Are any of the versions changing? If the checksum is changing, is it different every time you update?

[DracroniC]

Made a copy of the manifest.xml and updated the bot as it asked. Compared the 2 files, no change. Copied that one also, closed the bot, started it up and updated as it asked, compared all 3 files and there is no chance, all 3 are identical.

[Keshoon]

[11.06.2010] v0.9.5 -----
* NewerthBot now downloads NewerthUpdater before updating if any changes were made to it.
* LibBot now returns an UpdateType enum rather than a boolean.
* NewerthUpdater now actually works with the new checksum method. Doh! #2

Required that you re-download manually, since the bot doesn't download the updater first if there was a change made to it. Hopefully this fixes the problem with the manifest not being changed properly.

[DracroniC]

All good now, no more looping issues.

[Enkious]

How do i find out my User id?
<user flags="z" userid="202236" >Keshoon</user>
and what are all the flags? and definition of flags?
z=admin?
s=say?

Edit: Also, Right side of Screen freezes i guess?
settings under tools still does not work... But i think you mentioned that in a previous post
Win7 64b

Kinda a bit of a newb here, i have ran stealth bot, and Nbbot, if anyone remembers that on bnet.

[Keshoon]

Getting the User ID will be done automatically, as will writing inside the newerthbot.xml. Definition of flags will be documented on the Wiki on the GoogleCode page sooooon. There are more important things to get done first. So in other words, adding admins will be done either under the Settings window when its done, or in the channel using the !admin command.

Could you explain what you mean by the "right side of the screen" freezing? When does it happen, and does the bot crash because of it? What exactly is the "right side of the screen"?

[Enkious]

Of course.. where the users are...It wont show when someone joins or leave, unless i minimize it, and bring it back up.
It showed me what was behind the users, like my background in 16b color.
I changed it to 32b color, and now it's a nice Grey screen.
But the screen is still kinda frozen... hasnt crashed because of it....
Ima let it run for a day or 2... and see what happens.

So there is no way i can get my user id?
Cause i do !say whats up.. and it says you need the S flag to use that command.
It takes up a lot of resources as well, after running trivia for a while... then crashes.

Edit: well i guess it don't technically freeze.. when a user joins it shows it, but if i click other channels, i have to minimize it and bring it back up.
I Ran it on my other pc, winXP, home.

And it looked way better. I ran trivia, and if no one answered the Questions, it would lock it up here and there, making it impossible to do anything.
I got errors, but wasnt able to open then to look at them. had to alt ctrl del it, to get rid of it on xp.

Sorry to keep editing, posting etc..:but also.. When trivia is on, it gets stuck if no one answers.. Slith_r, and it will sit there, and get slower... and slower and lock up the pc..

[Keshoon]

You said you were in 64-bit Windows 7, right? I'm not too sure if it has anything to do with it, but I'm leaning towards that it has to do with you being 64-bit. I don't have any computers that run an OS on 64-bit, so it's difficult for me to figure out the cause and solution. If ANYONE has knowledge of how to resolve this issue with 64-bit users, I'd appreciate it if you could drop me a PM regarding it.

You can get your user ID manually by using the XML API by S2Games. You can do so by browsing to http://xml.heroesofnewerth.com/xml_requester.php?f=nick2id&opt=nick&nick[]=Enkious (If your in-game name is actually Enkious). It'll display your user ID on the page.

But now that you've mentioned it... I totally realized I already put flags on most of the commands, so you can't even use them without placing your name in the newerthbot.xml. I'll try to get the next version up as soon as I can. But I want to make sure the plug-in settings makes it in at the same time.

Regarding the memory usage issue, I'll look up more on using Dispose and IDisposable. I didn't really use it much and I don't really know a lot about it, so I want to make sure I'm using it correctly if I want to try to fix that issue. You'll see it maybe in a few versions depending on how much time I spend reading up about it.

[DracroniC]

Very nice, the updates will help.

Currently the only thing I see that I can think needs fixing, is when someone in your channel joins a game, their icon changes, but if you switch tabs to friends or clan and then go back to the channel tab their icons are reverted back to their default ones so it doesn't show them as in a game.

[Enkious]

Sweet Deal, the UserID worked. I can use the !say command now.

[Enkious]

I think it just takes up resources, when people don't answer the questions.. can u make it to where, if no one answers the question, it just gives the answer, and continues on to the next question?

[DracroniC]

I think it just takes up resources, when people don't answer the questions.. can u make it to where, if no one answers the question, it just gives the answer, and continues on to the next question?

Yea, I just had this recently. A buddy was playing trivia between being dead. Then he stopped dying and mid way through the trivia the bot began to lag my whole comp and then it eventually froze and I had to end process to get rid of it.

[Enkious]

[13:08] EnkTrivia: Question #1 of 33: [WHS] I'm ready to die... but you're killing me!
[13:09] EnkTrivia: Hint: M-----
[13:09] EnkTrivia: Hint: Ma----
[13:10] EnkTrivia: Hint: Ma--a-
[13:10] EnkTrivia: Hint: Mad-a-
[13:11] EnkTrivia: Hint: Madma-

Then it lags out...
After the End there... another 30 seconds go by..
you should just make it go...
[13:11] EnkTrivia: The Answer was "Madman" Next Question!
etc..

Maybe a !trivia off command as well...
!joinclan don't work.
I don't know if you have implemented that in or not..

Also maybe a !trivia Catagories
it would then say...
[13:11] EnkTrivia: THS (things heroes say) 33. SAH (stuff about hon) 69 etc...

Also, i added more Questions, and made it up to about 102...
But as the bot keeps going threw questions, it slows down my computer, and i have to End the process on it.
It runs fine for a little while... but slows WAAAAY down.
Any news on any updates? like an ETA? or anything? id like to give my members some insite....
Sorry, i don't mean to push you or anything, just wondering.. i know this is your first, and you make it out of fun..
Im sure you will be outstanding, sooner then later. Thanks!

more to add... here is a trivia bot that works for Battle.net.. I don't know if this will help you at all....
http://www.elitegrounds.net/bots/S55v2.5.zip

This is another one.

http://www.elitegrounds.net/bots/station55v2.0b1.zip

I would scan it aswell before opening.
But thats just me.

[Enkious]

So... Did this thread just die? or... what?

[Keshoon]

Just... Rather distracted with other matters. I keep a list of things to do when I get to it, dun' worry.

[Enkious]

Ok. good to know! thx!

[Emin3m]

how do i find commands ? said i need flag.... but how do i add flag lawl.

some1 know ?

[Enkious]

how do i find commands ? said i need flag.... but how do i add flag lawl.

some1 know ?

Im not sure of all the commands, i know a few have not been implemented.. Do you have your user ID? if not it's 2436337
need to edit the file, and put your name in. whisper, leave, join, say.

[Keshoon]

It's been awhile since I've given a current status of the development. I've been rather busy and distracted by other matters that sort of made me think I was better off pausing development for about a week. But I'm free the majority of this weekend so I've decided to give a quick update on what I WAS able to get done and what I plan to get done this weekend. Here I go!

Settings and plug-in settings: pain in the arse. I wanted to get the simplest way of making settings for plug-ins, but it's going to get complex. I'll be making a specialized class inheriting an interface for each type of advanced setting (Trees, combo boxes, categorizing, etc.). The basic settings (integer, string, boolean, etc.) was rather simple to put in so it'll easily make it in the next update. I understand people want the settings to make admins and flags ASAP so I'll be keeping advanced settings for another update. Things that need to be done regarding this area: general settings, layout construction and saving/remembering settings.

Memory usage: no research done whatsoever. I do know, however, that the memory gets vacuumed when it's looping on the last letter of trivia hints. So it'll be as simple as stopping the timer completely to fix that. I'll still need to research code that commonly uses up a lot of memory and figure out how to use Dispose to fix that. Expect the trivia hint fix next update, expect the other memory usage issues to be fixed after the advanced settings.

Documentation: most satisfied with out of the 3. It's going good, documenting the library isn't as bad as I thought. Documenting everything else onto a wiki, however, is. I can probably blame my perfectionism for that. Not much of a big priority since it doesn't seem like I'm getting much participation for the community regarding plug-ins (which I oh so hoped for at least a bit!), expect to BEGIN finishing in 2 weeks, expect it to be FINISHED in 3 weeks to a month and expect an official release (installer and all that junk) after that!

Keep up the good feedback on the errors, issues and suggestions! I don't think it's gotten more than a week without a good suggestion or a good bug report!

[Enkious]

Just tell me when you make an update, and i will give you more feed back, i refresh this page every day, So i await the news, to click Update.
I will give you as much feedback as i can. So far, the issues I've already presented are the only ones I've had.
I wish i could give you more reports.. but there isnt any.. lol

[HowHigh2]

Im not sure of all the commands, i know a few have not been implemented.. Do you have your user ID? if not it's 2436337
need to edit the file, and put your name in. whisper, leave, join, say.

if i got an user id ? isnt the user number they give u when you buy the game ?.

can u tell me which files to open and a line exemple ? long time i didnt code somthing.

[Enkious]

http://xml.heroesofnewerth.com/xml_requester.php?f=nick2id&opt=nick&nick[]=SageOf6Path

Go there for your user id. If SageOf6Path is your ingame Name.

Open newerthbot.xml With Notepad.
<user flags="z" userid="1209852" >[No]Enkious</user>
Thats mine.. so change your User ID, then your name. Keep the Flag of Z.
If you are in a Clan, Then make sure you put your tag in there aswell.

[Lord_Kelvin]

tools->settings grayed out for me...is that only me?

[Castigate]

Hey Keshoon, is the plugin example source available yet? and why won't it connect anymore?