Bit Heroes bot v1.5.1

If you like my bot, please give this repo a Star, thanks

Changelog:

• Version 1.5.1:
  • Now bot can be launch without argument and can select specific function to run, also provide flags directly
  • The above upgrade lead to removal of many sh and bat and steam.*.bat files
  • Apply coloring to terminal and change how text display for better UX
  • From now onward, launch bot via:
    • steam.bot.bat for Steam client on Windows
    • bot.bat for Mini-client on Windows
    • bot.sh for Mini-client on Linux/MacOS
    • or from command line: java -jar BitHeroes.jar
  • Generate mini-client via client.* files
  • Do setting via setting.* files
  • See help via help.* files
• Version 1.4.1 fix bug finding Expedition and Trials icon in steam mode
• Version 1.4.0:
  • Added JNA to support auto detect game screen offset (instead of editing keys offset.screen.x|y). Thats why there is an increment of the zip file size: from ~500kb to ~3mb
  • Added new func expedition
  • trails now supported on Steam client
  • afk now supports expedition. Remaining Invasion does not supported by afk for Steam client
  • afk now support select specific World Boss and Raid, require pre-setting via setting app
  • Fix some bugs related to threading and image detection
• Version 1.3.2 support steam for afk
• Version 1.3.1 support steam for world-boss and pvp
• Version 1.3.0 release full feature of afk
• Version 1.2.6 fix bug func rerun on --steam mode

Upgrade notes:

• Move the following file 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 configuration

Bit Heroes bot v1.4.1

If you like my bot, please give this repo a Star, thanks

Changelog:

• Version 1.4.1 fix bug finding Expedition and Trials icon in steam mode
• Version 1.4.0:
  • Added JNA to support auto detect game screen offset (instead of editing keys offset.screen.x|y). Thats why there is an increment of the zip file size: from ~500kb to ~3mb
  • Added new func expedition
  • trails now supported on Steam client
  • afk now supports expedition. Remaining Invasion does not supported by afk for Steam client
  • afk now support select specific World Boss and Raid, require pre-setting via setting app
  • Fix some bugs related to threading and image detection
• Version 1.3.2 support steam for afk
• Version 1.3.1 support steam for world-boss and pvp
• Version 1.3.0 release full feature of afk
• Version 1.2.6 fix bug func rerun on --steam mode

Upgrade notes:

• Move the following file 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 configuration

Bit Heroes bot v1.4.0

If you like my bot, please give this repo a Star, thanks

Changelog:

• Version 1.4.0:
  • Added JNA to support auto detect game screen offset (instead of editing keys offset.screen.x|y). Thats why there is an increment of the zip file size: from ~500kb to ~3mb
  • Added new func expedition
  • trails now supported on Steam client
  • afk now supports expedition. Remaining Invasion does not supported by afk for Steam client
  • afk now support select specific World Boss and Raid, require pre-setting via setting app
  • Fix some bugs related to threading and image detection
• Version 1.3.2 support steam for afk
• Version 1.3.1 support steam for world-boss and pvp
• Version 1.3.0 release full feature of afk
• Version 1.2.6 fix bug func rerun on --steam mode

Upgrade notes:

• Move the following file 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 configuration

Bit Heroes bot v1.3.2

If you like my bot, please give this repo a Star, thanks

Changelog:

• Version 1.3.2 support steam for afk
• Version 1.3.1 support steam for world-boss and pvp
• Version 1.3.0 release full feature of afk
• Version 1.2.6 fix bug func rerun on --steam mode

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 v1.3.0

If you like my bot, please give this repo a Star, thanks

Changelog:

• Version 1.3.0 release full feature of afk
• Version 1.2.6 fix bug func rerun on --steam mode

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 v1.2.6

If you like my bot, please give this repo a Star, thanks

Changelog 1.2.6:

• Fix issue when attemp to run Steam mode

Changelog 1.2.5:

• New function afk

Changelog 1.2.3:

• Auto reactive the Auto button after 60s (during ReRun and auto farm things)
• Able to generate mini-clients for multiple accounts

Changelog 1.2.2:

• Add new functions to farm GVG and Gauntlet beside World Boss/PVP/Invasion/Trials
  • Scripts name: world-boss, pvp, invasion, gvg, trials, gauntlet
  • Not yet supported screen resolution 800x480 (Steam)
  • Note for each function:
    • World Boss: This function is solo only and does not support select level or type of World Boss, only select by default So which boss do you want to hit? Choose it before turn this on
    • PVP: This function only hit first opponent and does not support select PVP ticket cost, so choose it before turn this on
    • Invasion / GVG: These functions does not support select badge cost, so choose it before turn this on
    • Trials: These functions does not support select difficulty and token cost, so choose it before turn this on

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 v1.2.5

