# 🧟‍♂️ BottomLine: Endless Zombie Defense

**BottomLine** is a mobile-first, endless zombie tower defense game built with **Phaser 3** and packaged for Android using **Capacitor**.

Defend your base, upgrade towers, defeat bosses, and survive increasingly difficult waves of zombies.

---

## 🎮 Gameplay Overview

* Zombies advance through **multiple lanes**
* You **place and upgrade towers** to stop them
* **Boss enemies** unlock additional lanes
* Difficulty scales endlessly

---

## 🧠 Core Mechanics

### 🛣️ Lane System

* Up to **9 lanes**
* Unlocked progressively:

* Level 1 → 1 lane
* Level 2 → 3 lanes
* Level 3 → 5 lanes
* Level 4 → 7 lanes
* Level 5 → 9 lanes

---

### 👾 Enemy Types

| Type | Behavior |
| ------ | ----------------------------- |
| Walker | Balanced base zombie |
| Runner | Fast, low HP |
| Tank | Slow, high HP, attacks towers |
| Boss | High HP, unlocks new lanes |

---

### 🏗️ Towers

| Level | Type | Description |
| ----- | ------------- | ------------------------------ |
| 1 | Basic | Balanced attack |
| 2 | Rapid | Faster firing |
| 3 | Heavy | High damage |
| 4 | Explosive | Splash damage (AOE) |
| 5 | Laser *(WIP)* | Planned continuous beam weapon |

---

### 💰 Economy

* Earn **tokens** from kills
* Use tokens to:

* Upgrade towers
* Bosses give **bonus rewards**

---

### 🧟 Boss System

Bosses appear at increasing thresholds:

```
50 → 100 → 200 → 400 → ...
```

Defeating a boss:

* Unlocks more lanes
* Increases difficulty

---

## 🖥️ Screens

### ▶️ Start Screen

* Game title
* Instructions
* Start button

### 💥 Gameplay

* Real-time tower defense
* Lane-based combat
* Scaling difficulty

### ☠️ Game Over Screen

* Final stats:

* Kills
* Tokens earned
* Bosses defeated
* Retry or return to menu

---

## 🛠️ Tech Stack

* **Phaser 3** – Game engine
* **JavaScript (ES Modules)**
* **Capacitor** – Android packaging
* **Android Studio** – Build & APK generation

---

## 📱 Android Build

### Requirements

* Node.js
* Android Studio
* Java JDK

---

### Install dependencies

```bash
npm install
```

---

### Build web assets

```bash
npm run build
```

---

### Sync with Capacitor

```bash
npx cap sync android
```

---

### Open in Android Studio

```bash
npx cap open android
```

---

### Build APK

In Android Studio:

```
Build → Build APK
```

---

## 🎨 Assets

* Custom zombie sprites (walk + death animations)
* Tower sprites (5 levels)
* Explosion effects
* Forest/apocalypse background
* Custom splash screen and launcher icons

---

## 📦 Project Structure

```
src/
├── main.js
├── GameScene.js
├── StartScene.js
├── SummaryScene.js

android/
└── Capacitor Android project

public/assets/
├── zombies/
├── towers/
├── effects/
```

---

## ⚙️ Key Systems

* Lane-based enemy movement
* Enemy lane switching (random adjacent)
* Tower targeting with rotation delay
* Cooldown-based firing system
* Splash damage calculation
* Boss progression logic
* Token economy system

---

## 🚧 Roadmap

Planned features:

* 🔫 Laser Tower (Level 5)
* 🧪 More zombie types:

* Spitter (ranged)
* Mutant (mini-boss)
* 🌊 Wave system
* 🔊 Sound effects & music
* 💾 Save / High score system
* 📊 Game balancing improvements
* 🏆 Achievements

---

## 🐞 Known Issues

* UI scaling may vary across devices
* Balance tuning is ongoing
* Some animations may need optimization

---

## 🙌 Contributing

This project is currently in active development.
Feel free to fork, test, and suggest improvements.

---

## 📜 License

TBD

---

## 👤 Author

**Erwin Galang**

---

## 🎯 Final Note

BottomLine is built as a **fun, scalable tower defense foundation** with room for expansion into a full mobile release.

Survive as long as you can.
The zombies don’t stop.

OBBS Co.

Bykomende inligting