https://github.com/coolcat467/checkers
Graphical Checkers Game with AI support
https://github.com/coolcat467/checkers
ai ai-support checkers checkers-game coolcat467 networked-game python3 single-player two-player
Last synced: 16 days ago
JSON representation
Graphical Checkers Game with AI support
- Host: GitHub
- URL: https://github.com/coolcat467/checkers
- Owner: CoolCat467
- License: gpl-3.0
- Created: 2020-05-15T20:26:39.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T22:29:33.000Z (20 days ago)
- Last Synced: 2025-04-07T23:28:07.723Z (20 days ago)
- Topics: ai, ai-support, checkers, checkers-game, coolcat467, networked-game, python3, single-player, two-player
- Language: Python
- Homepage:
- Size: 2.41 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Checkers
Graphical Checkers Game with AI support
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/psf/black)
[](https://github.com/astral-sh/ruff)
## Installation
Ensure Python 3 is installed, and use pip to install this project.
```bash
pip install git+https://github.com/CoolCat467/Checkers.git
```
## Usage
After installing using the command above, running the following command
will start the game.
```bash
checkers_game
```
## Types of Play
On the title screen there are 3 play options:
1. Singleplayer
2. Host Networked Game
3. Join Networked Game
In a singleplayer game, the program hosts an internal server and the client can control both players.
In Host Networked Game, program hosts the server on the local network and posts advertisements every 2 seconds or so until two clients connect (includes hosting computer)
In Join Networked Game, program will listen for server advertisements on the local network and display said servers, and when you click on a discovered LAN server client will connect and game should begin.
Once game has begun, if server was hosted, LAN server advertisements stop and play begins
## How to Play
As per official American Checkers rules, Black plays first.
To perform a turn, click on the piece you would like to move with the mouse cursor.
Once this happens, all valid move destinations will be displayed via tiles with green outlines.
Following official American Checkers rules, note that if a capture (jumping over an opponent's piece, taking that piece out of play) is available, it must be taken and otherwise valid moves non-capture moves will not be available.
Once green outline tiles appear, you can either click one of the valid destination tiles to complete your turn or click a different piece to select that piece instead.
Once you click a valid destination, that move is performed, a movement animation will be shown, and it is now the other player's turn.
Play continues indefinitely until either a player no longer has pieces they are able to move or there is no valid move they are able to complete. In these events, said player's opponent wins.
Initially, all player have pawns, which are only able to move forward towards the player's opponent's side of the board.
In the event a pawn reaches the opposite side of the board, it is "kinged" and is now able to move in all directions.
In American Checkers, pawns can only capture in the forward direction, just like their movement. Kings do not have this limitation, likewise like their movement.
## Playing Against A Computer Player (AI)
There are two computer players I have made for this game. Both connect to all discovered LAN servers and play until the game is over.
To start playing against Minimax AI:
```bash
python computer_players/MiniMax_AI.py
```
To start playing against Max Y Position Jumping AI (very dumb):
```bash
python computer_players/Y_Max_Jumper_AI.py
```
### Links
* Source Code - https://github.com/CoolCat467/Checkers.git
* Issues - https://github.com/CoolCat467/Checkers/issues
### License
-------
Code and documentation are available according to the GNU General Public License v3.0 (see [LICENSE](https://github.com/CoolCat467/Checkers/blob/HEAD/LICENSE)).