pyminion 0.1.5

Dominion but make it python

Pyminion

Pyminion is a library for executing and analyzing games of Dominion. At its core, pyminion implements the rules and logic of Dominion and provides an API to interact with the game engine. In addition, it enables interactive games through the command line and simulation of games between bots.

Table of Contents

• Installation
• Usage
• Support
• Contributing

Getting Started

Pyminion requires Python 3.8 and can easily be installed through pypi

python3 -m pip install pyminion

Usage

To play a game against a bot through the command line:

from pyminion.expansions.base import base_cards, basic_cards, start_cards
from pyminion.game import Game
from pyminion.bots.big_money import BigMoney
from pyminion.players import Human

# Initialize player and bot
human = Human()
bot = BigMoney()

# Setup the game
game = Game(
    players=[human, bot],
    expansions=[base_cards],
    basic_cards=basic_cards,
    start_cards=start_cards,
)

# Play game
game.play()
game.get_stats()

Support

Please open an issue for support.

Contributing

The most welcome contributions would be to add more cards from the base set of Dominion or to create new bots that perform better than basic big money strategy. Check the open issues to get a sense of what of is currently being worked on.

If you would like to contribute, please create a branch, add commits, and open a pull request.