j-w-s/Checkers

Checkers made in Python 3.X

CHECKERS

A project for CSC 132 completed by 3 students using Python
Project»

Table of Contents

1. About Project
2. Getting Started
   • Prerequisites
   • Installation
   • Building
3. Features
4. Contributors

About Project

This project ecnompasses 3 students' implementation of the game Checkers using the Python scripting language, the module tkinter, and GPIO input from a breadboard to the Raspberry Pi 3b.

Getting Started

This section contains information regarding the creation and use of this project: how we built the enclosure, how we synthesized compatability with the breadboard, the total expenditure of monetary resources for the materials of the project, the installation of this software, and more.

Prerequisites

Hardware necessary for the project

1. A square board with dimensions 0.20"x23.88"x23.88"
2. A Raspberry Pi 3b or other compatible device
3. A screen capable of displaying output from the Raspberry Pi 3b or other compatible device
4. A screwdriver kit
5. A utility knife
6. A drill
7. Wood Glue
8. Access to a laser cutter that can read and utilize .dfx files
9. Small latches with dimensions 1"x1"
10. Buttons and a joystick from Amazon or competing retailer

Software necessary for the project

1. The latest version of Python, which can be downloaded below:

https://www.python.org/ftp/python/3.9.4/python-3.9.4-amd64.exe

2. The following .dfx file:

https://github.com/j-w-s/Checkers/blob/main/Console.dxf

Total cost for project

Installation

1. Run the previously downloaded executable file for Python 3.X and install Python
2. Load the command prompt and install tkinter via the following command:

   py -m pip install tkinter

3. From the github project, download the .zip file named "Checkers"
4. Unzip the downloaded folder to a preferred location
5. Load IDLE and open the .py file with name "checkers.py" stored inside the folder saved at the preferred location mentioned in step 4
6. Select run

Building

1. Load the .dfx file to a machine that can laser-cut the design for the enclosure of the Raspberry Pi 3b
2. Cut the wooden planks
3. Stain cut pieces and let dry
4. Assemble cut pieces for the enclosure
5. Drill holes for the buttons, joystick, and power cord
6. Use a utility knife to cut a hole in the top piece of the enclosure for the display of the Raspberry Pi 3b or competing device
7. Use screws to ground accessories to their designated locations on the enclosure
8. Use wood glue to seal pieces together

Features

The main program included in this project implements the game Checkers. Players of the game may utilize a single joystick and pair of buttons to move pieces around the board and approve or decline their movements. This version of the game follows the standard rules of the game, such that:

1. Black moves first. Players then alternate moves.
2. Moves are allowed only on the dark squares; pieces only move diagonally forward, toward the opponent. However, Kings can also move backwards.
3. A piece may only move one square unless it is making a jump.
4. Etc.

Above information adapted from the below source, which contains all rules of the game:

https://winning-moves.com/images/kingmerulesv2.pdf

Contributors