If you like my bot, please give this repo a Star, thanks

WARNING Since version 1.2.x, we encounted bugs with steam version, so to use rerun and fishing for steam, please use v.1.1.0

Changelog 1.2.5:

• New function afk

Changelog 1.2.3:

• Auto reactive the Auto button after 60s (during ReRun and auto farm things)
• Able to generate mini-clients for multiple accounts

Changelog 1.2.2:

• Add new functions to farm GVG and Gauntlet beside World Boss/PVP/Invasion/Trials
  • Scripts name: world-boss, pvp, invasion, gvg, trials, gauntlet
  • Not yet supported screen resolution 800x480 (Steam)
  • Note for each function:
    • World Boss: This function is solo only and does not support select level or type of World Boss, only select by default So which boss do you want to hit? Choose it before turn this on
    • PVP: This function only hit first opponent and does not support select PVP ticket cost, so choose it before turn this on
    • Invasion / GVG: These functions does not support select badge cost, so choose it before turn this on
    • Trials: These functions does not support select difficulty and token cost, so choose it before turn this on

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

If you like my bot, please give this repo a Star, thanks

Wiki version

This readme file is for normal users

Developers please read at my github

There're some notes for MacOS users, please read here

---

Officially support game resolution 800x520 (web + mini-client)

Also partially support Steam version with resolution 800x480

Only support English user interface

*It is recommended to play game using mini client

Contains the following functions:

1. ReRun Dungeons and Raid
2. Auto fishing
3. Farm World Boss / PVP / Invasion / GVG / Trials / Gauntlet
4. Launch game in mini client using Google Chrome
5. Do stuffs while AFK

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

Wiki

This function only supports clicking the ReRun button, that means you have to enter Dungeon/Raid manually, turn on the Auto and when the ReRun button appears, it will be automatically clicked

• Mini-client or Web:
  • Windows:
    • click and run rerun.bat
    • or run from command line: java -jar BitHeroes.jar rerun <loop_count>
  • Linux/Mac:
    • run ./rerun.sh from terminal
    • or command java -jar BitHeroes.jar rerun <loop_count>
• Steam:
  • Click and run: steam.rerun.bat
  • Run from commandline: java -jar BitHeroes.jar rerun <loop_count> --steam

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
• Global flags

Notes:

• Automatically exit if can not detect the ReRun button within 15 minutes
• Automatically exit after detected the Reconnect button
• Automatically re-active the Auto button if it been red for 60s
• 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

Wiki

To use this function, you the to be ready on fishing state, and the Start button is visible clearly on the screen

• Mini-client or Web:
  • Windows:
    • click and run fishing.bat
    • or run from command line: java -jar BitHeroes.jar fishing <hook_count>
  • Linux/Mac:
    • run ./fishing.sh from terminal
    • or command java -jar BitHeroes.jar fishing <hook_count>
• Steam:
  • Click and run: steam.fishing.bat
  • Run from commandline: java -jar BitHeroes.jar fishing <hook_count> --steam

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
• Global flags

Mini client using Google Chrome

Wiki

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 from terminal

Enjoy it

• Windows: click and run file mini-game-on-chrome*.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome*.sh from terminal

AFK

Wiki

This function does not support select level/mode, how many badge/ticket/... to consumes and can only everything by default so please chose everything first manually then use this

• Mini-client or Web:
  • Windows:
    • click and run afk.bat
    • or run from command line: java -jar BitHeroes.jar afk
  • Linux/Mac:
    • run ./afk.sh from terminal
    • or command java -jar BitHeroes.jar afk
• Not support Steam

Supported flags:

• --pvp do PVP
• --boss do world boss
• --gvg do GVG
• --invasion do Invasion
• --trials do Trials
• --gauntlet do Gauntlet
• --all do everything above
• --exit=X means will exit after X secs if not completed, no matter how many loop remaining. Usage: ./afk.sh --exit=1800 means will stop after 1800 seconds (30m)
• Global flags

Other features

find out at our Wiki

Global flags

• --help show help for specific application, for example: ./rerun.sh --help
• --steam (Windows only) for Bit Heroes on Steam with resolution 800x480
• --web (default, optional) for Bit Heroes on Web or Mini-client with resolution 800x520
• --mute do not push notification to Telegram

Tested environments:

Please find out on each function on wiki

Windows users

If you want to pass parameters/flags to program, you have to edit the *.bat files manually

For example if you want to use the feature --exit=X on the ReRun function, you have to edit the rerun.bat file, modify content

