README.md

📂 Table of Contents

• 📋 Project Description
• ✨ Features
• ⛏️ Built Using
• 🎫 Dependencies
• 📥 Installation
  • Using pip
  • Using conda
• 📝 Usage
• ✍ Contributors
• 💳 License
• 🏅 Acknowledgments

📋 Project Description

Alien invasion game that the user can interact with by destroying aliens' spaceships using a spaceship

demo.mp4

✨ Features

• The player controls a spaceship at the bottom of the screen
• The ship can move left and right using the arrow keys
• The ship can fire bullets upwards by pressing the space bar
• Rows of alien spaceships appear at the top of the screen and move back and forth
• The game stops when the user hits aliens' spaceships or when he closes the window
• The user can destroy all aliens' spaceships and more aliens' spaceships will appear

⛏️ Built Using

Backend and Frontend:

Assets

• Python Crash Course, 3rd Edition Book: Provided spaceships
• @Mohammed-Dhabaab: Provided the banner and the video demo

🎫 Dependencies

• Python=3.11.0
  • Pygame=2.5.2

📥 Installation

Using pip

1. You need to install Python=3.11.0, to ensure compatibility
2. Add python to environment variables (PATH)
3. Use the package manager pip to install pygame=2.5.2:

   pip install pygame=2.5.2

Using conda

1. Create alien_invasion environment:

   conda env create -f environment.yml

2. Activate alien_invasion environment:

   conda activate alien_invasion

3. Run the program:

   python src/main.py

📝 Usage

To play the Alien Invasion game, follow these steps:

1. Clone or download the project
2. Follow 📥 Installation process
3. After running the program
   • To move the spaceship use the arrow keys
   • To shoot by the spaceship press space

✍ Contributors

• @Mohammed Dhabaab

💳 License

• GNU AGPLv3

🏅 Acknowledgments

• Python Crash Course, 3rd Edition Book: One of the resources I learned Python through it