Invaders

Dmitry Sorokin (@sorydima)

Sobre aquest joc

Gira a l'àlbum per jugar i fer funcionar l'aplicació correctament!

🚀 Descripció general

Aquesta és una versió millorada del clàssic joc Space Invaders, creada amb Flutter. El joc inclou moltes funcions i mecàniques modernes que el fan més atractiu i dinàmic.

✨ Característiques principals

🎮 Mecànica del joc
- Mecànica de joc clàssica de Space Invaders amb gràfics millorats
- 5 modes de joc: Clàssic, Supervivència, Hardcore, Carrera Galàctica, Carrera contra el Cap
- Dificultat dinàmica que s'adapta a l'habilitat del jugador
- Sistema de combos per augmentar les puntuacions
- Caps amb patrons d'atac únics

🔫 Sistema d'armes avançat
- 6 tipus d'armes:
- Canó bàsic
- Tret dispers
- Raig làser
- Canó de plasma
- Llançacoets
- Pistola d'ones
- Sistema d'energia per a armes amb regeneració
- Efectes visuals per a cada tipus d'arma

⚡ Habilitats especials
- Alentiment del temps: alenteix el temps
- Neteja de pantalla: neteja la pantalla
- Mega escut: mega escut
- Foc ràpid: tret accelerat
- Recàrregues del sistema amb indicadors visuals

👾 Enemics avançats
- 8 tipus d'enemics amb habilitats úniques:
- Franctirador
- Tanc
- Curador
- Generador
- Fantasma
- Metamorfosi
- Blindat
- Teletransportador
- IA enemiga amb habilitats
- Salut visual i escut indicadors

🌌 Riscos ambientals
- 6 tipus de perill:
- Asteroides
- Deixalles espacials
- Forats negres
- Erupcions solars
- Cometes
- Nebulosa
- Aparició dinàmica de perills
- Elements de joc estratègics

💎 Bonificacions millorades
- 10 tipus de bonificacions:
- Multi-Tret
- Escut
- Augment de velocitat
- Augment de vida
- Millora d'arma
- Augment d'energia
- Bomba de rellotgeria
- Imant
- Dron
- Congelació
- Sistema de generació de bonificacions ponderat

🎨 Efectes visuals
- Tremolor de la pantalla durant les explosions
- Partícules i efectes visuals
- Efecte de càmera lenta
- Efectes visuals únics per a cada habilitat
- Indicadors animats i barres de progrés

🏆 Sistema d'assoliments
- Nombrosos assoliments per desbloquejar
- Sistema de puntuació i puntuació alta
- Taules de classificació (locals i en línia)
- Campanya amb missions úniques

🛠️ Característiques tècniques

Arquitectura
- Flutter/Dard per al desenvolupament multiplataforma
- Arquitectura modular de separació de preocupacions
- Serveis per a àudio, localització i taules de classificació
- Models per a tots els objectes del joc
- Widgets per a components de la interfície d'usuari

Estructura del projecte
```
lib/
├── models/ Models de dades
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ ├── environmental_hazard.dart
│ ├── power_up.dart
│ └── ...
├── screenshots/ Pantalles del joc
│ ├── game_screen.dart
│ ├── start_menu_screen.dart
│ └── ...
├── widgets/ Widgets de la interfície d'usuari
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ └── ...
├── services/ Serveis
│ ├── audio_service.dart
│ ├── localization_service.dart
│ └── ...
└── game_state.dart Estat del joc
```

Plataformes compatibles
- Web (Chrome, Edge, Firefox, Safari)
- Escriptori de Windows
- Android
- iOS

🎮 Controls

Teclat
- ← → - Moviment del jugador
- Barra espaiadora - Disparar
- Q/E - Canviar d'arma
- 1-4 - Activar habilitats especials
- P/ESC - Pausa

Tocar/Ratolí
- Arrossegar - Moviment del jugador
- Tocar/Clic - Disparar

🚀 Instal·lació i llançament

Requisits
- Flutter SDK 3.0+
- Dart SDK 2.17+
- Per a web: navegador modern

Instal·lació
```bash
Clonar el repositori
git clone https://github.com/Katya-AI-Systems-LLC/SpaceInv.git
cd space-invaders

Instal·lar dependències
flutter pub get

Executar al navegador
flutter run -d chrome --web-port=8080

Executar a Windows
flutter run -d windows

Executar a Android
flutter run -d android
```

📦 Compilar

Versió web
```bash
flutter build web --web-renderer canvaskit
```

Windows
```bash
flutter build windows
```

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

🤝 Contribuir al projecte

Com Per contribuir
1. Bifurcar el projecte
2. Crear una branca per a la teva funcionalitat (`git checkout -b feature/AmazingFeature`)
3. Confirmar els canvis (`git commit -m 'Afegir alguna AmazingFeature'`)
4. Publicar a la branca (`git push origin feature/AmazingFeature`)
5. Obre una sol·licitud d'extracció

Recomanacions
- Seguir l'estil de codi Dart
- Afegir comentaris per a codi complex
- Provar els canvis en diferents plataformes
- Actualitzar la documentació

📝 Documentació

- [Documentació de l'API](docs/API.md)
- [Document de disseny de joc](docs/GAME_DESIGN.md)

Bon joc! 🎮

Novetats

Initial release!