_YnthA
Platinian
Idle Heroes Client
A Python client for interacting with the official Idle Heroes game using an account of your choice.
Usage
This client is designed to be used as a library in your own Python scripts, but it also provides a command-line interface (CLI) for basic operations:
Bash:
# installation
$ git clone https://github.com/yntha/idleheroes.git
$ cd idleheroes
$ python -m pip install --user -e .
# run
$ ih-client
[IHNetClient] Logging in...
[IHNetClient] Logged in.
[IHNetClient] Checking for updates...
[IHNetClient] Client is up-to-date (version: 1.34.119)
[IHNetClient] Syncing game state...
[IHNetClient] Game state synced.
[IHNetClient] Checking mail...
[IHNetClient] Claimed 1 mails:
[IHNetClient] Mail(ID: 357, Name: Pioneer Points Reward Email, From: System Email, Affix: [Treasure Coupon x3, Magic Dust x3000, Gem x1500, Gold x3000000])
[App] Logged in as: ----- (UID: -----------)
[App] Gold: 708273426 | Gems: 18158 | XP: 71983507
[IHNetClient] Starting farming loop...
[IHNetClient] Autobattle interval: 5.00 minutes
[IHNetClient] Claiming autobattle rewards...
[IHNetClient] Claimed autobattle rewards: Bag(Items: [Spirit x5216, Exp x2816, Gold x2912])
[IHNetClient] Claimed autobattle rewards: Bag(Items: [Spirit x15908, Exp x8588, Gold x8881])
On first launch, the client will ask you for your credentials (email and password) to log in. It will then save your credentials to config/account.json for future use.
Features
- Email & password login
- Server pinging (echo)
- Guest account registration
- Account authentication
- Version update checking
- Game state synchronization
- Player bag information retrieval
- Mail operations (read, claim, delete, block)
- Autobattle reward claiming (configurable interval)