# 🚀 CYBER JETPACK // Laser Flap Protocol

> A fast-paced, one-touch vector thrust arcade runner built with pure vanilla HTML5 Canvas and procedural Web Audio API.

---

## 🎮 How to Play

### Option 1: Direct File
Open [index.html](file:///Users/zameer/Documents/antigravity/games/cyber-jetpack/index.html) directly in any modern browser.

### Option 2: From the Master Arcade Hub
Open the master [Arcade Hub](../../index.html) and click **"LAUNCH GAME"** on the Cyber Jetpack card.

---

## ⌨️ Controls

| Action | Keyboard | Mouse / Touchscreen |
| :--- | :--- | :--- |
| **Fire Jetpack Thrusters** | **Hold** `Space`, `↑`, or `W` | **Hold Click or Screen Tap** |
| **Dive with Gravity** | **Release** all keys | **Release** click / tap |
| **Hover Precision** | Rapid micro-tapping | Rapid tapping |
| **Trigger Overdrive Rampage** | `Shift` or `E` (when meter is 100%) | Automatic / Shift |
| **Pause / Resume** | `P`, `Esc` | Click Pause button `⏸` |
| **Mute / Unmute Audio** | `M` | Click Sound button `🔊` |
| **Quick Restart** | `R` (on Game Over / Pause) | Click Restart button |

---

## 🌟 Game Mechanics & Features

- **One-Touch Vector Thrust Physics**:
  - Hold down to fire dual plasma thrusters with upward acceleration.
  - Release to enter gravity dive with terminal velocity clamps.
  - Smooth dynamic tilt angles match flight trajectory and velocity.
- **Dynamic Laser Matrix**:
  - **Static Laser Barriers**: Floor or ceiling suspended high-energy beams.
  - **Oscillating Laser Gates**: Sine-wave sweeping vertical beams.
  - **Spinning Di-pole Hubs**: $360^\circ$ rotating laser barriers.
  - **Intermittent Zappers**: Timed charging and lethal pulse phases.
  - **Homing Missile Drones**: Flashing warning reticles and supersonic tracking drones.
- **Close-Call Near-Miss Protocol**:
  - Skimming within inches of active lasers or missiles triggers a **"CLOSE CALL!"** bonus (+500 points) with Doppler swoosh SFX!
- **Data Shards & Combo System**:
  - Collect floating gold data diamonds in arcs, sine waves, and rings.
  - Consecutive collections build combo multipliers up to **x5** for massive score surges.
- **Cyber Upgrades & Power-Ups**:
  - 🛡️ **Cyber Shield**: Absorbs a fatal laser or missile impact, triggers a screen-wide EMP wave, and grants temporary invulnerability.
  - 🧲 **Data Magnet**: Lasts 10 seconds. Emits cyan magnetic lightning arcs that draw all data coins into your thrusters.
  - ⚡ **Hyper Warp Overdrive**: Supersonic rampage! Smashes all lasers and drones into glowing showers of sparks.
  - ⏱️ **Chronos Matrix**: Dilates time by 50%, allowing precision flight through tight laser corridors.
- **Procedural Audio Synthesizer**:
  - Continuous dual-layer jet engine thruster rumble (filtered white noise + sub-bass saw wave) that reacts dynamically to thrust inputs.
  - 130 BPM 4-on-the-floor synthwave music with driving kick, snappy snare, rolling bassline, and arpeggios.
  - Responsive retro SFX for near misses, coins, shields, warnings, and sonic booms.
  - 100% generated on-the-fly via Web Audio API (zero audio files needed).
- **Persistent High Scores**:
  - Automatically saves all-time high score, best distance, and total coins in browser `localStorage`.
