Mods - Zero-to-Heroes/firestone GitHub Wiki

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

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/BepInEx/plugins folder
  • Copy the mod dependencies to the Hearthstone/BepInEx/plugins folder (same folder)

Then restart the game. The mod will be detected in Firestone once you have started the game with the new mod once.

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).

Old Mods

These are unmaintained mods that don't work anymore. If any of them is of interest to you, please post an issue on the mod's repository to ask the maintainer to update it for the new mod manager in Firestone.

Developing mods

Firestone ships with an integrated version of BepInEx. It is a pretty easy way to install Mods to add features to the game.
You can also install BepInEx yourself.

See the BepInEx documentation for developing BepInEx plugins, 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 :)

Requirements

In order to be recognized by Firestone's Mod Manager, your mod should expose a Config with a Name, Version, Guid and DownloadLink

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, or that go against the dev intents