IDLE COMBOS

Companion App for Idle Champions, written in AHK.

v3.82 is the current supported Version. View changelog.

Important Notes

• Steam Launcher will not open Idle Champions if Steam is not open and logged in.
• Steam game detection only works if your Steam Library is in the default location.
• If you use a VPN you may have API communication issues. Please whitelist AHK/IdleCombos in your VPN.

Security Notice

• Your user_id and hash are stored locally in idlecombosettings.json.
• The hash is encrypted at rest using Windows DPAPI — only your Windows account can decrypt it.
• Do not share your hash with anyone — it grants full API access to your account.
• IdleCombos never sends your credentials anywhere except the official game API server.

Features

• Simple account statistics display
• Easy buying/opening many chests (Gold/Silver/Event)
• Easy apply bulk blacksmith contracts
• Enter multiple redeem codes at once
• Load active codes directly from the web
• Briv Stack Calculator integration
• Manual starting/stopping adventures (sometimes can fix stuck accounts)
• Can reload game client on crash (Steam only)

Requirements

• Steam install or
• Epic Games install or
• Standalone install or
• Able to enter your user_id & hash if on another platform.

Includes

• IdleCombos.ahk — Main application
• IdleCombosLib.ahk — Shared library functions
• idledict.json — Champion/chest/campaign ID definitions
• json.ahk — JSON parsing library
• Lib/ScrollBox.ahk — Scrollable text display helper
• README.md — This file

How To Run

• Install AutoHotKey v1.1
• Checkout this repo or download a release
• If you downloaded a release, unzip into a folder
• Right-click IdleCombos.ahk and open with AutoHotKey
• The application will ask you to detect your App ID from your currently installed Idle Champions install folder

Documentation

• User Manual — full feature guide, settings reference, and troubleshooting
• Changelog — version history
• Contributing — developer setup and guidelines
• Security — threat model and credential handling
• Deploy Process — release pipeline and packaging
• Code Flow — startup process diagram and timings
• Settings Schema — settings key history and migration
• Third Party — vendored asset inventory with SHA-256 hashes

Discord

• Discord Support Server

License

MIT