Invaders

Dmitry Sorokin (@sorydima)

Rreth kësaj loje

Rrotullojeni në album për të luajtur lojën dhe për ta përdorur aplikacionin siç duhet!

🚀 Përmbledhje

Ky është një version i përmirësuar i lojës klasike Space Invaders, i ndërtuar duke përdorur Flutter. Loja përfshin shumë veçori dhe mekanika moderne që e bëjnë atë më tërheqëse dhe dinamike.

✨ Karakteristikat Kryesore

🎮 Mekanika e Lojës
- Lojë klasike e Space Invaders me grafikë të përmirësuar
- 5 mënyra loje: Klasike, Mbijetesë, Hardcore, Galactic Run, Boss Rush
- Vështirësi dinamike që përshtatet me aftësitë e lojtarit
- Sistem kombinimi për rritjen e rezultateve
- Bosë me modele unike sulmi

🔫 Sistem i Avancuar Armësh
- 6 lloje armësh:
- Top Bazë
- Të shtëna të përhapura
- Rreze lazeri
- Top plazme
- Lëshues raketash
- Armë me valë
- Sistem energjie për armët me rigjenerim
- Efekte vizuale për secilin lloj arme

⚡ Aftësi të Veçanta
- Ngadalësim kohe - ngadalëson kohën
- Pastrim ekrani - pastron ekranin
- Mega Mburoja - mega mburojë
- Zjarr i shpejtë - qitje e përshpejtuar
- Rimbushje sistemi me tregues vizualë

👾 Armiq të Avancuar
- 8 lloje armiqsh me aftësi unike:
- Snajper
- Tank
- Shërues
- Krijues
- Fantazmë
- Morfim
- I mbrojtur
- Teleportues
- IA armike me aftësi
- Treguesit vizualë të shëndetit dhe mburojës

🌌 Rreziqet Mjedisore
- 6 lloje rreziqesh:
- Asteroidë
- Mbeturinat Hapësinore
- Vrima të Zeza
- Shpërthime Diellore
- Kometa
- Mjegullnaja
- Shfaqja dinamike e rreziqeve
- Elemente strategjike të lojës

💎 Bonuse të Përmirësuara
- 10 lloje Bonusesh:
- Shumëfishimësh
- Mburoja
- Rritje Shpejtësie
- Rritje Jetëgjatësie
- Përmirësim Arme
- Rritje Energjie
- Bombë me Kohë
- Magnet
- Dron
- Ngrirje
- Sistem shfaqjeje bonusi me peshë

🎨 Efektet Vizuale
- Dridhje ekrani gjatë shpërthimeve
- Grimca dhe efekte vizuale
- Efekt lëvizjeje të ngadaltë
- Efekte unike vizuale për secilën aftësi
- Tregues dhe shirita progresi të animuar

🏆 Sistem Arritjesh
- Arritje të shumta për t'u zhbllokuar
- Sistem pikëzimi dhe rezultati të lartë
- Tabelat e Renditjes (lokale dhe online)
- Fushatë me misione unike

🛠️ Karakteristika Teknike

Arkitekturë
- Flutter/Dart për zhvillim ndërplatformor
- Modular Arkitektura e ndarjes së shqetësimeve
- Shërbime për audio, lokalizim dhe tabela renditjeje
- Modele për të gjitha objektet e lojës
- Widget-e për komponentët e UI-t

Struktura e Projektit
```
lib/
├── modele/ Modele të të Dhënave
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ ├── environmental_hazard.dart
│ ├── power_up.dart
│ └── ...
├── ekrane/ Ekrane Lojërash
│ ├── game_screen.dart
│ ├── start_menu_screen.dart
│ └── ...
├── widget-e/ UI Widget-e
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ └── ...
├── services/Shërbime
│ ├── audio_service.dart
│ ├── localization_service.dart
│ └── ...
└── game_state.dart Gjendja e Lojës
```

Platformat e Mbështetura
- Ueb (Chrome, Edge, Firefox, Safari)
- Windows Desktop
- Android
- iOS

🎮 Kontrollet

Tastiera
- ← → - Lëvizja e Lojtarit
- Tastiera Hapësirës - Qëllim
- Q/E - Ndërrimi i armëve
- 1-4 - Aktivizo aftësitë speciale
- P/ESC - Pauzë

Prekje/Maus
- Tërheqje - Lëvizja e Lojtarit
- Prek/Klik - Qitje

🚀 Instalimi dhe Hapja

Kërkesat
- Flutter SDK 3.0+
- Dart SDK 2.17+
- Për ueb: shfletues modern

Instalimi
```bash
Klononi depozitën
git clone https://github.com/Katya-AI-Systems-LLC/SpaceInv.git
cd space-invaders

Instaloni varësitë
flutter pub get

Ekzekutoni në shfletues
flutter run -d chrome --web-port=8080

Ekzekutoni në Windows
flutter run -d windows

Ekzekutoni në Android
flutter run -d android
```

📦 Ndërtoni

Versioni në internet
```bash
flutter build web --web-renderer canvaskit
```

Windows
```bash
flutter build windows
```

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

🤝 Kontribuoni në Projekti

Si të Kontribuoni
1. Ndani projektin në degë
2. Krijoni një degë për veçorinë tuaj (`git checkout -b feature/AmazingFeature`)
3. Kryeni ndryshimet tuaja (`git commit -m 'Add some AmazingFeature'`)
4. Shtyni në degë (`git push origin feature/AmazingFeature`)
5. Hapni një Kërkesë për Tërheqje

Rekomandime
- Ndiqni stilin e kodit Dart
- Shtoni komente për kod kompleks
- Testoni ndryshimet në platforma të ndryshme
- Përditësoni dokumentacionin

📝 Dokumentacioni

- [Dokumentacioni i API-t](docs/API.md)
- [Dokumentacioni i Dizajnit të Lojës](docs/GAME_DESIGN.md)

Lojëra të këndshme! 🎮

Ç'të reja ka

Initial release!