Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jumpogpo/ai-chinese-checker

🤖 A Chinese Checkers Game
https://github.com/jumpogpo/ai-chinese-checker

Last synced: about 14 hours ago
JSON representation

🤖 A Chinese Checkers Game

Host: GitHub
URL: https://github.com/jumpogpo/ai-chinese-checker
Owner: jumpogpo
License: mit
Created: 2024-10-16T12:25:03.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2024-10-16T13:36:23.000Z (about 1 month ago)
Last Synced: 2024-10-18T12:49:42.823Z (about 1 month ago)
Language: TypeScript
Size: 1.21 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# 🐉 Chinese Checkers Game

![Preview](./images/preview.png)

## 🤔 What is Chinese Checkers?

**Chinese Checkers** originated in the United States in the 1920s under the name "Hop Ching." The game was inspired by the German game "Stern-Halma," which itself was a variant of the older game **"Halma,"** created in the late 19th century. Although it was marketed as "Chinese Checkers" to attract interest in the U.S., the game has no direct connection to China. The term "Chinese" refers to the use of a star-shaped board, which is visually associated with Eastern design. Over time, the game gained popularity worldwide, becoming a family favorite due to its strategic gameplay and accessibility.

## 🎮 How to Play

In Chinese Checkers, the objective is to move all your pieces from your starting corner to the opposite corner of the star-shaped board. Each player begins with 10 pieces of the same color, placed in one of the six corners. The game accommodates 2 to 6 players, and turns are taken sequentially. On a player's turn, they can either move one piece to an adjacent empty space or jump over a neighboring piece (whether their own or an opponent's) into an empty space directly on the other side. If more jumps are available, the player can continue making consecutive jumps in a single turn, though chain jumps are not mandatory.

The goal is to transport all of your pieces into the triangle opposite your starting corner. The game ends when a player successfully moves all their pieces into the target area. Only one piece can be moved per turn, and while chain jumps are allowed, backward movement into your original corner is not. The game is a blend of strategy and careful planning, requiring players to make the most efficient moves to reach their destination.

### 📚 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](./src/lib/utils/ai.ts)

| Name | Description |
| ---------- | ----------------------------------------------- |
| **Easy** | Uses Minimax with Alpha-Beta Pruning (Depth 2). |
| **Medium** | Uses Minimax with Alpha-Beta Pruning (Depth 4). |
| **Hard** | Uses Minimax with Alpha-Beta Pruning (Depth 6). |
| **Hint** | Uses Minimax with Alpha-Beta Pruning (Depth 6). |

## 🚀 Technologies

- [💻 **TypeScript**](https://www.typescriptlang.org/) - Programming language.
- [🛠️ **Svelte**](https://svelte.dev/) - A framework for building web pages.
- [🎨 **Tailwind CSS**](https://tailwindcss.com/) - A framework for styling web pages.
- [🔧 **Node.js**](https://nodejs.org/) - JavaScript runtime for running backend code.
- [⚡ **Bun**](https://bun.sh/) - A fast all-in-one JavaScript runtime for running, bundling, and testing.

## 🛠️ Setup and Installation

1. Clone the repository:
```bash
git clone https://github.com/jumpogpo/ai-chinese-checker.git
cd ai-chinese-checker
```
2. Install the required dependencies:

```bash
npm install
```

3. Run the website:
```bash
npm run dev
```
4. Open the website:
- Open your browser and go to [http://localhost:5173/](http://localhost:5173/)

## 📝 License

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

## 💖 Thanks for owner of this project

_arthur-x

👑