Skip to content

arunsCodeRepo/Build-Games-with-Amazon-Q-CLI

Repository files navigation

Build-Games-with-Amazon-Q-CLI

Build Games with Amazon Q CLI Challenge | #AmazonQDevCLI #BuildGamesChallenge

🚀 Retro Space Defender - Enhanced Edition

A classic arcade-style space shooter game built for the Amazon Q CLI Game Challenge! Experience the nostalgia of retro gaming with modern Python programming and enhanced features.

🎮 Game Features

Core Gameplay

  • Retro Aesthetic: Neon colors and pixel-perfect graphics reminiscent of 80s arcade games
  • Classic Gameplay: Space Invaders-style shooting action with modern twists
  • Progressive Difficulty: Enemies get faster and more aggressive as you advance
  • Multiple Enemy Types: Face different alien ships with unique behaviors and health
  • Smooth Controls: Responsive movement and shooting mechanics

✨ Enhanced Features (NEW!)

  • Particle Effects: Spectacular explosions with realistic particle physics
  • Shield System: Collect shield power-ups for temporary protection with visual effects
  • Multiple Weapon Types:
    • Single Shot (default)
    • Double Shot (fires two parallel bullets)
    • Triple Shot (fires three bullets in a spread pattern)
  • Boss Battles: Epic boss fights every 5 levels with unique attack patterns
  • Persistent High Scores: Your best scores are saved locally and displayed
  • Enhanced Visual Effects:
    • Animated starfield background
    • Player invulnerability flashing
    • Health and shield bars
    • Weapon timer indicators
  • Improved Power-up System: 5 different power-up types with clear visual indicators

🕹️ Controls

  • Arrow Keys: Move your spaceship
  • Spacebar: Fire lasers
  • P: Pause/Unpause the game
  • R: Restart (when game over)
  • Q: Quit the game

🛠️ Installation & Setup

  1. Install Python 3.7+ (if not already installed)

  2. Install pygame:

    pip install pygame

    Or using the requirements file:

    pip install -r requirements.txt
  3. Run the game:

    python retro_space_defender.py

🎯 Gameplay

  • Survive waves of alien invaders with increasing difficulty
  • Collect power-ups to enhance your ship's capabilities
  • Face challenging boss battles every 5 levels
  • Avoid enemy fire and collisions while managing your shield
  • Aim for the highest score possible and beat your personal best!

🎁 Power-ups

Symbol Type Effect
H Health Restores one health point
R Rapid Fire Increases firing rate
S Shield Provides temporary protection
D Double Shot Fires two parallel bullets
T Triple Shot Fires three bullets in spread pattern

👾 Enemy Types

  • Pink Enemies: Basic aliens with standard speed and health
  • Yellow Enemies: Faster aliens with increased firing rate
  • Cyan Enemies: Advanced aliens with higher health and aggressive behavior
  • Boss Enemies: Massive ships with multiple attack patterns and high health

🎨 Retro Design Elements

  • Neon Color Palette: Bright greens, pinks, blues, yellows, and cyans
  • Geometric Shapes: Simple polygons and rectangles for that classic look
  • Animated Starfield: Multi-layered moving stars create depth and atmosphere
  • Pixel-Perfect Graphics: Clean, sharp edges without anti-aliasing
  • Classic UI: Retro-style interface with health bars and weapon indicators
  • Particle Effects: Colorful explosions and visual feedback

🏆 Amazon Q CLI Game Challenge

This enhanced game demonstrates:

  • Advanced Game Design: Complex mechanics including boss battles and power-up systems
  • Object-Oriented Programming: Clean, modular code structure with separate classes
  • Visual Effects: Particle systems and advanced rendering techniques
  • Data Persistence: High score saving and loading functionality
  • User Experience: Intuitive controls, clear feedback, and progressive difficulty
  • Performance Optimization: Efficient collision detection and memory management

🚀 Technical Highlights

Core Systems

  • Object-oriented design with separate classes for all game entities
  • Advanced collision detection with damage and shield systems
  • Dynamic enemy spawning with type progression
  • Comprehensive power-up system with timed effects
  • Smooth animation and movement with physics-based particles

Enhanced Features

  • Particle System: Realistic explosion effects with gravity and fade-out
  • Shield Mechanics: Visual shield rendering with transparency effects
  • Weapon System: Multiple firing patterns with angle-based projectiles
  • Boss AI: Complex behavior patterns with phase-based attacks
  • Data Persistence: JSON-based high score storage and retrieval
  • Visual Polish: Enhanced UI with bars, timers, and status indicators

📊 Game Statistics

  • 5 Power-up Types: Each with unique visual and gameplay effects
  • 3 Enemy Types: Plus challenging boss encounters
  • 3 Weapon Types: From single shot to triple spread
  • Persistent High Scores: Top 10 scores saved locally
  • Dynamic Difficulty: Scaling based on level progression
  • 60 FPS Gameplay: Smooth, responsive gaming experience

Future Enhancement Potential

The enhanced codebase now supports easy addition of:

  • Sound effects and music
  • More boss types and attack patterns
  • Additional weapon types
  • Achievement system
  • Multiplayer features
  • Custom ship designs
  • Level-based progression

Total Enhancement Time: Comprehensive upgrade maintaining retro aesthetic while adding modern game features! 🎮✨

🎮 About the Developer

Created with passion for retro gaming and modern Python development. This enhanced edition showcases advanced game programming techniques while maintaining the classic arcade feel that made the original space shooters so addictive.


Defend the galaxy with style! 🛸✨💥

About

Build Games with Amazon Q CLI Challenge | #AmazonQDevCLI #BuildGamesChallenge

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages