Skip to content

Commit cc88970

Browse files
Merge pull request #17 from cis3296f23/README_updates
Update README.md with Build Instructions
2 parents 0004655 + 48c69a5 commit cc88970

File tree

1 file changed

+20
-22
lines changed

1 file changed

+20
-22
lines changed

README.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,29 @@
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!
33

4-
![This is a screenshot.](images.png)
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
225
- Use this github repository: https://github.com/cis3296f23/Project-02-checkers.git
236
- For the most stable release and latest changes, please refer to the main branch.
247
- 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
258
- May use any IDE to assist in Python development
269
- 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.
2923

3024
# Brainstorming Board
25+
- This board contains the initial features list as a path we would expect an intermediate player to take using Checkers+.
3126
- 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

Comments
 (0)