# About AmbiMod
AmbiMod is a highly optimized, client-side ambient audio mod designed to breathe life into the silence of your Minecraft world. By tracking your surroundings in real-time, it seamlessly blankets your gameplay with rich, atmospheric audio loops that react dynamically to your location, the weather, and the time of day.

No more abrupt audio cuts or jarring transitions—AmbiMod utilizes an intelligent stability-checking system to ensure every soundscape blend feels natural and perfectly immersive.

---

# Key Features Revealed by the Environment

### 🌅 Dynamic Day & Night Cycles
Travel through Forests, Plains, and Swamps, and experience the world shift soundscapes automatically. Hear cheerful birds chirping during the bright morning hours, which smoothly transition into a calm, ambient cricket and night-wind atmosphere as night falls (from sunset to dawn).

### 🌊 Oceans & Whistling Winds
* **Coastal Inmersion:** Standing near or sailing through Ocean biomes activates immersive crashing wave loops.
* **The Open Breeze:** Wandering outside of wooded areas triggers a localized, atmospheric wind loop that emphasizes the scale of the Overworld.

### 🌧️ Responsive Weather Overrides
When a storm hits, the local fauna goes quiet. AmbiMod dynamically overrides background loops with a powerful, enveloping rain and thunder soundscape that perfectly captures the mood of a heavy downpour.

### 🏡 Smart Indoor Dampening (Acoustic Seal)
Stepping inside your house or a roofed shelter instantly alters the acoustics. The mod detects when you are indoors (blocked from the sky but not deep underground) and **intelligently dampens the active ambient volume to 30%**, creating a cozy, realistic acoustic barrier from the outside world.

### 👁️ Deep Cave Atmospheric Shift (Y < 40)
Descending into the dark depths of the world changes everything. Once you drop below **Y-level 40** into a deep cavern, AmbiMod triggers an ominous, echoing cave ambiance. To maximize the tension and isolate the underground experience, **the mod automatically mutes the vanilla game music** upon entry.

---

⚙️ Technical Details & Optimization

* **Smooth Transitions:** Built with a custom fade-in/fade-out mechanism and a stability threshold buffer to prevent audio spam or lag when crossing biome borders.
* **Purely Client-Side:** Runs completely on player ticks without altering server-side mechanics. Perfect for vanilla servers and massive modpacks alike!
* **Modpack Policy:** You are completely free to include AmbiMod in any modpack on CurseForge! No permission required.

First version: totally stable
IF you find any errors, don't hesitate to let me know in the comments or on my Instagram
Play preferably without Minecraft music in the caves

Ambi (Ambient Sounds)