The collectible online card game Hearthstone features a rich testbed and poses unique demands for generating artificial intelligence agents. The game is a turn-based card game between two opponents, using constructed decks of thirty cards along with a selected hero with a unique power. Players use their limited mana crystals to cast spells or summon minions to attack their opponent, with the goal to reduce the opponent’s health to zero. The competition aims to promote the stepwise development of fully autonomous AI agents in the context of Hearthstone.

Entrants will submit agents to participate in one of the two tracks:

  • Premade Deck Playing”-track: participants will receive a list of three known decks and three decks unknown prior submission. During evaluation we will simulate all possible matchups for at least 100 games to determine the average win-rate for each agent. Determining and using the characteristics of the player’s and the opponent’s deck to the player’s advantage will help in winning the game. The decks for the premade deck playing track can be found under:
    • Decks.AggroPirateWarrior,
    • Decks.RenoKazakusMage,
    • Decks.MidrangeJadeShaman
    • Three more meta-decks will be used, but will remain unknown to the participants till the final submission deadline.
  • “User Created Deck Playing”-track: the competition framework allows agents to define their own deck. Finding a deck that can consistently beat a vast amount of other decks will play a key role in this competition track. Additionally, it gives the participants the chance in optimizing the agents’ strategy to the characteristics of their chosen deck.
As long as the number of submissions remains below 32, we will use a round robin tournament to determine the best submissions based on their average win-rate. In case more agents are submitted we will use multiple smaller round-robin tournaments to determine likely candidates and use a final round robin tournament for determining the best three submissions.

Submission Instructions

To take part in the competition you can send us your agent as .cs file or, in case multiple files are required, a zip archive or a download link via e-mail. The total file size should not be larger than 1 GB and all bots need to satisfy all requirements stated on the rules subpage.
Multiple bots can be submitted, but please indicate if a submission should replace an old submission or be counted as a new submission. Each participant can have up to 2 final submissions per track.
Please be aware that submitted agents are going to be published on this website after the competition finished. With the submission to this competition you agree with this procedure.

Competition Entry Deadline: July15th 2019 23:59 UTC-12



In case you submit a paper based on this framework we would be happy if you could include the following citation:

Dockhorn, A., & Mostaghim, S. (2019). Introducing the Hearthstone-AI Competition, (Section IV), 1–4. Retrieved from

archivePrefix = {arXiv},
arxivId = {1906.04238},
author = {Dockhorn, Alexander and Mostaghim, Sanaz},
eprint = {1906.04238},
month = {may},
pages = {1--4},
title = {{Introducing the Hearthstone-AI Competition}},
url = {},
year = {2019}


The Hearthstone-AI Competition is being organised by:

Have questions or suggestions? Feel free to contact us via our Q&A Forum or directly sent a mail to the competition admin.


We would like to thank the developers of the Sabberstone Framework on which our competition is based on. Special thanks go out to darkfriend77 who is the current organizer of the Sabberstone github.