Mercenaries Farm Bot (for Hearthstone)

MFB official URL : https://github.com/Efemache/Mercenaries-Farm-bot/

Free & Tip: 2 ways starting 2022-11-07

Click here if you want some context about Free & Tip version

Context

I started to actively work on this bot (november 2021) because I thought doing it open source, some devs would come too to improve MFB so it would be a win/win
Too few devs came (big thanks to those who participated) and they, generally, added a feature or two or fixed a bug but none staied on a long term or to globally help
A lot of users asked for : features, doc update, videos, bugs fix (a lot of them didn't even impact me), help because they misconfigured MFB, help on their setup which wasn't even offically supported and I helped each time I could :
- Only 4 people made a donation
- A donation is like "Great job" or "Hey, you helped me, thanks, let me buy you a beer or a coffee" (especially when I spent 1 hour or more to help someone)
Finally, it was way too much work for me "alone" and a lose/win for me

In conclusion

To continue to work on and maintain the bot :

MFB remains free and open source but updates will be delivered 3-4 weeks later
For those who help (in coding) and those who give a tip (at least 10$), updates will be delivered 3-4 weeks before others

Warning:
Blizzard pushed the last major update for Mercenary mode (February 14, 2023).
I launched quite recently the supporter/community versions (11/2022) with only few temporary exclusives contents for supporters, and it's already the last update.
So, to be fair, I decided this last major MFB update will be exclusive to supporters until release of the next Heartstone expansion.

Purpose

The purpose of this bot is to automatically pass the bounty levels to level up your mercenaries, win somes coins and complete campfire tasks.

There is a main branch to use daily.
dev2 branch is used for Pull Request (PR) only.
Tags are not used anymore (last one is 0.8.3 and is deprecated); instead, download and use main branch.

Note:
Up to "March of the Lich King" expansion (and Mini-set "Returns to Naxxramas") release, MFB works to complete a lot of campfire tasks and somes bounties.

If you like the bot, think about giving a tip.

PvE preview (video)

If you want to support (or thank) us

Buy us a coffee, a beer or more 😄

Platform	Address
Ko-Fi	mercenariesfarm

Or send crypto

Platform	Address	QR Code
Bitcoin (BTC)	3L4MJh6JVrnHyDDrvrkZQNtUytYNjop18f
Ethereum (ETH) or Binance Smart Chain (BNB/BUSD) (*)	0x6Db162daDe8385608867A3B19CF1465e0ed7c0e2

(*) yes, BSC and ETH addresses are the same

(*) on Ethereum blockchain you can send any ERC-20 token (let us know if you send token other than ETH)

(*) on BSC blockchain you can send any BEP-20 token (let us know if you send another token than BNB or BUSD)

Just a "Thanks"

Platform	Address
"Thank you"

Installation

When the bot is running

don't move the Hearthstone window
don't put another window in front of Hearthstone
don't touch your mouse (except if you want to bypass the bot)
don't resize the Hearthstone window or change the resolution

Windows

Install Python 3.10 (⚠️ select the "Add Python 3.10 to PATH" during installation)
Download the project
Open conf/user/settings.ini and set your settings (⚠️ don't forget to set "GameDir" to your Hearthstone directory)
Edit your Hearthstone log.config file
Start Hearthstone (with same resolution as set in settings.ini)
Create a group of mercenaries named "Botwork" (and go back to main menu)
Run HSbotRunner.bat

Linux

Install gir1.2-wnck-3.0 (sudo apt install gir1.2-wnck-3.0)
Install - if needed - libharfbuzz-gobject0 (sudo apt install libharfbuzz-gobject0)
Download the project
Open conf/user/settings.ini and set your settings (⚠️ don't forget to set "GameDir" to your Hearthstone directory)
Edit your Hearthstone log.config file
Start Hearthstone (with same resolution as set in settings.ini)
Create a group of mercenaries named "Botwork" (and go back to main menu)
Run HSbotRunner.sh

Bot Installation/Configuration Video

News & contact

More informations in Wiki

For news, follow us on Twitter : @MercenariesFarm

For videos (news, settings, ...), subscribe on YouTube : MercenariesFarm Channel

If you have any issue with the bot, please, read first the FAQ (Frequently Asked Questions) before posting any question on discord or opening an issue on Github.

For bugs, open an issue

To discuss with the community, go to discord : Mercenaries Farm server (⚠️ don't ask in private message)

Dev progress

Language & resolution

⚠️ 1920x1080 is the only resolution "officially supported" (meaning, I can only test this resolution) but the other mentionned resolutions work too

⚠️ windowed : monitor needs to have a higher resolution than Hearthstone for both width AND height

Resolution	English
1920x1080 fullscreen ¹	✅
1920x1080 windowed	✅
16:9 fullscreen ¹ ²	✅
16:9 windowed ²	✅

(1)

for fullscreen mode, Hearthstone resolution and screen resolution need to be the same (example : 1920x1080 for both)

(2)

16:9 resolution should work if at least 960x540 (960x540, 1024x576, 1280x720, 1600x900, ...)
higher (than 1920x1080) 16:9 resolution has been tested with 2560x1440

Support


1. transition to Travel point selection	✓
* new travel point portal	✓
* Boss Rush support	x
2. transition to Level/Bounty selection	✓
3. transition between encounters
4. prioritize the spirit healer	✓
5. prioritize the mysterious node	✓
6. put mercs on board	✓
7. search for suitable opponents	✓
8. choose abilities :	✓
* for each mercenary (using combo.ini files)	✓
* or the first abilities by default (if no configuration exists)	✓
* ability targetting friendly minion selected by Type, Faction or by Name	✓
* taunt, stealth, divine shield, attack, health, ... detection	x
9. attack opponents (if ability requires it)	✓
10. choose a treasure after passing a level	✓
11. collect rewards for reaching the last level	✓
12. claim packs, coins and equipments from completed tasks	✓
13. repeat from 1 point	✓

AI

Battles

MFB uses a simple AI which can be described as :

Red (Protector) > Green (Fighter) > Blue (Caster) > Red (Protector)
It doesn't know about taunt, devine shield, stealth, attack, health, ...

Battle limitation (will change in future releases)

~~bot doesn't work with ability like "choose one" with 2 choices (ex: Malfurion, but works for Rexxar)~~ ✓ (ok since May 23, 2022)
~~bot doesn't work with ability which need to point to one of your mercenaries (ex: impossible to use healing with Xyrella)~~ ✓ (ok since May 23, 2022)
- ~~bot doesn't work with ability targeting a specific type of mercenary like Dragon, Beast, ...~~ ✓ (ok since Jul. 08, 2022)
~~bot doesn't use minions on board which are not a mercenary~~ ✓ (ok since 0.4.0 release) / Feb. 18, 2022
~~MFB can't target a specific Mercenary by name~~ ✓ (ok since Feb. 06, 2023)
MFB can't target a friendly minion/merc with an ability which, usually, point to an enemy

jonhermansen / Mercenaries-Farm-bot