Skip to content
Sébastien Tromp edited this page Mar 24, 2023 · 15 revisions

WARNING: modding Hearthstone is against the game's Terms of Services and could get you banned. So use these at your own risk.
WARNING: Firestone Mod Manager is for now only available on the beta version of the app. See https://github.com/Zero-to-Heroes/firestone/blob/master/beta-test.md

Important

You will need to use tehe "Refresh Engine" button every time a new Hearthstone client patch is downloaded. The client uses a special version of the libraries that prevents the mods engine from working, and that button replaces them with their standard version.

Installing mods

First, you will need to enable mods support inside Firestone from the Settings > General > Mods section (the game needs to be closed for this).

You should follow each mod's specific instructions, but the gist is:

  • Copy the mod main file to the Hearthstone/Mods folder
  • Copy the mod dependencies to the Hearthstone/UserLibs folder

Then restart the game.

NOTE: once mods are activated, you will see a console starting up at the same time at the game. This simply contains some logs for mods, and will be removed in future iterations.

Known mods

WARNING: these mods are created and maintained by the community, so I can't offer any support. Please open Github issues on the mods' respective repositories instead.
And as mentioned above, modding HS is against the game's ToS, so I am not endorsing any of them. However, I have personally reviewed them, and think that what they do is "safe" and shouldn't risk you a ban (but, see the warning at the top of the page).

Developing mods

Firestone ships with an integrated version of MelonLoader (on the beta build only). It is a pretty easy way to install Mods to add features to the game.
You can also install MelonLoader yourself.

See the MelonLoader documentation for developing Melon Mods, or look at existing mods. Or ping me on Discord

Hearthstone- and Firestone-specific capabilities (like knowing the deck state of both players) will be available later on for you to use in your mods. So you could in theory build a fully integrated tracker :)

Mods that are definitely not OK

  • Mods that give you an unfair advantage / cheating
  • Mods that give you access to cosmetics that you haven't unlocked
  • More generally, any mod that gives you access to some things which you should otherwise buy with in-game resources or real currency