Bottom Line

# 🧟‍♂️ BottomLine: Niekończąca się obrona przed zombie

**BottomLine** to gra typu „niekończąca się obrona wieży” z zombie, stworzona na platformie **Phaser 3** i wydana na Androida za pomocą **Capacitor**.

Broń swojej bazy, ulepszaj wieże, pokonuj bossów i przetrwaj coraz trudniejsze fale zombie.

---

## 🎮 Przegląd rozgrywki

* Zombie poruszają się przez **wiele alejek**

* **Stawiasz i ulepszasz wieże**, aby je powstrzymać

* **Bossowie** odblokowują dodatkowe aleje

* Poziom trudności skaluje się w nieskończoność

---

## 🧠 Mechanika podstawowa

### 🛣️ System alejek

* Do **9 alejek**

* Odblokowywane stopniowo:

* Poziom 1 → 1 aleja

* Poziom 2 → 3 aleje

* Poziom 3 → 5 alejek

* Poziom 4 → 7 alejek

* Poziom 5 → 9 alejek

---

### 👾 Typy wrogów

| Typ | Zachowanie |

| ------ | ----------------------------- |

| Szwendacz | Zbalansowany podstawowy zombie |

| Biegacz | Szybki, niskie HP |

| Tank | Powolny, wysokie HP, atakuje wieże |

| Boss | Wysokie HP, odblokowuje nowe aleje |

---

### 🏗️ Wieże

| Poziom | Typ | Opis |

| ----- | ------------- | ------------------------------ |

| 1 | Podstawowy | Zbalansowany atak |

| 2 | Szybki | Szybszy ostrzał |

| 3 | Ciężki | Wysokie obrażenia |

| 4 | Wybuchowy | Obrażenia rozpryskowe (AOE) |

| 5 | Laser *(WIP)* | Planowana broń z ciągłym strumieniem |

---

### 💰 Ekonomia

* Zdobądź **żetony** za zabójstwa

* Użyj żetonów do:

* Ulepszania wież

* Bossowie dają **bonusowe nagrody**

---

### 🧟 System Bossów

Bossowie pojawiają się przy rosnących progach:

```

50 → 100 → 200 → 400 → ...

```

Pokonanie bossa:

* Odblokowuje więcej alejek

* Zwiększa poziom trudności

---

## 🖥️ Ekrany

### ▶️ Ekran startowy

* Tytuł gry

* Instrukcje

* Przycisk Start

### 💥 Rozgrywka

* Obrona wieży w czasie rzeczywistym

* Walka na alejkach

* Skalowanie poziomu trudności

### ☠️ Ekran zakończenia gry

* Finał Statystyki:

* Zabójstwa

* Zdobyte tokeny

* Pokonani bossowie

* Ponów próbę lub powrót do menu

---

## 🛠️ Stos technologiczny

* **Phaser 3** – Silnik gry

* **JavaScript (moduły ES)**

* **Capacitor** – Pakowanie Androida

* **Android Studio** – Kompilacja i generowanie APK

---

## 📱 Kompilacja Androida

### Wymagania

* Node.js

* Android Studio

* Java JDK

---

### Instalacja zależności

```bash

npm install

```

---

### Kompilacja zasobów internetowych

```bash

npm run build

```

---

### Synchronizacja z Capacitor

```bash

npx cap sync android

```

---

### Otwórz w Androidzie Studio

```bash

npx cap open android

```

---

### Kompilacja APK

W Android Studio:

```

Kompilacja → Kompilacja APK

```

---

## 🎨 Zasoby

* Niestandardowe sprite'y zombie (animacje chodzenia i śmierci)

* Sprite'y wieży (5 poziomów)

* Efekty wybuchów

* Tło lasu/apokalipsy

* Niestandardowe ikony ekranu powitalnego i launchera

---

## 📦 Struktura projektu

```

src/

├── main.js

├── GameScene.js

├── StartScene.js

├── SummaryScene.js

android/

└── Projekt Capacitor na Androida

public/assets/

├── zombie/

├── wieże/

├── efekty/

```

---

## ⚙️ Kluczowe systemy

* Ruch wroga na alejach

* Zmiana alei wroga (losowe sąsiedztwo)

* Celowanie w wieże z opóźnieniem obrotu

* System strzelania oparty na czasie odnowienia

* Obliczanie obrażeń obszarowych

* Logika progresji bossów

* System ekonomii żetonów

---

## 🚧 Plan rozwoju

Planowane funkcje:

* 🔫 Wieża laserowa (poziom 5)

* 🧪 Więcej typów zombie:

* Spitter (dystansowy)

* Mutant (mini-boss)

* 🌊 System fal

* 🔊 Efekty dźwiękowe i muzyka

* 💾 System zapisu / wyników

* 📊 Ulepszenia balansu gry

* 🏆 Osiągnięcia

---

## 🐞 Znane problemy

* Skalowanie interfejsu użytkownika może się różnić w zależności od urządzenia

* Trwają prace nad balansem

* Niektóre animacje mogą wymagać optymalizacji

---

## 🙌 Wkład

Ten projekt jest obecnie w fazie aktywnego rozwoju.

Zachęcamy do forkowania, testowania i proponowania ulepszeń.

---

## 📜 Licencja

Do ustalenia

---

## 👤 Autor

**Erwin Galang**

---

## 🎯 Uwaga końcowa

BottomLine został stworzony jako **zabawny, skalowalny fundament obrony wieży** z możliwością rozbudowy do pełnej wersji mobilnej.

Przetrwaj tak długo, jak potrafisz.

Zombiaki się nie zatrzymują.