Please provide a short (one paragraph) summary of your project. Consider this your elevator pitch.

Include the link to your Devpost project page here: Devpost

Treasure Crush is inspired by the iconic game Candy Crush, where the player has to crush the specified number of gems to win the game. Explore three levels each with different board dimensions as you break through precious gems by matching at least three consecutive gems. Play to crush the number of gems before your turns run out!

• Jennifer Lu - jlu024 – jlu024@seas.upenn.edu – https://github.com/jlu024
• Pranith Lomada – plomada – plomada@seas.upenn.edu – https://github.com/ThePlom
• Zhixiang Huang -hzx365 – huangzhx@seas.upenn.edu – https://github.com/hzx365

This section walks a prospective user through the process of installing and running the project on their local machine. The more detailed and the more accurate, the better. User-friendly instructions will entice prospective users (including judges) to engage more deeply with your project, which could improve your hackathon score.

What prerequisites must be installed in order to run your project, and how do you install them?

Prerequisite: Be sure to install py_game and py-menu. Be aware that the pip-statement spelling is different from its import statement. 

$> pip install pygame-menu -U

import pygame
import pygame_menu

Step

The beauty of this game lies in its simplicity! 
You only need to download the zip file and its two libraries to enjoy the destruction of luxury items.

Give a step-by-step rundown of how to use your project. Including screenshots in this section can be highly effective for highlighting specific features of your project.

Step 1.

Enjoy the AI generated 8-bit background music when you first see the start menu. Choose your level (1-3) with the board dimensions (), (),  with an increasing number of gems to crush.

Step 2.

Your goal is to match at least three gems horizontally or vertically to crush the gems. 
Use your mouse to click on the two gems you want to swap; note swaps can only be made with the gem immediate to its left, right, top, or bottom, else the move is considered invalid. 
If you don’t like the first gem you chose, click on it again to deselect the initial gem and choose another gem.

Step 3.

Each valid move will reduce your turn’s counter. 
Watch your score soar, but be sure to complete the objective before your turns = 0, then it’s Game Over! 
Have fun playing.

Which frameworks, libraries, or other tools did you use to create your project?

• Tool 1 - The Pygame Menu Library accesses convenient menu basics.
• Tool 2 - Description
• Tool 3 - Description

Use anyone else's code? Inspired by a particular project? List / link here.

• Item 1: Candy Crush in Python - YouTube
• Item 2
• Item 3

If desired, add a section for your license. Reference sites like https://choosealicense.com can help you choose which license meets your needs.

For example:

This package is licensed under the GNU General Public License v3.0 (GPL-3).

No license applied!