https://github.com/boompig/dominion
A bare-bones simulator and visualizer for the card game 'Dominion'
https://github.com/boompig/dominion
board-game game-ai nodejs vuejs2
Last synced: 2 months ago
JSON representation
A bare-bones simulator and visualizer for the card game 'Dominion'
- Host: GitHub
- URL: https://github.com/boompig/dominion
- Owner: boompig
- Created: 2013-07-21T15:51:41.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2023-10-27T03:19:04.000Z (over 1 year ago)
- Last Synced: 2024-04-09T22:00:51.832Z (about 1 year ago)
- Topics: board-game, game-ai, nodejs, vuejs2
- Language: TypeScript
- Homepage: https://boompig.github.io/dominion
- Size: 4.55 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dominion
A bare-bones simulator and visualizer for the card game [Dominion](https://boardgamegeek.com/boardgame/36218/dominion) in JavaScript. Simulator can be run headless from command-line with node.js or in the browser. Visualization powered by React.
Currently only supports standard cards. Card descriptions can be found [here](https://www.ultraboardgames.com/dominion/cards.php).
## Run
### Browser
`http-server` from root directory. That's it.
### Command Line
The simulation can be run headless from the command line. Run
```
ts-node cli.js
```
The `--help` flag will give you available options.
To run the visualization, start up a web server from this directory, for example run `http-server`.
See building instructions on building the bundle first.
## Building
Shared files (between browser and Node) can be found in the `/src` directory. Build the bundle for browser with browserify.
```
yarn build
```
## Supported Cards
- Adventurer
- Bureaucrat
- Cellar
- Chancellor
- Chapel
- Council Room
- Feast
- Festival
- Gardens
- Laboratory
- Library
- Market
- Mine
- Moneylender
- Remodel
- Smithy
- Spy
- Thief
- Village
- Witch
- Woodcutter
- Workshop
## Unsupported Cards
- Moat
- Militia
- Throne Room
### Adding New Cards
See `initCards` function in `src/game.js`.
## Strategies
I hand-coded a few AI strategies to test against the human opponent. Descriptions below. You can find the code in `player-strategies.js`.
### Big Money
Each turn, buy a province if you can afford it. Otherwise, buy gold or silver. If cannot afford either of those, buy nothing.
### Smart Big Money
Same as "Big Money", but buy Duchies near the end.
### Smart Duchy
- always go for province when you have 8
- always go for duchy when you have 5
- always go for smithy when you have 4
- always go for silver when you have 3
- go for gold when you have 6, if there are 4 or more provinces
### Smart Smithy
???
### Big Money Smithy
???
## Lint & Test
```
yarn install
yarn lint
yarn test
```
## Uses
* play dominion against computer opponent(s)
* simulate strategies over large number of iterations to see their effectiveness
## Implementation Details
* written in JavaScript, with Angular framework and Bootstrap for prettiness
* uses Underscore library for shuffling cards (Fisher-Yates shuffle)