# ESP32 LED Boss Fight

<p align="center">
  <img src="assets/hero.png" alt="ESP32 LED Boss Fight hero image" width="450">
</p>

A real-time embedded game system prototyped in Python and implemented on ESP32 using WS2812B LEDs, button input, and event-driven audio.

---

## Prototype gallery

<p align="center">
  <img src="gallery/prototype-02.jpg" alt="Prototype image 1" width="16%">
  <img src="gallery/prototype-03.jpg" alt="Prototype image 2" width="16%">
  <img src="gallery/prototype-04.jpg" alt="Prototype image 3" width="16%">
  <img src="gallery/fun-shot-cat.jpg" alt="Prototype image 3" width="8%">
</p>

---

<p align="center"><strong>See the project in action on social media! Support me if you found this project fun!</strong></p>

<p align="center">
  <a href="https://vt.tiktok.com/ZSHvuQUue/">
    <img alt="TikTok" src="https://img.shields.io/badge/TikTok-000000?style=for-the-badge&logo=tiktok&logoColor=white">
  </a>
  <a href="https://www.instagram.com/reel/DX0R08eD1mK/?igsh=YzhlYWJyamJ4bzRu">
    <img alt="Instagram" src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white">
  </a>
</p>

---

## Hardware preview
<h6 align="center">(I swear there’s an ESP32 under there)</h6>

<p align="center">
  <img src="hardware/wiring-preview-01.jpg" alt="Wiring preview" width="200">
  <img src="hardware/wiring-preview-02.jpg" alt="Wiring preview" width="200">
</p>



---

## Quick links
- [Firmware](firmware/esp32_led_boss_fight.ino)
- [Hardware](hardware/README.md)
- [Gallery](gallery/README.md)
- [Web Demo](web-demo/README.md)

---

## Highlights
- Embedded systems development
- Real-time game logic
- Collision handling
- Event-driven programming
- Audio feedback systems
- Hardware input integration
- LED rendering and interaction
- Rapid prototyping from Python to embedded hardware
- Technical debugging and iteration

---

## Project overview
This project started as a Python gameplay prototype and evolved into an ESP32-based interactive game using a 100-pixel WS2812B LED strip, three color-coded buttons, and buzzer-based sound feedback.

The game combines:
- boss and minion wave logic
- color-matched projectiles
- real-time collision handling
- progressive difficulty scaling
- event-based sound cues
- simple but readable state-based architecture

---

## Core systems

### State machine
The game is organized around three runtime phases:
- `hiatus`
- `spawning`
- `playing`

This structure keeps gameplay flow clear, modular, and easier to debug.

### Collision system
Projectile positions are checked against minion positions in real time.

Behavior includes:
- successful hit when projectile color matches enemy color
- enemy removal on valid hit
- penalty when colors do not match

### Difficulty scaling
The game becomes more difficult by increasing enemys speed after each cleared wave.

This creates:
- faster pacing
- increased pressure
- escalating challenge with the same control scheme

### Audio feedback
The buzzer is used for gameplay events including:
- shooting
- valid hit
- failed hit or miss
- boss intro
- victory

---

## Technical skills demonstrated

### Programming
- C++
- Python
- JavaScript
- HTML
- CSS

### Embedded and hardware
- ESP32
- Arduino-style firmware development
- WS2812B LED control
- button input handling
- buzzer audio output

### Engineering and design
- real-time systems thinking
- state-based logic
- collision design
- interaction design
- iterative prototyping
- hardware/software translation

---