Bit Heroes bot v1.0.3

Changelog:

• Fix color tolerant on Windows 7
• Do some technical change

Upgrade notes:

• Move the follow files and directory from previous bot version's directory
  • chrome-user-dir directory, that folder was created by chrome to do temp cache and also save your game's setting
  • user-config.properties file, it contains your configurations

---

Bit Heroes bot

on Linux / Windows / MacOS

Wiki version

This readme file is for normal users

Developers please read at my github

There're some additional information for MacOS users, please read at bottom of this page

---

Only support game resolution 800x520

Therefore:

• Can only use this bot to control game on web version at kongregate.com
• Can not use for Steam version which does not have Window size 800x520 option
• Not sure about Android emulators (like Nox, Blue Stacks,..) because not tested

*It is recommended to play game using mini client

Contains the following functions:

1. Detect and click ReRun button while in Dungeons and Raid
2. Auto fishing
3. Launch game in mini client using Google Chrome

Also supports pushing messages to Telegram for notification purpose

Minimum requirement:

• Java 8 (not tested on version 9+ but probably it works)
• Google Chrome installed (if you wish to use the mini client)

Configure:

Have to configure the user-config.properties file

Watch out the following keys:

• offset.screen.x
• offset.screen.y

They are the coordinate where your game screen starts.
How to fill it correctly? Read me

To enable Telegram notification, follow me

• Set the bot private key to telegram.token
• Set the channel id to telegram.channel-id

How to use:

ReRun

• Windows: run file .\rerun.bat
• Linux/Mac: run file ./rerun.sh

Supported flags:

• --exit=X means will exit after X secs if not completed, no matter how many loop remaining. Usage: ./rerun.sh 100 --exit=3600 means will stop ReRun after clicked ReRun buttons 100 times or after 3600 seconds (1 hours), depends which condition completed first
• and global flags (read at the end of this page)

Notes:

• Automatically exit if can not detect the ReRun button within 15 minutes
• Automatically exit after detected the Reconnect button
• Support click the arrow button when having a conversation
• Push notification to Telegram when detect Reconnect button (critical), not see ReRun within 15m (critical), exit (normal). But only works if you correctly configured Telegram

Fishing

• Windows: run file .\fishing.bat
• Linux/Mac: run file ./fishing.sh

Supported flags:

• --exit=X means will exit after X secs if not completed, no matter how many loop remaining. Usage: ./fishing.sh 20 --exit=1800 means will stop fishing after fishing 20 times or after 1800 seconds (30m), depends which condition completed first
• and global flags (read at the end of this page)

Mini client using Google Chrome

Steps:

1. Make sure you can play game on Google Chrome web browser at https://www.kongregate.com/games/Juppiomenz/bit-heroes
2. Press F12 to open Dev Tools
3. Go to Console tab of Dev Tools
4. Open file prepare-mini-chrome-client.txt
5. Paste the content into the Console tab
6. Copy the output into user-config.properties file, make sure to override the correct properties
7. Generate mini client using:

• Windows: run file .\client.bat
• Linux/Mac: run file ./client.sh

Enjoy it

• Windows: run file .\mini-game-on-chrome.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome.sh

Project-wide flags

• --help show help for specific application, for example: ./rerun.sh --help
• --mute do not push notification to Telegram
• --img save screenshot into ./out/images/<app> directory, only use for debugging purpose

Tested environments:

OS	Result
Ubuntu 18.04 (development environment)	Work perfectly
Windows 10 x64	Work perfectly
Windows 7 x64 (on Virtual Box)	Work perfectly
MacOS 10.14 High Sierra	Bot functions not work, only mini-client works

MacOS users

1. From MacOS 10.13+, java.awt.Robot class of Java can not do mouse and keyboard interaction, thus none of bot functions will work
2. With a bit of luck, you can try to add Java to [System Preferences > Security & Privacy > Accessibility] and see if it works (because MacOS prevent apps from controlling your mac by default).
   If it doesn't work, install a higher version of Java, add Accessibility and try again. If it still doesn't work, just give up
3. Thus this whole project only has the mini-client function will work on MacOS

So this project does not officially supported MacOS, any developer can resolve the above issue, please make a pull request

Bit Heroes bot v1.0.2