• from java -jar BitHeroes rerun
• to java -jar BitHeroes rerun --exit=1800 if you want to stop after 1800 seconds
• or to java -jar BitHeroes rerun 30 --exit=1800 if you want to stop after 30 times ReRun or 1800 seconds, depends on what condition completed first

and then save the file

Otherwise you can run app directly from ...

Bit Heroes bot v1.2.3

Changelog 1.2.3:

• Auto reactive the Auto button after 60s (during ReRun and auto farm things)
• Able to generate mini-clients for multiple accounts

Changelog 1.2.2:

• Add new functions to farm GVG and Gauntlet beside World Boss/PVP/Invasion/Trials
  • Scripts name: world-boss, pvp, invasion, gvg, trials, gauntlet
  • Not yet supported screen resolution 800x480 (Steam)
  • Note for each function:
    • World Boss: This function is solo only and does not support select level or type of World Boss, only select by default So which boss do you want to hit? Choose it before turn this on
    • PVP: This function only hit first opponent and does not support select PVP ticket cost, so choose it before turn this on
    • Invasion / GVG: These functions does not support select badge cost, so choose it before turn this on
    • Trials: These functions does not support select difficulty and token cost, so choose it before turn this on

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 notes for MacOS users, please read here

---

Officially support game resolution 800x520 (web + mini-client)

Also partially support Steam version with resolution 800x480

Only support English user interface

*It is recommended to play game using mini client

Contains the following functions:

1. ReRun Dungeons and Raid
2. Auto fishing
3. Farm World Boss / PVP / Invasion / GVG / Trials / Gauntlet
4. 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

Wiki

This function only supports clicking the ReRun button, that means you have to enter Dungeon/Raid manually, turn on the Auto and when the ReRun button appears, it will be automatically clicked

• Mini-client or Web:
  • Windows: click and run rerun.bat
  • Linux/Mac: run ./rerun.sh from terminal
• Steam:
  • Click and run: steam.rerun.bat
  • Run from commandline: java -jar BitHeroes.jar rerun <loop_count> --steam

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
• Global flags

Notes:

• Automatically exit if can not detect the ReRun button within 15 minutes
• Automatically exit after detected the Reconnect button
• Automatically re-active the Auto button if it been red for 60s
• 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

Wiki

To use this function, you the to be ready on fishing state, and the Start button is visible clearly on the screen

• Mini-client or Web:
  • Windows: click and run fishing.bat
  • Linux/Mac: run ./fishing.sh from terminal
• Steam:
  • Click and run: steam.fishing.bat
  • Run from commandline: java -jar BitHeroes.jar fishing <hook_count> --steam

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
• Global flags

Mini client using Google Chrome

Wiki

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 from terminal

Enjoy it

• Windows: click and run file mini-game-on-chrome*.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome*.sh from terminal

Other features

find out at our Wiki

Global flags

• --help show help for specific application, for example: ./rerun.sh --help
• --steam (Windows only) for Bit Heroes on Steam with resolution 800x480
• --web (default, optional) for Bit Heroes on Web or Mini-client with resolution 800x520
• --mute do not push notification to Telegram

Tested environments:

Please find out on each function on wiki

Windows users

If you want to pass parameters/flags to program, you have to edit the *.bat files manually

For example if you want to use the feature --exit=X on the ReRun function, you have to edit the rerun.bat file, modify content

• from java -jar BitHeroes rerun
• to java -jar BitHeroes rerun --exit=1800 if you want to stop after 1800 seconds
• or to java -jar BitHeroes rerun 30 --exit=1800 if you want to stop after 30 times ReRun or 1800 seconds, depends on what condition completed first

and then save the file

Otherwise you can run app directly from commandline

java -jar BitHeroes.jar "function_name" "param1" ["param2"] [--flags]

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.2.0

Changelog:

• Add new functions to farm World Boss/PVP/Invasion/Trials
  • Scripts name: world-boss, pvp, invasion, trials
  • Not yet supported screen resolution 800x480 (Steam)
  • Note for each function:
    • World Boss: This function is solo only and does not support select level or type of World Boss, only select by default So which boss do you want to hit? Choose it before turn this on
    • PVP: This function only hit first opponent and does not support select PVP ticket cost, so choose it before turn this on
    • Invasion: This function does not support select badge cost, so choose it before turn this on
    • Trials: This function does not support select difficulty and token cost, so choose it before turn this on

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 notes for MacOS users, please read here

---

Officially support game resolution 800x520 (web + mini-client)

Also partially support Steam version with resolution 800x480

Only support English user interface

