Clicker Heroes Sw1ft Bot

A game bot for Clicker Heroes.

Overview

• Features
• Minimum recommended game state
• Step-by-step Guide
• Troubleshooting
• Known issues
• Hotkeys
• Questions or comments?

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
  • Dynamic ascensions triggered by a tunable max monster kill time setting
  • Option to auto-save before ascending
  • Option to auto-level Solomon after ascending
  • Can automatically resume
  • 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"

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 = 1600
DEBUG   endLvlActive = 100000
DEBUG   chronos = 11.36
DEBUG   kumawakamaru = -2.59
DEBUG   vaagur = -39.71
INFO    Recommended transitional hero(es): Banana > Alabaster
DEBUG   Estimated ascension @ Lvl 3075 (idle), 3475 (active)

Make sure these match with your settings and that you follow 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

• If active, the power savings setting turning of your monitor(s) can cause issues with AHK's image recognition. When last tested, only Firefox continued to run without any issues.
• 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.