An open API service indexing awesome lists of open source software.

https://github.com/mandyschen/hacktoon2

Winner of the Hacktoon2 Hack-a-Thon
https://github.com/mandyschen/hacktoon2

Last synced: about 1 year ago
JSON representation

Winner of the Hacktoon2 Hack-a-Thon

Awesome Lists containing this project

README

          

## Eco Puffs: Mission (not) Impossible

### Introduction
Our team wanted to spread a message about the importance of sustainability to a younger audience, and we saw Power Puff Girls as the perfect opportunity to broadcast to children an important message using their favorite characters.
Gameplay is known to be one of the most effective ways to educate young audiences. That's why, we decided to create a catch game to simulate a world of recycling and composting. The game aims to educate the audience about which item should go in the compost bin and which ones should go in the recycling bin — basic knowledge that surprisingly not everyone has!

### Description
The player controls either Blossom, Bubbles, or Buttercup in collecting items that are meant to either be recycled or put in the compost bin, all while avoiding their arch nemesis Mojo Jojo.
A variety of items will fall from the sky: banana peel, paper, soda can, etc. and your character must catch it and deposit it into the correct bin to earn points.

_A simple, yet intuitive and effective game in educating everyone about sustainability in every day life._

### Game Features
- **Variety of Characters**: Freedom to change to any character (from Blosson, Bubbles or Buttercup) anytime during the game
- **Smooth character movement experience:** left and right arrows to move side ways and UP or SPACE bar to jump
- **Scoreboard:** Keep track of your progress, challenge your friends to beat the score and reign as the champion
- **Fun soundtrack:** Addictive music beats in the background to enhance the gaming experience

### Visuals
**Menu Screen**

![image](https://user-images.githubusercontent.com/68432655/190905054-2757ff47-aa7e-4c35-aa43-0b4f98620f02.png)

**Game screen**

![gameinterface](https://user-images.githubusercontent.com/68432655/190902034-82dc04b5-8549-4ddf-8c3b-d7aa9c008718.png)

**Switch characters**

![diffchar](https://user-images.githubusercontent.com/68432655/190902032-55ce161d-48b2-4cd9-b8ba-9c3ea02eb633.png)

**Game play**

![Game play](https://user-images.githubusercontent.com/68432655/190902014-471aca34-4bd7-4d36-bfd8-dea23bed9a95.gif)

### Tech Stack
**PyGame:** Python library for game development

### Installation
Note: We recommend using [PyCharm](https://www.jetbrains.com/pycharm/) from JetBrains to run the program

Clone the repository in your local machine:

```bash
git clone https://github.com/mandyschen/hacktoon2.git
```

Make sure you have all the dependencies installed!

```bash
pip install -r requirements.txt
```

### Usage

Run the PyGame.py file and you should be able to access the game GUI in a separate window.

### Credits
_Game soundtrack:_ https://pixabay.com/music/video-games-man-is-he-mega-glbml-22045/

### Authors:
- Mandy
- William
- Fatou
- Emilie