Head Gesture Sounds

# 🗣️ Head Gesture Sounds

**Head Gesture Sounds** is an immersive client-side Minecraft mod for Forge 1.20.1 that automatically detects player head nodding (Yes) and head shaking (No) via mouse movement deltas in real-time, playing custom vocal sound effects!

---

## ✨ Features

- 🟢 **Head Nodding (Yes)**: Moving your mouse up and down triggers the nodding vocal sound effect.
- 🔴 **Head Shaking (No)**: Moving your mouse left and right triggers the shaking vocal sound effect.
- ⚙️ **In-Game Settings GUI (`H` Key)**: Adjust Sensitivity, Cooldown, Sound Volume, and Audio Overlap modes directly in-game without restarting Minecraft.
- 📁 **External Custom Sound Importer**: Drop any custom `.ogg` files into `.minecraft/headgesturesounds/` (`yes.ogg` & `no.ogg`) to use your own voice or meme sounds instantly!
- 🎧 **Pro-Audio Engine**: Single-voice global channel lock (prevents audio overlap), dynamic OGG duration auto-sync, 2D vector motion filtering, and natural micro-pitch modulation.

---

## 🎮 How to Use

1. Press **`H`** in-game to open the configuration GUI.
2. Adjust your mouse sensitivity and sound volume to your liking.
3. Nod or shake your head in third-person or multiplayer to express yourself!