| 🌟 Stars | 🍴 Forks | 🐛 Issues | 🔔 Open PRs | 🔕 Close PRs |
|
|
|
|
|
### This project is now OFFICIALLY accepted for
| Name | Logo | Purpose |
|-----------------------|-----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| GSSoC'2024-Extd |  | The coding period is from October 1st to 10th of November, during which contributors make contributions and earn points on the platform. |
| Hacktoberfest 2024 |  | Hacktoberfest is a month-long October event welcoming all skill levels to join the open-source community. |
## 📑 Table of Contents
1. [Stars, Forks, Issues, and Pull Requests](#-stars-forks-issues-and-pull-requests)
2. [Features](#-features)
3. [How to Play](#-how-to-play)
4. [Game Rules](#-game-rules)
5. [Tech Stack](#-tech-stack)
6. [How to Play Locally](#-how-to-play-locally)
7. [Our Valuable Contributors](#️-our-valuable-contributors)
8. [Stargazers](#stargazers)
9. [Forkers](#forkers)
10. [Support the Project](#️-support-the-project)
# 🌟 Features
- ✨ **Exciting Alien Invasion Gameplay**: Fight waves of alien ships attacking your base.
- 🎮 **Easy Controls & Interface**: Restart the game, track your score, and see your remaining lives in an easy-to-use side panel.
- 💥 **Three Lives**: Defend your base with only 3 chances!
- 🚀 **Smooth Shooting**: Enjoy responsive shooting to destroy the alien invaders.
- 🖥️ **Modern Graphics**: Simple and clean interface that looks great.
- 🔄 **Quick Restart**: Restart the game instantly with one click.
- 🏆 **Leaderboard (Optional)**: Track your highest scores and compete with others.
# 🎮 How to Play
1. **Start the Game**: Click the "Start" button to begin.
2. **Move and Shoot**: Use your keyboard or on-screen controls to move your spaceship and shoot at alien ships.
3. **Lives**: You have 3 lives. You lose a life if an alien reaches your base or if your ship is hit.
4. **Game Over**: When you lose all 3 lives, the game ends. Click "Restart" to try again.
5. **Progress**: Destroy all alien ships in each wave to move on to the next level and increase your score.
# 📜 Game Rules
- **Survive as long as you can** by shooting alien ships and protecting your base.
- **3 Lives Only**: If aliens reach your base or hit your ship 3 times, the game ends.
- **Restart Anytime**: Use the "Restart" button to start over.
- **Earn Points**: Destroy alien ships to get points. Aim for the highest score before losing all your lives!
# -Tech Stack
This game is built using:
# 🚀 How to Play Locally
To play this game on your own computer:
1. **Clone the Repository**:
```bash
git clone https://github.com/YOUR_GITHUB_USERNAME/Alien-Invasion-Defense.git
2. **Create a new branch**:
```bash
git checkout -b feature-branch
3. **Push to your branch**:
```bash
git push origin feature-branch
4. Open a pull request to the main repository.
# 🐳 Docker Setup
To run this website on a container:
1. **Clone the Repository**:
```bash
git clone https://github.com/YOUR_GITHUB_USERNAME/Alien-Invasion-Defense.git
2. **Build the Docker image:**:
```bash
docker build -t
### Complete this process in GitHub (in your browser)
```mermaid
flowchart LR
Fork[Fork the project]-->branch[Create a New Branch]
branch-->Edit[Edit file]
Edit-->commit[Commit the changes]
commit -->|Finally|creatpr((Create a Pull Request))
```
## 🌍 Our Valuable Contributors
Keep learning 📚, exploring 🌍, and contributing 🤝 to make a difference in the world!
#Made with ❤️ for all space defenders!
