An open API service indexing awesome lists of open source software.

https://github.com/alextraveylan/pikomino

Simulate pikomino_game, and find the beter strategy
https://github.com/alextraveylan/pikomino

Last synced: 3 months ago
JSON representation

Simulate pikomino_game, and find the beter strategy

Awesome Lists containing this project

README

        

# Pikomino Simulation Game Model

Welcome to the Pikomino Simulation Game Model repository. This project is a digital simulation of the board game Pikomino (also known as "Heckmeck am Bratwurmeck" in German) created by Reiner Knizia.

## Table of Contents

- [Description](#description)
- [Installation](#installation)
- [Usage](#usage)
- [Contribute](#contribute)
- [License](#license)

## Description

This simulation allows players to play the game digitally and offers an AI opponent. The AI is designed with basic strategies to simulate a natural player's decision-making processes during gameplay.

**Game Overview**: Players aim to collect dominos by rolling dices. The player with the most worm symbols at the end of the game wins.

## Installation

1. Clone this repository:
```bash
git clone [email protected]:AlexTraveylan/Pikomino.git
```

2. Navigate to the project directory:
```bash
cd pikomino-simulation-game-model
```

3. Install the required dependencies:
```bash
pip install -r requirements.txt
```

## Usage
1. Run the main simulation file:
```bash
python main.py
```
2. Follow the on-screen prompts to play the game against the AI or simulate AI vs AI games.

## Contribute

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

1. Fork the project.
2. Create a new branch (`git checkout -b feature_branch`)
3. Commit your changes (`git commit -am 'Add some features'`)
4. Push to the branch (`git push origin feature_branch`)
5. Open a Pull Request.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.