Frequently Asked Questions

What is this?

Fireplace is a Hearthstone simulator. It allows the creation of Hearthstone games and has an API for playing cards and "cheating" the board state and simulates the resulting board state.

Is it legal?

Yes. Fireplace is a project that was shared with Blizzard early on during its development.

Generally speaking, reimplementing Hearthstone is OK. What's not OK is using copyrighted art and assets. Fireplace contains no Blizzard assets and all code is original work.

Is there a UI?

There is no graphical UI. Fireplace was designed to be interacted with programmatically. This may mean creating your own tests, your own scenarios or even your own UI.

The full_game.py file is a good starting point for building your own UI/scenarios. It creates and plays one or more game until completion with a dumb AI.

Is there an AI?

Fireplace does not contain any smart AI. However, the HearthSim community supports AI work and several members use Fireplace as a backend to various types of Hearthstone AIs.

Can I play it with the Hearthstone client?

Fireplace cannot connect directly to the Hearthstone client. It can, however, communicate with any Kettle-compatible server, such as Stove, which may offer compatibility with the Hearthstone client. (Note that using the official Hearthstone client on servers not approved by Blizzard may break the Hearthstone terms of service.)