Sonar_Waves

# 🦇 Sonar Blind

> **"See with sound. Survive the silence."**

**Sonar Blind** is a stealth-survival arcade game built for **Game Off 2025** (Theme: WAVES). You are trapped in a pitch-black, infinite labyrinth. To see, you must emit sound waves. But be careful—you aren't alone, and the monster is listening

## 🌊 Theme Interpretation: WAVES

We interpreted the theme "WAVES" in three distinct ways:

1.  **Physics (Literal):** The core mechanic simulates radial sound waves (Sonar/Lidar). Visuals are only revealed when these physics waves bounce off rigid bodies.

2.  **Gameplay (Strategic):** The game is a balance of "Waves of Information" vs "Waves of Noise." Creating a wave allows you to see the map, but it also alerts the AI to your exact location.

3.  **Signal Processing:** We utilize a "decay" system where visual waves fade over time, forcing the player to rely on short-term memory of the wave pattern.

## 🎮 How to Play

The screen is black. You are blind.

1.  **Navigate:** Use your memory to move through the dark.

2.  **Ping:** Press **Space** to send a Sonar Wave. This reveals walls and the enemy, but **the enemy will hear you and hunt you.**

3.  **Distract:** Click the **Mouse** to throw a Decoy Rock. When it hits a wall, it creates a sound wave *there*, tricking the monster into running the wrong way.

4.  **Escape:** Find the **Blue Zone** to advance to the next, harder level.

### Controls

| Key | Action |

| :--- | :--- |

| **W / A / S / D** | Move Player |

| **SPACEBAR** | **Sonar Ping** (Reveals map, attracts Enemy) |

| **MOUSE CLICK** | **Throw Decoy** (Distracts Enemy) |

## 🌟 Key Features

* ** procedural Audio:** No MP3 files were used. All sound effects (pings, hums, impacts) are generated in real-time using oscillators.

* **"Hearing" AI:** The enemy creates a mental map of the level based on sound. It tracks where you *were* when you last made a noise.

* **Infinite Levels:** The physics world regenerates procedurally every level, increasing in density and difficulty.

* **Visual Decay:** A custom fading rendering system that mimics the afterglow of a sonar screen.

## 🛠️ Tech Stack

* **[p5.js](https://p5js.org/):** Rendering and Game Loop.

* **[Matter.js](https://brm.io/matter-js/):** 2D Physics engine for collision detection and wave simulation.

* **[p5.sound](https://p5js.org/reference/#/libraries/p5.sound):** Real-time audio synthesis.

## 🚀 Installation & Running

This game is a static web application contained in a single file.

1.  Clone this repository.

2.  Open `index.html` in any modern web browser (Chrome, Firefox, Edge).

3.  Click the screen to initialize the Audio Context.

## 🧠 Tips for Survival

* **Don't Spam Spacebar:** Constant pinging makes you an easy target. Ping once, memorize the path, and move in the dark.

* **Use the Corners:** Throwing a decoy into a corner creates a loud noise that keeps the monster busy for longer.

* **Watch the Red:** The enemy is invisible, but if you ping it, it glows red. If you see a `!` on the screen, run!

---