BHBot is a program that automates the Bit Heroes game. It is a non intrusive program that works by opening up a Chromium window and controls the game by taking a screenshot every few seconds, detecting cues from the screenshot and then simulating mouse clicks. BHBot is a good example of how to create such bots to automate flash games or other browser games (it can be easily adjusted to play other games).
Once configured and running the bot is designed to run unattended indefinitely.
This bot will automatically farm items, familiars and schematics running all current content:
The level/difficulty for each activity can be defined in the settings file. The bot can also:
If the bot detects a "Disconnected" dialog, it will pause its execution for an hour giving the user a chance to play manually. Disconnects are usually result of another instance logging into the game. This is why bot pauses in case it detects it.
You can download the latest stable release BHBot.jar from the releases page.
For the latest functionality it is recommended to compile your own version as there are frequent commits with bug-fixes and new functionality between major releases.
See the wiki for the first time setup guide.
Here is a list of most common commands used with the bot (must be typed in the console window, or, if you use web interface, in the command input box):
do dungeon|expedition|gauntlet|gvg|pvp|raid|trials: force the bot to perform a dungeon . Example: "do raid". Used for debugging purposes more or less (bot will automatically attempt dungeons).
hide: hides Chromium window.
pause [mins]: pauses bot's execution. Useful when you want to play the game yourself (either from the same Chromium window, or by starting another Chromium window). The bots is paused untill are resue command is issued or, if specified, for a number of minutes equal to mins
plan <plan_name>: if you have different configurations you can use this command to swith between them. BHBot will look for file named
pomessage [message]: use this command to verify that the Pushover integration is correctly configured. Message parameter is optional and if not specified, a standard messabe will be sent.
familiars: output the full list of supported familiars in the encounter management system
version: output the version of BHBot. This is is useful when reporting a bug
readouts: will reset readout timers (and hence immediately commence reading out resources).
reload: will reload the 'settings.ini' file from disk and apply any changes on-the-fly.
resetini: will reset your current ini file to the default content.
restart: restarts the chromedriver (closes Chromium and opens a fresh Chromium window). Use only when something goes wrong (should restart automatically after some time in that case though).
resume: resumes bot's execution.
set: sets a setting line, just like from a 'settings.ini' file. Example: "set raids 1 3 100", or "set difficulty 70". Note that this overwritten setting is NOT saved to the 'settings.ini' file! Once you issue
shot [prefix]: takes a screenshot of the game and saves it to 'shot.png'. If a prefix is specified it will be used instead of the default shot one.
show: shows Chromium window again after it has been hidden.
stop: stops the bot execution (may take a few seconds. Once it is stopped, the console will close automatically).
BHBot was originally created by Betalord. On 29th of September 2017 (the 1st year anniversary of the Bit Heroes game) he quit the game and released the bot to the public. In December 2018 Fortigate picked up the development and from March 2019 ilpersi joined him to make the bot what it is today. In June 2019 the project ownership was tranferred to ilpersi, granting autonomy moving forwards.
The bot would not exist without everybody who uses or contributes to it.
A special mention goes to the teams that created two amzing products:
Hopefully this bot will prove useful to you, if you have any questions just raise an issue or join our gitter room in which you can talk directly with the developers! Enjoy :-)