|
1 | | -# Checkers + |
2 | | -"Classic Checkers+ " is an exciting Python-based game project that offers a modern twist on the classic game of checkers. Upon launching the game, users are presented with a prompt to choose between two game modes: Player vs. Player (PvP) or Player vs. AI. The game adheres to standard checkers rules with a few intriguing alterations. |
| 1 | +# Checkers+ |
| 2 | +Checkers+ is an exciting Python-based game that offers a modern twist on the classic game of checkers. Upon launching the game, users are presented with a prompt to choose between two game modes: Player vs. Player (PvP) or Player vs. AI. The game adheres to standard checkers rules with a few intriguing alterations. Checkers+ is a game for people of all ages and skill levels, and we hope you enjoy! |
3 | 3 |
|
4 | | - |
5 | | -# How to run |
6 | | -Provide here instructions on how to use your application. |
7 | | -- Download the latest binary from the Release section on the right on GitHub. |
8 | | -- On the command line uncompress using |
9 | | -``` |
10 | | -tar -xzf |
11 | | -``` |
12 | | -- On the command line run with |
13 | | -``` |
14 | | -./hello |
15 | | -``` |
16 | | -- You will see Hello World! on your terminal. |
17 | | - |
18 | | -# How to contribute |
19 | | -Follow this project board to know the latest status of the project: https://github.com/orgs/cis3296f23/projects/116 |
20 | | - |
21 | | -# How to build |
| 4 | +# Build Overview |
22 | 5 | - Use this github repository: https://github.com/cis3296f23/Project-02-checkers.git |
23 | 6 | - For the most stable release and latest changes, please refer to the main branch. |
24 | 7 | - Python is the programming language of choice for this project. For Python installation instruction please refer to this link: https://wiki.python.org/moin/BeginnersGuide/Download |
25 | 8 | - May use any IDE to assist in Python development |
26 | 9 | - Pygame will be used for this project. For Pygame installation instructions, please refer to this link: https://www.pygame.org/wiki/GettingStarted |
27 | | -- What file and target to compile and run. |
28 | | -- When the game starts, the user will be presented with a main menu to select next course of action. |
| 10 | + |
| 11 | +# Build and Installation Guide |
| 12 | +- First, if your machine does not have Python, download the latest version of Python. This can be found here: https://www.python.org/downloads/ |
| 13 | +- Create a folder and download the most recent release in this repository. Import all files into this folder. |
| 14 | +- Open the command prompt on your machine, and type "pip install pyinstaller". This will install PyInstaller in your Python's Scripts Folder. The Scripts folder can be found inside your Python folder. |
| 15 | +- If you're having trouble finding this location, open your file explorer and search this PC for "pyinstaller.exe". This should allow you to open the location of pyinstaller. Copy this path. |
| 16 | +- Inside of your created folder, open the command prompt and paste the path, followed by "\pyinstaller main.py --clean --onefile --windowed". This will create an application for Checkers+. |
| 17 | +- Once PyInstaller is finished, your folder containing the files should now have a new folder inside titled "dist". Inside this folder is the Checkers+ application under the title "main". |
| 18 | +- If you try running the application, you will notice there are errors that prevent you from doing so. To fix this, copy and paste the application outside of the "dist" folder, where all the files from the current release are held. |
| 19 | +- Running the application should now work! |
| 20 | + |
| 21 | +Note: |
| 22 | +- Due to current issues with PyInstaller, our release does not include a pre-existing application that users can run. Manually installing and running using the previous steps is required. |
29 | 23 |
|
30 | 24 | # Brainstorming Board |
| 25 | +- This board contains the initial features list as a path we would expect an intermediate player to take using Checkers+. |
31 | 26 | - https://lucid.app/lucidspark/128ef961-9edf-4a88-8eaf-992d7faa5d74/edit?viewport_loc=-350%2C-445%2C3025%2C1429%2C0_0&invitationId=inv_e2d583a2-18f2-4676-8253-7a01ce813867 |
| 27 | + |
| 28 | +# How to contribute |
| 29 | +Follow this project board to know the latest status of the project: https://github.com/orgs/cis3296f23/projects/116 |
0 commit comments