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!