Invaders

Rotate to album to play the game and work the app correctly!

🚀 Overview

This is an enhanced version of the classic Space Invaders game, built using Flutter. The game includes many modern features and mechanics that make it more engaging and dynamic.

✨ Key Features

🎮 Game Mechanics
- Classic Space Invaders gameplay with improved graphics
- 5 game modes: Classic, Survival, Hardcore, Galactic Run, Boss Rush
- Dynamic difficulty that adapts to player skill
- Combo system for increasing scores
- Bosses with unique attack patterns

🔫 Advanced Weapon System
- 6 weapon types:
- Basic Cannon
- Spread Shot
- Laser Beam
- Plasma Cannon
- Rocket Launcher
- Wave Gun
- Energy system for weapons with regeneration
- Visual effects for each weapon type

⚡ Special Abilities
- Time Slow - slows down time
- Screen Clear - clears the screen
- Mega Shield - mega shield
- Rapid Fire - accelerated shooting
- System Reloads with visual indicators

👾 Advanced Enemies
- 8 enemy types with unique abilities:
- Sniper
- Tank
- Healer
- Spawner
- Phantom
- Morphing
- Shielded
- Teleporter
- Enemy AI with abilities
- Visual health and shield indicators

🌌 Environmental Hazards
- 6 hazard types:
- Asteroids
- Space Debris
- Black Holes
- Solar Flares
- Comets
- Nebula
- Dynamic hazard spawning
- Strategic gameplay elements

💎 Improved Bonuses
- 10 types Bonuses:
- Multi-Shot
- Shield
- Speed ​​Boost
- Life Up
- Weapon Upgrade
- Energy Boost
- Time Bomb
- Magnet
- Drone
- Freeze
- Weighted bonus spawn system

🎨 Visual Effects
- Screen shake during explosions
- Particles and visual effects
- Slow motion effect
- Unique visual effects for each ability
- Animated indicators and progress bars

🏆 Achievement System
- Numerous achievements to unlock
- Scoring and high-score system
- Leaderboards (local and online)
- Campaign with unique missions

🛠️ Technical Features

Architecture
- Flutter/Dart for cross-platform development
- Modular Separation of concerns architecture
- Services for audio, localization, and leaderboards
- Models for all game objects
- Widgets for UI components

Project Structure
```
lib/
├── models/ Data Models
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ ├── environmental_hazard.dart
│ ├── power_up.dart
│ └── ...
├── screens/ Game Screens
│ ├── game_screen.dart
│ ├── start_menu_screen.dart
│ └── ...
├── widgets/ UI Widgets
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ └── ...
├── services/ Services
│ ├── audio_service.dart
│ ├── localization_service.dart
│ └── ...
└── game_state.dart Game State
```

Supported Platforms
- Web (Chrome, Edge, Firefox, Safari)
- Windows Desktop
- Android
- iOS

🎮 Controls

Keyboard
- ← → - Player movement
- Spacebar - Shoot
- Q/E - Switch weapons
- 1-4 - Activate special abilities
- P/ESC - Pause

Touch/Mouse
- Drag - Player movement
- Tap/Click - Shooting

🚀 Installation and Launch

Requirements
- Flutter SDK 3.0+
- Dart SDK 2.17+
- For web: modern browser

Installation
```bash
Clone the repository
git clone https://github.com/Katya-AI-Systems-LLC/SpaceInv.git
cd space-invaders

Install dependencies
flutter pub get

Run in browser
flutter run -d chrome --web-port=8080

Run on Windows
flutter run -d windows

Run on Android
flutter run -d android
```

📦 Build

Web version
```bash
flutter build web --web-renderer canvaskit
```

Windows
```bash
flutter build windows
```

Android
```bash
flutter build apk --release
flutter build appbundle --release
```

🤝 Contributing to the Project

How to Contribute
1. Fork the project
2. Create a branch for your feature (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

Recommendations
- Follow Dart code style
- Add comments for complex code
- Test changes on different platforms
- Update documentation

📝 Documentation

- [API Documentation](docs/API.md)
- [Game Design Document](docs/GAME_DESIGN.md)

Happy gaming! 🎮

Recent changes:
Initial release!