Invaders

Dmitry Sorokin (@sorydima)

Kuhusu mchezo huu

Zungusha hadi kwenye albamu ili kucheza mchezo na kufanya kazi kwa usahihi!

🚀 Muhtasari

Hili ni toleo lililoboreshwa la mchezo wa kawaida wa Space Invaders, uliojengwa kwa kutumia Flutter. Mchezo huu unajumuisha vipengele na mbinu nyingi za kisasa zinazoufanya uwe wa kuvutia na wenye nguvu zaidi.

✨ Sifa Muhimu

🎮 Mekaniki za Mchezo
- Mchezo wa kawaida wa wavamizi wa nafasi wenye michoro iliyoboreshwa
- Njia 5 za mchezo: Kawaida, Kupona, Ngumu, Kukimbia kwa Galactic, Kukimbilia kwa Bosi
- Ugumu wa nguvu unaobadilika kulingana na ujuzi wa mchezaji
- Mfumo wa mchanganyiko wa kuongeza alama
- Mabosi wenye mifumo ya kipekee ya kushambulia

🔫 Mfumo wa Silaha wa Kina
- Aina 6 za silaha:
- Mizinga ya Msingi
- Risasi ya Kuenea
- Mwanga wa Leza
- Mizinga ya Plasma
- Kizindua Roketi
- Bunduki ya Wimbi
- Mfumo wa nishati kwa silaha zenye kuzaliwa upya
- Athari za kuona kwa kila aina ya silaha

⚡ Uwezo Maalum
- Muda Polepole - hupunguza muda
- Kusafisha Skrini - husafisha skrini
- Ngao Kubwa - ngao kubwa
- Moto wa Haraka - upigaji risasi wa kasi
- Mfumo Hupakia Upya na viashiria vya kuona

👾 Maadui wa Kina
- Aina 8 za adui zenye uwezo wa kipekee:
- Sniper
- Tangi
- Mponyaji
- Mtoaji
- Phantom
- Mfinyanzi
- Imefunikwa
- Mtoaji wa Teleporter
- Adui Akili Mwenye Uwezo
- Afya ya kuona na Viashiria vya ngao

🌌 Hatari za Mazingira
- Aina 6 za hatari:
- Asteroidi
- Uchafu wa Anga
- Mashimo Meusi
- Miale ya Jua
- Nyota
- Nebula
- Kuzaa kwa hatari inayobadilika
- Vipengele vya kimkakati vya mchezo

💎 Bonasi Zilizoboreshwa
- Aina 10 Bonasi:
- Risasi Nyingi
- Ngao
- Kuongeza Kasi
- Kuongeza Maisha
- Uboreshaji wa Silaha
- Kuongeza Nishati
- Bomu la Wakati
- Sumaku
- Ndege Isiyo na Rubani
- Kugandisha
- Mfumo wa kuzaa wa bonasi wenye uzito

🎨 Athari za Kuonekana
- Kutikisa skrini wakati wa milipuko
- Chembe na athari za kuona
- Athari ya mwendo wa polepole
- Athari za kipekee za kuona kwa kila uwezo
- Viashiria vya uhuishaji na baa za maendeleo

🏆 Mfumo wa Mafanikio
- Mafanikio mengi ya kufungua
- Mfumo wa alama na alama za juu
- Ubao wa Uongozi (wa ndani na mtandaoni)
- Kampeni yenye misheni za kipekee

🛠️ Vipengele vya Kiufundi

Usanifu
- Kuteleza/Kuruka kwa ajili ya maendeleo ya majukwaa mbalimbali
- Mgawanyiko wa kawaida wa wasiwasi usanifu
- Huduma za sauti, ujanibishaji, na ubao wa wanaoongoza
- Mifumo ya vitu vyote vya mchezo
- Wijeti za vipengele vya UI

Muundo wa Mradi
```
lib/
├── mifumo/ Mifumo ya Data
│ ├── weapon.dart
│ ├── advanced_enemy.dart
│ ├── environmental_hazard.dart
│ ├── power_up.dart
│ └── ...
├── skrini/ Skrini za Mchezo
│ ├── game_screen.dart
│ ├── start_menu_screen.dart
│ └── ...
├── wijeti/ Wijeti za UI
│ ├── silaha.dart
│ ├── advanced_enemy.dart
│ └── ...
├── huduma/ Huduma
│ ├── audio_service.dart
│ ├── localization_service.dart
│ └── ...
└── game_state.dart Hali ya Mchezo
```

Mifumo Inayotumika
- Wavuti (Chrome, Edge, Firefox, Safari)
- Windows Desktop
- Android
- iOS

🎮 Vidhibiti

Kibodi
- ← → - Mwendo wa mchezaji
- Upau wa Nafasi - Risasi
- Q/E - Badilisha silaha
- 1-4 - Washa uwezo maalum
- P/ESC - Sitisha

Gusa/Kipanya
- Buruta - Mwendo wa mchezaji
- Gusa/Bonyeza - Upigaji Risasi

🚀 Usakinishaji na Uzinduzi

Mahitaji
- Flutter SDK 3.0+
- Dart SDK 2.17+
- Kwa wavuti: kivinjari cha kisasa

Usakinishaji
```bash
Nakili hazina
git clone https://github.com/Katya-AI-Systems-LLC/SpaceInv.git
cd space-invaders

Sakinisha utegemezi
flutter pub get

Endesha katika kivinjari
flutter run -d chrome --web-port=8080

Endesha kwenye Windows
flutter run -d windows

Endesha kwenye Android
flutter run -d android
```

📦 Build

Toleo la wavuti
```bash
flutter build web --web-renderer canvaskit
```

Windows
```bash
flutter build windows
````

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

🤝 Kuchangia Mradi

Jinsi ya Changia
1. Futa mradi
2. Unda tawi la kipengele chako (`git checkout -b feature/AmazingFeature`)
3. Toa mabadiliko yako (`git commit -m 'Ongeza AmazingFeature'`)
4. Sukuma hadi tawi (`git push origin feature/AmazingFeature`)
5. Fungua Ombi la Kuvuta

Mapendekezo
- Fuata mtindo wa msimbo wa Dart
- Ongeza maoni kwa msimbo tata
- Jaribu mabadiliko kwenye mifumo tofauti
- Sasisha hati

📝 Nyaraka

- [Nyaraka za API](hati/API.md)
- [Nyaraka za Ubunifu wa Mchezo](hati/GAME_DESIGN.md)

Furahia michezo ya kubahatisha! 🎮

Vipengele vipya

Initial release!