janvdvegt / ghastcoiler

Hearthstone Battleground simulator in Python

Ghastcoiler

Ghastcoiler is a Hearthstone Battlegrounds simulator written in Python, and the only Python in the game. This README goes over the goals of the project and a list of TODOs. Like the rest of the repository, this is a work in progress.

Goals

The first goal is that writing a simulator for Hearthstone Battlegrounds is a challenge. Implementing the rules properly, in a maintainable structure while keeping the code at some form of efficiency is not easy.

When the core simulator is finished, this can be used for studying to get better at the game, for example about positioning. For another use, this can be a stepping stone towards a reinforcement learning environment or a model that can efficiently and accurately predict the outcome based on both boards.

Collaboration

We would love for others to help out with this project, while we are working out what the best process is you can already make pull requests. The initial focus is on finishing the simulator. We will update this section soon.

TODO

We are currently only at the beginning. There are a few initial focus points:

• Add docstrings and some comments
• Add ranks 2 to 6
• Increasing the amount of useful tests
• Figuring out some niche game mechanics
• Add heroes with in-battle effects
• Optimizing the speed

ghastcoiler's Issues

Add rank 6

Add rank 2

Add rank 4

Design way to visualize results of simulation

Could start with just a bar chart of the different outcomes but other statistics might be interesting as well

Redesign dynamic attack and defense bonus system

The current method is naive and expensive, my suggestion would be to keep the bonuses in the state of the minion, keep a flag to minions whether they grant bonuses and when a minion is added or removed that grants bonuses, do an update of the bonuses for all minions.

Collaboration suggestions

I have added some small things to other open source projects but I've never started one. Any good suggestions for making collaboration easy?

Add visual component to cProfile

Make it easy to run a simulation with specific boards

Maybe using some input file

Add rank 3

Fix attack cursor order

Currently determining the next minion to attack does not work well, this needs to be fixed including some tests. Tests should include:

• Minion that would attack next dies, cursor stays at same place
• Minion before next attacking minion dies, cursor should move with minion
• Minion before next attacking minon dies but spawns new minion(s), cursor should stay at current attacking minion

Add docstrings to all methods

Replace Dire Wolf Alpha with the new 3/1 Deathrattle Beast

Use Github Actions to automate testing merge requests

Add rank 5

Implement first tests