Changelog:

• Fix bug on Windows, allow user to specific chrome.exe file location rather than a hard-coded path, which may be wrong sometime
  • Previous: Chrome's path was hard-coded with value C:\Program Files (x86)\Google\Chrome\Application\chrome.exe
  • Now: User able to custom Chrome path by modify key external.application.chrome.path on user-config.properties file

See: user-config.properties

external.application.chrome.path=C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe

---

Bit Heroes bot

on Linux / Windows / MacOS

Wiki version

This readme file is for normal users

Developers please read at my github

There're some additional information for MacOS users, please read at bottom of this page

---

Only support game resolution 800x520

Therefore:

• Can only use this bot to control game on web version at kongregate.com
• Can not use for Steam version which does not have Window size 800x520 option
• Not sure about Android emulators (like Nox, Blue Stacks,..) because not tested

*It is recommended to play game using mini client

Contains the following functions:

1. Detect and click ReRun button while in Dungeons and Raid
2. Auto fishing
3. Launch game in mini client using Google Chrome

Also supports pushing messages to Telegram for notification purpose

Minimum requirement:

• Java 8 (not tested on version 9 and above but probably it works)
• Google Chrome installed (if you wish to use the mini client)

Configure:

Have to configure the user-config.properties file

Watch out the following keys:

• offset.screen.x
• offset.screen.y

They are the coordinate where your game screen starts.
How to fill it correctly? Read me

To enable Telegram notification, follow me

• Set the bot private key to telegram.token
• Set the channel id to telegram.channel-id

How to use:

ReRun

• Windows: run file .\rerun.bat
• Linux/Mac: run file ./rerun.sh

Supported flags:

• --exit=X means will exit after X secs if not completed, no matter how many loop remaining. Usage: ./rerun.sh 100 --exit=3600 means will stop ReRun after clicked ReRun buttons 100 times or after 3600 seconds (1 hours), depends which condition completed first
• and global flags (read at the end of this page)

Notes:

• Automatically exit if can not detect the ReRun button within 15 minutes
• Automatically exit after detected the Reconnect button
• Support click the arrow button when having a conversation
• Push notification to Telegram when detect Reconnect button (critical), not see ReRun within 15m (critical), exit (normal). But only works if you correctly configured Telegram

Fishing

• Windows: run file .\fishing.bat
• Linux/Mac: run file ./fishing.sh

Supported flags:

• --exit=X means will exit after X secs if not completed, no matter how many loop remaining. Usage: ./fishing.sh 20 --exit=1800 means will stop fishing after fishing 20 times or after 1800 seconds (30m), depends which condition completed first
• and global flags (read at the end of this page)

Mini client using Google Chrome

Steps:

1. Make sure you can play game on Google Chrome web browser at https://www.kongregate.com/games/Juppiomenz/bit-heroes
2. Press F12 to open Dev Tools
3. Go to Console tab of Dev Tools
4. Open file prepare-mini-chrome-client.txt
5. Paste the content into the Console tab
6. Copy the output into user-config.properties file, make sure to override the correct properties
7. Generate mini client using:

• Windows: run file .\client.bat
• Linux/Mac: run file ./client.sh

Enjoy it

• Windows: run file .\mini-game-on-chrome.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome.sh

Project-wide flags

• --help show help for specific application, for example: ./rerun.sh --help
• --mute do not push notification to Telegram
• --img save screenshot into ./out/images/<app> directory, only use for debugging purpose

Tested environments:

OS	Result
Ubuntu 18.04 (development environment)	Work perfectly
Windows 10 x64	Work perfectly
MacOS 10.14 High Sierra	Bot functions not work, only mini-client works

MacOS users

1. From MacOS 10.13+, java.awt.Robot class of Java can not do mouse and keyboard interaction, thus none of bot functions will work
2. With a bit of luck, you can try to add Java to [System Preferences > Security & Privacy > Accessibility] and see if it works (because MacOS prevent apps from controlling your mac by default).
   If it doesn't work, install a higher version of Java, add Accessibility and try again. If it still doesn't work, just give up
3. Thus this whole project only has the mini-client function will work on MacOS

So this project does not officially supported MacOS, any developer can resolve the above issue, please make a pull request