*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. Farm World Boss >> NEW!
4. Farm PVP >> NEW!
5. Farm Invasion >> NEW!
6. Farm Trials >> NEW!
7. 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

Wiki

This function only supports clicking the ReRun button, that means you have to enter Dungeon/Raid manually, turn on the Auto and when the ReRun button appears, it will be automatically clicked

• Mini-client or Web:
  • Windows: click and run rerun.bat
  • Linux/Mac: run ./rerun.sh from terminal
• Steam:
  • Click and run: steam.rerun.bat
  • Run from commandline: java -jar BitHeroes.jar rerun <loop_count> --steam

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
• Global flags

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

Wiki

To use this function, you the to be ready on fishing state, and the Start button is visible clearly on the screen

• Mini-client or Web:
  • Windows: click and run fishing.bat
  • Linux/Mac: run ./fishing.sh from terminal
• Steam:
  • Click and run: steam.fishing.bat
  • Run from commandline: java -jar BitHeroes.jar fishing <hook_count> --steam

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
• Global flags

Farm World Boss / PVP / Invasion / Trials

World Boss Wiki
PVP Wiki
Invasion Wiki
Trials Wiki

Mini client using Google Chrome

Wiki

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 from terminal

Enjoy it

• Windows: click and run file mini-game-on-chrome.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome.sh from terminal

Global flags

• --help show help for specific application, for example: ./rerun.sh --help
• --steam (Windows only) for Bit Heroes on Steam with resolution 800x480
• --web (default, optional) for Bit Heroes on Web or Mini-client with resolution 800x520
• --mute do not push notification to Telegram

Tested environments:

Please find out on each function on wiki

Windows users

If you want to pass parameters/flags to program, you have to edit the *.bat files manually

For example if you want to use the feature --exit=X on the ReRun function, you have to edit the rerun.bat file, modify content

• from java -jar BitHeroes rerun
• to java -jar BitHeroes rerun --exit=1800 if you want to stop after 1800 seconds
• or to java -jar BitHeroes rerun 30 --exit=1800 if you want to stop after 30 times ReRun or 1800 seconds, depends on what condition completed first

and then save the file

Otherwise you can run app directly from commandline

java -jar BitHeroes.jar "function_name" "param1" ["param2"] [--flags]

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.1.0

Changelog:

• Support Bit Heroes on Steam with flag --steam
  • Only support game resolution 800x480
  • Other resolution options of Steam are not supported

So from now on, can use this both for both web (800x520) and steam (800x480) version

---

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

---

Officially support game resolution 800x520 (web + mini-client)

Also partially support Steam version with resolution 800x480

*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

This function only supports clicking the ReRun button, that means you have to enter Dungeon/Raid manually, turn on the Auto and when the ReRun button appears, it will be automatically clicked

• Mini-client:
  • Windows: click and run rerun.bat
  • Linux/Mac: run ./rerun.sh from terminal
• Steam:
  • Click and run: steam.rerun.bat
  • Run from commandline: java -jar BitHeroes.jar rerun <loop_count> --steam

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

To use this function, you the to be ready on fishing state, and the Start button is visible clearly on the screen

• Mini-client:
  • Windows: click and run fishing.bat
  • Linux/Mac: run ./fishing.sh from terminal
• Steam:
  • Click and run: steam.fishing.bat
  • Run from commandline: java -jar BitHeroes.jar fishing <hook_count> --steam

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 from terminal

Enjoy it

• Windows: click and run file mini-game-on-chrome.bat
• Linux/Mac: run file ./mini or ./mini-game-on-chrome.sh from terminal

Project-wide flags

• --help show help for specific application, for example: ./rerun.sh --help
• --steam (Windows only) for Bit Heroes on Steam with resolution 800x480
• --web (default) for Bit Heroes on Web or Mini-client with resolution 800x520
• --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
Steam on Windows 7 x64 (Virtual Box)	Work good (basically, not stable)
MacOS 10.14 High Sierra	Bot functions not work, only mini-client works

Windows users

If you want to pass parameters/flags to program, you have to edit the *.bat files manually

For example if you want to use the feature --exit=X on the ReRun function, you have to edit the rerun.bat file, modify content

• from java -jar BitHeroes rerun
• to java -jar BitHeroes rerun --exit=1800 if you want to stop after 1800 seconds
• or to java -jar BitHeroes rerun 30 --exit=1800 if you want to stop after 30 times ReRun or 1800 seconds, depends on what condition completed first

and then save the file

Otherwise you can run app directly from commandline

java -jar BitHeroes.jar "function_name" "param1" ["param2"] [--flags]

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