ESP32 OLED Retro Arcade Game

A standalone, handheld 8-bit style obstacle avoider arcade game built using an ESP32 microcontroller and a 0.96-inch monochrome I2C OLED display. The project features physics-based flap mechanics, procedural obstacle generation, real-time audio feedback via a piezo buzzer, and custom state-driven animations.

---

Features

• High-Speed Display Driver: Runs an optimized 60 FPS rendering loop utilizing the ESP32 hardware I2C bus clocked at 400 kHz.
• Physics & Hitbox Engine: Implements smooth vertical gravity, capped terminal velocity, and precision collision detection.
• Audio Feedback: Real-time frequency-based sound effects for jumps, scoring milestones, and collisions.
• Protected HUD Overlay: Fixed status bar with independent screen masking to ensure scores remain clearly visible as obstacles scroll.
• Multi-Stage Game States: Dedicated screens for Start Menu, Active Gameplay, Collision Animation, and Game Over.

---

Hardware Components

| Component | Specification | Connection / Pin | | :--- | :--- | :--- | | Microcontroller | ESP32 Dev Module (30-pin / 38-pin) | USB Powered | | Display | 0.96" I2C OLED (SSD1306, 128x64) | SDA -> GPIO 21, SCL -> GPIO 22 | | Control Button | Tactile Push Button | GPIO 19 (Internal Pull-Up) -> GND | | | Piezo Buzzer | Positive -> GPIO 18, Negative -> GND | | | Breadboard & Jumper Wires | Power Rails (3.3V / GND) |