gitmyhub

geanos-soundscape-realism

JavaScript ★ 18 updated 18d ago

Advanced environmental audio engine for Foundry VTT. Features real-time acoustic occlusion, procedural reverb zones, and multithreaded raycasting for studio-quality immersion without performance impact.

A Foundry VTT plugin that adds realistic audio physics to tabletop RPG sessions, walls muffle sound instead of silencing it, and game masters can assign reverb presets like Stone Cave or Cathedral to map regions that shift the audio as players move through them.

JavaScriptFoundry VTTWeb Audio APIsetup: easycomplexity 2/5

Geano's SoundScape Realism is a plugin for Foundry VTT, the browser-based platform used to run tabletop roleplaying games online. The plugin replaces how Foundry handles sound, adding physics-based audio behavior so that players and game masters hear their virtual environment more realistically.

The main change is acoustic occlusion. In standard Foundry, a wall either blocks a sound completely or lets it through. This plugin instead filters sound through walls using a low-pass audio filter, making sounds behind walls come through as muffled rather than silent. A separate background calculation thread handles the math for figuring out what is blocked and by how much, so the game itself does not slow down while the audio system works.

The second major feature is reverb zones. A game master can draw a region on the map, open its settings, and pick an acoustic preset from a list that includes options like Stone Cave, Cathedral, Forest, Canyon, and several others. When a player's character token walks into that zone, the audio shifts to match. The reverb effects are generated in real time from noise algorithms, so no extra audio files need to be downloaded or installed.

The plugin also adjusts how sound volume falls off with distance, replacing Foundry's default curve with a smoother linear falloff. New ambient sounds placed on a map are automatically configured to skip Foundry's built-in wall-blocking logic and use the plugin's version instead.

Installation is done through Foundry's standard module installer using the manifest URL from the GitHub releases page. The plugin requires Foundry V12 or later and is released under the MIT license.

Where it fits