Skip to content

Bit Heroes bot v1.2.5
Compare
Choose a tag to compare
@9-9-9-9 9-9-9-9 released this 29 Aug 14:25
· 257 commits to master since this release
release-1.2.5
eb1cb4d

Github Release

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:

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:

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

Assets 3
Loading