Super Mario Game

Welcome to the Super Mario game, a Python-based 2D platformer where you control Mario. The game features classic gameplay with modern code! Mario has 3 lives, must avoid falling mushrooms, and dodge crabs moving across the screen. Can you help Mario survive?

Table of Contents

• Game Features
• Gameplay
• Installation
  • Prerequisites
  • Step 1: Clone the Repository
  • Step 2: Create and Activate a Virtual Environment
  • Step 3: Install Dependencies
  • Step 4: Run the Game
• Game Controls
• Code Structure
• Development Guidelines
• Future Features
• Contributing
• License

Game Features

• 3 Lives: Mario starts with 3 lives. Once all lives are lost, it's game over.
• Falling Mushrooms: Mushrooms fall from the sky at random positions. Avoid them to stay alive.
• Moving Crabs: Crabs move horizontally from left to right across the screen. Avoid getting hit by them.
• Classic Controls: Use arrow keys to move Mario left and right, and the spacebar to jump.
• Dynamic Gameplay: As you progress, the speed of falling mushrooms and moving crabs increases, making the game more challenging.

Start Game

Gameplay

The goal of the game is to avoid obstacles (mushrooms and crabs) for as long as possible. You start with 3 lives, and each time you hit a mushroom or crab, you lose a life. When all lives are lost, the game ends.

The game progressively becomes harder, with obstacles increasing in speed, testing your reflexes and timing.

Installation

Follow the steps below to install and run the Super Mario game on your local machine.

Prerequisites

• Python 3.x: Ensure Python is installed on your system. You can download it from python.org.
• PyCharm: (Optional but recommended) Use PyCharm IDE for better development experience. You can download it from jetbrains.com.

Step 1: Clone the Repository

Start by cloning the GitHub repository:

git clone https://github.com/elliot31878/SuperMarioGame.git
cd SuperMarioGame
pip install -r requirements.txt