pyminion 0.1.0

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 core 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

Installation

pip install pyminion

Usage

To play a game against a bot:

from pyminion.expansions.base import start_deck, core_supply, kingdom_cards
from pyminion.players import BigMoney, Human
from pyminion.models.core import Game, Supply

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

# Setup the game
supply = Supply(piles=core_supply + kingdom_cards)
game = Game(players=[bot, human], supply=supply)

# Play game
game.start()
while not game.is_over():
    bot.take_turn(game)
    human.take_turn(game)
print("Winner: ", game.get_winner()

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 what needs to be done.

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