https://github.com/pungrumpy/ai-chinese-checker
🤖 A Chinese Checkers (Sternhalma) game using mostly pygame-ce.
https://github.com/pungrumpy/ai-chinese-checker
Last synced: 8 months ago
JSON representation
🤖 A Chinese Checkers (Sternhalma) game using mostly pygame-ce.
- Host: GitHub
- URL: https://github.com/pungrumpy/ai-chinese-checker
- Owner: PunGrumpy
- License: gpl-3.0
- Created: 2024-10-07T05:57:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-15T12:33:09.000Z (over 1 year ago)
- Last Synced: 2025-10-01T13:39:29.785Z (8 months ago)
- Language: Python
- Homepage:
- Size: 4.82 MB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐉 Chinese Checkers Game
## 🏓 Table of Contents
- [🔗 Presentation](#-presentation)
- [🤔 What is Chinese Checkers?](#-what-is-chinese-checkers)
- [🎮 How to Play](#-how-to-play)
- [📚 Rules](#-rules)
- [🤖 AI Features](#-ai-features)
- [🚀 Technologies](#️-technologies)
- [🛠️ Setup and Installation](#️-setup-and-installation)
- [📩 How to Download Executable File](#-how-to-download-executable-file)
- [📝 License](#-license)
- [💖 Thanks for owner of this project](#-thanks-for-owner-of-this-project)
- [💕 Contributors](#-contributors)
## 🔗 Presentation
[Canva Presentation Click Here 👆](https://www.canva.com/design/DAGTKP0zSgY/pxgsmrTI43hyLHRegx7mhQ/edit?utm_content=DAGTKP0zSgY&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton)
## 🤔 What is Chinese Checkers?
**Chinese Checkers** is a strategy board game originating from Germany, known as "**Sternhalma**". It can be played by two, three, four, or six players, either individually or in teams. The game is a modern and simplified variation of the game **Halma**.
## 🎮 How to Play
The game is played on a star-shaped board with 121 spaces. Each player has 10 pieces of a unique color, which start at one of the six points of the star and aim to reach the opposite point.
The gameplay is turn-based, where a player can move one piece to an adjacent space or jump over other pieces. A player can jump over their own pieces or their opponents' pieces and can perform multiple jumps in a single turn.
The game ends when a player successfully moves all of their pieces to the opposite point. The first player to achieve this wins the game.
### 📚 Rules
- Players can move one piece to an adjacent space or jump over other pieces.
- Players can jump over their own or opponents' pieces.
- Multiple jumps are allowed in a single turn.
- The game ends when a player moves all their pieces to the opposite point.
- The player who moves all their pieces first wins.
## 🤖 AI Features
[Find our AI algorithms here](./bots)
| Name | Description | Emotion |
| --------------------- | ----------------------------------------------------- | ------- |
| **Greedy Easy Bot** | Moves a random piece to the best adjacent space. | 🎲🤑 |
| **Greedy Normal Bot** | Always moves the topmost piece to the best space. | 🤑 |
| **Greedy Hard Bot** | Always moves and jumps throught the maximum distance. | 🤑🤑 |
| **Minimax Bot** | Uses Minimax algorithm with Alpha-Beta Pruning. | 🧠 |
> [!WARNING]
> The **Minimax Bot** is not recommended for 3 or more players because it worst performance.
## 🚀 Technologies
- [🐍 Python](https://www.python.org/) - Programming language.
- [🎨 Pygame](https://pyga.me/) - Set of Python modules designed for writing video games.
- [📚 PySide6](https://doc.qt.io/qtforpython-6/) - Official Python bindings for the Qt framework.
## 🛠️ Setup and Installation
1. Clone the repository:
```bash
git clone https://github.com/PunGrumpy/ai-chinese-checkers.git
cd ai-chinese-checkers
```
2. Create and activate a virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. Install the required dependencies:
```bash
pip install -r requirements.txt
```
4. Run the game:
```bash
python main.py
```
## 📩 How to Download Executable File
1. Go to [Releases](https://github.com/PunGrumpy/ai-chinese-checker/releases) page
2. Download the Assets file
3. Select executable file (only for Windows OS)
[Click here to download the executable file](https://github.com/PunGrumpy/ai-chinese-checker/releases/download/v1.1.0/Chinese-Checkers-with-AI.exe)
## 📝 License
This project is licensed under the GNU General Public License v3.0. See the [LICENSE](LICENSE) file for details.
## 💖 Thanks for owner of this project
## 💕 Contributors
