Clicker Heroes Sw1ft Bot

A mid/late game bot for Clicker Heroes.

Overview

• Features
• Minimum recommended game state
• Setup
• Starting the bot
• Configuration
• Hotkeys

Features

• Fully automated (optimal zone) Hero Souls farming
• Can run in the background (behind windows, but not minimized)
• Supports both Steam and Web clients
  • (Steam) Supports window re-sizing (including Full Screen mode)
• Hybrid mode support (e.g. 27 minutes idle plus 6 minutes active)
• Separate active monster clicker script
  • Built in click speed throttle (when mouse enters window)
  • Remotely operated by the main bot script during hybrid/deep runs
• Supports user defined skill combos (see tools/combo_tester.ahk)
• Built in re-gilder between rangers
• Built in configuration assistant
• Option to auto-save before ascending
• Progress bar showing remaining time
• Mis-click prevention with a click safety zone around the in-game tabs (that triggers an automatic script pause when breached)

Minimum recommended game state

To operate as intended, the bot needs a certain minimum game state:

• Atlas or higher ranger gilded
• Optimal zone > 1000
• Iris > 145 (and within 1001 levels of the optimal zone)
• Siyalatas > 200
  • Argaiv, Libertas/Mammon/Mimzee, Morgulis and Solomon following the Rules of Thumb
• Maxed: Atman, Bubos, Dogcog, Dora, Fortuna, Khrysos and Kumawakamaru

These recommendations should give you enough gold after ascending with a clickable, to instantly unlock, level and buy all upgrades for every hero down to and including Frostleaf.

Setup

• Download and install the latest version of AutoHotkey
• Download and unpack the latest ZIP, or individually download all .ahk files to a new folder (where you also need the system folder with the default settings files).

Starting the bot

• Start Clicker Heroes
• Double-click the ch_sw1ft_bot.ahk file to start the bot. In your taskbar you should see a green H icon.

If you run the browser version, you will get a "Clicker Heroes started?" message on your initial start. This is expected until you have configured the Mandatory lib settings.

Unless they already exist, three user settings files will be created as copies of the default system settings. All configuration changes should be made in these files:

ch_bot_lib_settings.ahk, ch_bot_settings.ahk and monster_clicker_settings.ahk.

Note: If your Windows account don't have administrator rights, you might have to start the script by right-clicking it and select Run as Administrator.

Configuration

• In Clicker Heroes, turn off the Show relic found popups option and keep all heroes expanded.

Mandatory lib settings

These only need to be changed if you run the browser client.

Variable	Explanation
SetTitleMatchMode	3 for Steam or regex for browser version
browserTopMargin	Browser top margin (1)

(1) Start Windows Spy, then under Mouse Position, check the Relative y position of the top left corner of the CH area (below the logo). Update the top margin to this value if they differ and reload the script with Alt+F5. Still in the top left corner, click Alt+Middle Mouse Button. With a correctly set top margin, the shown cursor y position should be 30.

Mandatory bot settings

Variable	Explanation
irisLevel	Set to your Iris level in game
optimalLevel	Your optimal zone level (2)
speedRunTime	The duration of the speed run (2)
gildedRanger	The number of your gilded ranger (3)

(2) Set according to the Ancients Optimizer
(3) 1:Dread Knight, 2:Atlas, 3:Terra, 4:Phthalo, 5:Banana, 6:Lilin, 7:Cadmia, 8:Alabaster, 9:Astraea

Optional bot settings

Variable	Explanation
deepRunTime	The duration of the deep run
hybridMode	[true/false] Chain a deep run when the speed run finish
autoAscend	[true/false] Warning! Set to true will both salvage relics and ascend without any user intervention!
saveBeforeAscending	[true/false] Auto-save before ascending

Note: Not a complete list.

Function tests

1. Ctrl+Alt+F1 should scroll down to the bottom
2. Ctrl+Alt+F2 should switch to the relics tab and then back

If any of these fail, reload the script with Alt+F5 and try again.

Starting the main speed run loop

After a fresh ascend with an available clickable, start the speed run loop with Ctrl+F1.

Main Hotkeys

Hotkey	Function
Ctrl+F1	Loop speed runs
Ctrl+F2	Start a deep run
Pause	Pause/unpause the script
Alt+Pause	Abort active speed/deep runs and an initiated auto ascension
Shift+Pause	Do not start new speed/deep runs after finishing the current run and ascension
Alt+F5	Reload the script (needed after configuration changes or a client window resize)
Shift+Ctrl+F5	Reload the script after the current run and restart the speed run loop afterwards

Supplementary Hotkeys

These hotkeys can be executed while a speed or deep run is active.

Hotkey	Function
Ctrl+Esc	Suspend/Unsuspend all other Hotkeys
Ctrl+F6	Set previous ranger as re-gild target
Ctrl+F7	Set next ranger as re-gild target
Ctrl+F8	Move reGildCount gilds to the target ranger (will pause the monster clicker if running)
Ctrl+F11	Autosave the game
Shift+Ctrl+F1	Toggle the autoAscend flag
Shift+Ctrl+F2	Toggle the screenShotRelics flag
Shift+Ctrl+F6	Toggle the playNotificationSounds flag
Shift+Ctrl+F7	Toggle the playWarningSounds flag
Shift+Ctrl+F8	Toggle the showSplashTexts flag
Shift+Ctrl+F11	Toggle the saveBeforeAscending flag
Shift+Ctrl+F12	Toggle the debug flag

Test Hotkeys

Hotkey	Function
Ctrl+Alt+F1	Should scroll down to the bottom
Ctrl+Alt+F2	Should switch to the relics tab and then back
Alt+F1	Test the getClickable() function
Alt+F2	Test the initRun() function
Alt+F3	Test the speedRun() function
Alt+F4	Test the ascend() function

Questions or comments?

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