👾 Alien Invasion - Space Invader Game

🌟 Defend Earth from Alien Invasion 🌟

Experience the classic Space Invaders gameplay with modern graphics and challenging levels

Python 3.8+

MIT License

Downloads

Stars

Latest Release

🎮 Ready to Save Humanity?

---

🎯 About The Project

Alien Invasion is a modern remake of the classic arcade shooter that revolutionized gaming. Pilot your spaceship in an epic battle to defend Earth from waves of increasingly challenging alien invaders. With stunning visuals, immersive audio, and addictive gameplay mechanics, this game perfectly balances nostalgic arcade action with contemporary polish.

⚡ Key Features

🚀 Gameplay Fast-paced arcade action Progressive difficulty system Multiple alien enemy types Smooth, responsive controls Challenging wave-based progression

🎨 Technical Excellence Modern Python/Pygame architecture High-contrast UI design Cross-platform compatibility Persistent high-score system Optimized performance

🌟 Advanced Features:

• 🎵 Dynamic Audio System - Immersive sound effects and background music
• 🌍 Multilingual Support - Automatic language detection (English/Spanish)
• 💥 Visual Effects - Particle systems and smooth animations
• 🎯 Enhanced UI - Semi-transparent overlays and clear game information
• 💯 Score Tracking - Persistent high-score system with progression metrics

---

📱 Game Screenshots

🏠 Main Menu	🎮 Gameplay	💀 Game Over
Clean, intuitive main menu	Intense alien-fighting action	Score tracking and restart options

---

🎮 How to Play

Controls

Key	Action	Description
← →	Move Ship	Navigate left and right
Space	Fire	Shoot bullets at aliens
P	Pause	Pause/unpause the game
M	Music Toggle	Turn background music on/off
S	Sound Toggle	Turn sound effects on/off
Q	Quit	Exit the game

Game Rules

1. 🎯 Objective: Destroy all aliens before they reach Earth
2. ⚡ Progression: Each wave moves faster and becomes more challenging
3. 💀 Lives: Limited lives - avoid alien collision and ground breach
4. 🏆 Scoring: Earn points for each alien destroyed
5. 🔄 Levels: Clear all aliens to advance to the next wave

---

🚀 Getting Started

Download & Play

📥 Windows Installation

1. Download the latest .exe from Releases
2. Run: Double-click the .exe file to start playing. No installation required!

System Requirements:

• Windows 10 64-bit or later
• 1 GB RAM, 1 GB storage
• OpenGL-compatible graphics

🍎 macOS Installation

1. Download: Get the latest .zip file for macOS from Releases
2. Extract: Unzip the downloaded file. This will create an application file (e.g., Alien Invasion.app).
3. Run: Drag the application to your Applications folder and open it from there.

System Requirements:

• macOS 10.13 High Sierra or later
• Intel or Apple Silicon (Rosetta supported)
• 2 GB RAM, 2 GB storage

🐧 Linux/Development Setup

# Clone the repository
git clone https://github.com/avilesxd/code-destroy-aliens.git
cd code-destroy-aliens

# Install dependencies
pip install -r requirements.txt

# Run the game
python main.py

Dependencies:

• Python 3.8+
• Pygame 2.0+
• Additional requirements in requirements.txt

---

🛠️ For Developers

Development Setup

# 1. Fork and clone the repository
git clone https://github.com/YOUR_USERNAME/code-destroy-aliens.git
cd code-destroy-aliens

# 2. Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. Install all dependencies
pip install -r requirements.txt

# 4. Run tests
python -m pytest tests/

# 5. Check for security vulnerabilities
npm run security:audit

# 6. Start developing!
python main.py

📋 Available Commands

# Development
npm run dev                    # Run the game
npm run verify                 # Run all quality checks (format, lint, typecheck, test)

# Testing
npm run test                   # Run tests
npm run test:coverage          # Run tests with coverage report

# Code Quality
npm run format                 # Format code (black + isort)
npm run lint                   # Run linter (flake8)
npm run typecheck              # Type checking (mypy)

# Security & Dependencies
npm run security:audit         # Check for security vulnerabilities
npm run security:audit-fix     # Attempt to fix vulnerabilities automatically
npm run deps:outdated          # List outdated dependencies
npm run deps:install           # Install all dependencies

# Building
npm run build:windows          # Build .exe for Windows
npm run build:macos            # Build .app for macOS

🤝 Contributing

We welcome contributions! Please check out our Contributing Guide and:

Important: All changes must be made in feature branches and submitted via Pull Request. Never commit directly to main.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and ensure all tests pass (npm run verify)
4. Commit your changes (git commit -m 'feat: add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request to main branch

---

👥 Meet the Development Team

Denilson Escobar Core Developer

Ignacio Avilés Lead Developer

Juan Galaz Game Designer

---

🌐 Community & Support

Connect with us and join the community!

🆘 Getting Help

• 🐛 Found a bug? Open an issue
• 💡 Have an idea? Request a feature
• ❓ Need help? Start a discussion
• 📖 Read the docs at our documentation site

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License - You're free to use, modify, and distribute this software.

---

🙏 Acknowledgments

• Classic Space Invaders - Original inspiration for gameplay mechanics
• Python Community - For the amazing Pygame library
• Open Source Contributors - Everyone who helps improve the project
• Players & Testers - Community feedback that makes the game better

---

🌟 Enjoying the game? Give us a ⭐

Ready to defend Earth and save humanity? The aliens are waiting... 👾

---

Made with ❤️ by Ignacio Avilés