This package contains art, text, or software code produced using generative AI.
This module was developed using an iterative, human-led design process supported by Generative AI.
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.
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.
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
- 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.
- Manifest URL:
https://github.com/GeanoFee/geanos-soundscape-realism/releases/latest/download/module.jsonwithin Foundry's "Install Module" window.
- Occlusion: Just place walls and lights as usual. Ambient Sounds will automatically interact with them.
- 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!
- 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+.