A mono-repo for a collection of different games created with the Pygame library. Games are in various stages of development and functionality. The purpose of this repository is to get students to collaborate, learn GitHub, and have fun! So propose a new game or contribute to one listed here, but get involved and reach out to the club if you want help with setup or anything else!

This repository's structure is as follows:

pygames (root)
  --game_title (game root)
    --src (application code directory)
      --class_directories (as needed)
      --main.py (application entry point)
      --requirements.py (packages required to develop the game)
  --game_title
    --(follow same pattern)

Each game directory is its own project.

Install Python 3.12

Fork the directory and set the upstream repository (see Workbook: Contribute)

Move into the directory of the game you wish to contribute to

cd <game_directory_name>

Create a virtual environment to install packages into

python3.12 -m venv .venv

Activate the environment

# macOS/Linux
source .venv/bin/activate
# PowerShell (Windows)
.venv\Scripts\Activate.ps1

Upgrade pip

python3.12 -m pip install --upgrade pip

Install required game packages

pip install -r requirements.txt

Start the game

python src/main.py

You are all set! If you have not yet taken one of the club's GitHub workshops or want a refresher visit our Workbook: Git & GitHub Chapter

Feel free to start your own game or contribute to an existing one.

Not sure where to start? Visit the Issues section for a list of tickets that will help get you started.

See a bug or want to request a feature or change? Create an issue!

Main is protected and will require a PR and approval to merge into main.

1. Asteroid clone
2. Conway's Game of Life