Skip to content

avilesxd/code-destroy-aliens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

๐Ÿ‘พ Alien Invasion - Space Invader Game

Alien Invasion Logo

๐ŸŒŸ Defend Earth from Alien Invasion ๐ŸŒŸ

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

Build macOS Build Windows Code Quality & Tests Deploy to GitHub Pages

Python 3.8+
Python 3.8+
MIT License
MIT License
Total Downloads
Downloads
GitHub Stars
Stars
Latest Release
Latest Release

๐ŸŽฎ Ready to Save Humanity?

Play Now Download Game Documentation

๐ŸŽฏ 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.

Game Demo

โšก 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
Start Screen Active Gameplay Game Over Screen
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 development dependencies
pip install -r requirements.txt

# 4. Run tests
python -m pytest tests/

# 5. Start developing!
python main.py

๐Ÿค Contributing

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

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ‘ฅ Meet the Development Team


๐ŸŒ Community & Support

Connect with us and join the community!

GitHub Instagram Facebook YouTube TikTok

๐Ÿ†˜ Getting Help


๐Ÿ“„ 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 โญ

GitHub Stars

Ready to defend Earth and save humanity? The aliens are waiting... ๐Ÿ‘พ

Play Now

Made with โค๏ธ by Ignacio Avilรฉs