Geano's SoundScape Realism

Immersive Audio Engine for Foundry VTT

Geano's SoundScape Realism overhauls the FoundryVTT audio engine to provide realistic, real-time acoustic simulation. By leveraging the Web Audio API and multithreaded Raycasting, it delivers studio-quality environmental effects without performance cost.

🌟 Key Features

🧱 True Acoustic Occlusion

Gone are the days of binary "on/off" wall blocking.

• Muffled Sounds: Audio sources behind walls aren't just silenced; they are muffled using a dynamic LowPass filter.
• Raycasting Engine: Uses a dedicated Web Worker to calculate obstruction in real-time without lagging the main game thread.
• Smart Material Logic: Determines how much "sound" leaks through doors vs. solid walls.

🏛️ Environmental Reverb Zones

Bring your scenes to life with distinct acoustic signatures.

• Region Integration: Simply create a Drawing/Region and assign a SoundScape Preset in the configuration tab.
• Procedural Audio: No external files required! The engine generates cached Impulse Responses on the fly using "Colored Noise" algorithms (White, Pink, Brown).
• Presets Include:
  • Small Room, Large Hall, Cathedral
  • Forest, Canyon, City
  • Cave, Deep Dungeon

🎚️ Enhanced Volume Control

• Custom Easing: Replaces Foundry's default volume logic with a smooth, distance-based linear falloff.
• Auto-Config: New Ambient Sounds automatically have "Constrained by Walls" unchecked, allowing SoundScape's superior occlusion engine to take over immediately.

🚀 Installation

• Manifest URL: https://github.com/GeanoFee/geanos-soundscape-realism/releases/latest/download/module.json within Foundry's "Install Module" window.

🎮 Usage

1. Occlusion: Just place walls and lights as usual. Ambient Sounds will automatically interact with them.
2. Reverb:
   • Create a Region (Draw Tool).
   • Double-click to open Region Configuration.
   • Go to the "SoundScape" tab.
   • Choose a Reverb Preset (e.g., "Stone Cave") and adjust the Intensity.
   • Walk your Token into the zone and listen!

🔧 Technical Highlights

• Web Audio API Graph Injection: Safely injects nodes into Foundry's audio chain (GainNode -> OcclusionFilter -> ReverbSend).
• Zero-Latency Worker: Occlusion math runs on a separate thread to ensure 60FPS canvas rendering.
• Reactive UI: Native hook integration compatible with Foundry V12+.

---

License

This module is licensed under the MIT License.