All Projects → swiftb → clicker-heroes-sw1ft-bot

swiftb / clicker-heroes-sw1ft-bot

Licence: MIT license
A game bot for Clicker Heroes

Programming Languages

autohotkey
350 projects
HTML
75241 projects

Clicker Heroes Sw1ft Bot

A game bot for Clicker Heroes.

Overview

General Features

  • Automated Hero Souls farming
  • Vision Run loop (Ctrl+F1)
    • Supports idle, hybrid and active play
    • Finds gilded heroes/rangers automatically
    • Picks up clickables without breaking idle
    • Automatic switches from idle to active in hybrid mode
    • Automatic ascensions
    • Automatic reload/restart/resume
    • Option to auto-save before ascending
    • Option to auto-level Solomon after ascending
    • Limitations: Only supported in the CH browser client (in low quality). The window must also be visible in the foreground
  • Hotkeys for raiding
  • Separate active monster clicker script
    • Built in click speed throttle (when mouse enters window)
    • Remotely operated by the main bot script
  • Supports user defined skill combos (see tools/combo_tester.ahk)
  • Monitored click safety zones preventing bot misclicks
  • Logging to file

Minimum recommended game state

  • Two world ascensions to get the Buy Available Upgrades button
    • Recommendation: Save 100 rubies and buy two Quick Ascension's @ Lvl 10 after every Transcension.

Step-by-step Guide

1. Start Clicker Heroes in your browser and set the graphics quality to low. Click the wrench and make sure these three options are unchecked:

2. Download and install the latest version of AutoHotkey

3. Download the latest bot release from GitHub:

4. Extract the bot zip file:

5. Double-click the ch_sw1ft_bot.ahk file to start the bot:

Unless you run Clicker Heroes in the Opera browser, you will get the following error message:

This is expected.

In your taskbar you should see two green H icons. One for the bot, one for separate monster clicker:

Unless they already exist, three user settings files will be created:

6. Open the ch_bot_lib_settings.ahk file:

Important! Use a decent text editor, like Sublime Text or Notepad++ when you configure this bot.

  • If needed, change the browser name.
  • Make sure the Clicker Heroes window have focus, then click Ctrl+Middle Mouse Button dead center in the ancient tab eye like this:
  • Update the browserTopMargin according to the pop-up window:
  • Save and reload the script with Alt+F5.

Test hotkeys:

  • Ctrl+Alt+F1 should scroll down to the bottom, then back up
  • Ctrl+Alt+F2 should switch between all used tabs

If any of these two fail, check the Troubleshooting section and the FAQ for possible solutions.

7. Open the ch_bot_settings.ahk file:

  • With e.g. a lvl 90,000 Siyalatas:

    Following the regilding chart, you should be gilded on Moloch:

    Then you would set gildedRanger to 11.

  • Depending on your playstyle, you set endLvlIdle and endLvlActive differently:

  • The settings for chronos, kumawakamaru and vaagur:
    Should match your in-game values:

Recommended optional settings:

  • Set autoAscend to "true"
  • Set saveBeforeAscending to "true"
  • Set noSleep to "true"

8. Save and reload with Alt+F5, then start the Vision Run with Ctrl+F1.

In the logs folder:

Open today's log file. The most important bits here are:

DEBUG   browser = Opera
DEBUG   browserTopMargin = 216
DEBUG   gildedRanger = Moloch
DEBUG   endLvlIdle = 99999
DEBUG   endLvlActive = 100000
DEBUG   chronos = 11.36
DEBUG   kumawakamaru = -2.59
DEBUG   vaagur = -39.71
INFO    Recommended transitional hero(es): Banana > Alabaster

Make sure these match with your settings. Also put 1 gild on the recommended transitional hero(es).

Troubleshooting

  • Keep your mouse pointer outside the Clicker Heroes window to avoid click speed throttling.
  • Use a separate web browser for web surfing while running the script.
  • Make sure your browser window is not zoomed in or out, and is at 100% viewing size.
  • In Windows:
    • Set display scaling to 100% (96 DPI)
    • Use True Color (32 bit)
    • If your account don't have administrator rights, you might have to start the script by right-clicking it and select Run as Administrator.

Known issues

  • Active power savings settings turning off your monitor(s), can cause issues with AHK's image recognition. To combat this, you can enable the noSleep bot setting.
  • The script can't handle any extra stuff on the left side, e.g. a bookmark list.

Vision Run Error States

State Error Solution
-2 No Clicker Heroes window found Open the client
-1 Vision, but not in browser Use the browser client
0 Vision, but not finding anything In Windows, use standard 100% (96 DPI) display scaling in (32 bit) True Color

Main Hotkeys

Hotkey Function
Ctrl+F1 Start the Vision Run loop
Ctrl+F3 Reload and restart Vision Run loop
Pause Pause/unpause the script
Alt+Pause Abort any active run or initiated ascension
Shift+Pause Schedule a stop after finishing the current run
Alt+F5 Reload the script (needed after configuration changes)
Shift+Ctrl+F5 Schedule a script reload after finishing the current run, then restart it
Alt+F6 Re-initialize coordinates (needed after moving or re-sizing the client window)

Supplementary Hotkeys

These hotkeys can be executed while a Vision run is active.

Hotkey Function
Ctrl+Esc Suspend/Unsuspend all other Hotkeys
Ctrl+F11 Autosave the game
Win+F6 Raid once for free
Win+F7 One paid raid
Win+F8 raidAttempts paid raids
Shift+Ctrl+F1 Toggle the autoAscend flag
Shift+Ctrl+F6 Toggle the playNotificationSounds flag
Shift+Ctrl+F7 Toggle the playWarningSounds flag
Shift+Ctrl+F11 Toggle the saveBeforeAscending flag

Questions or comments?

Check the FAQ or visit the original script home on Reddit.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].