Positional audio framework
A framework mod that allows modders to define background sounds and music that play when the player is near. Used with Content Patcher.
Screenshots 1 screenshots
About this mod Machine translation
A framework mod that allows modders to define background sounds and music that play when the player is near. Used with Content Patcher.
Positional Audio 🎵
Module Introduction ✨
This is a framework mod that provides modders with the tools to define the sound effects and music that play when the player is near a specific location. It works similarly to waterfall sounds, mine knocks, Pirate Bay music, and more from the original game: the closer you are to the source, the louder it gets, while the game's normal background music fades, making it easier to hear area sound effects.
---
How to use 🎮
**As a user:**
- Requires SMAPI 4.1.10+ and Stardew Valley 1.6.15+
- Install this mod like any other mod (unzip to the Mods folder)
- Other mods that depend on this mod will work automatically
**As a modder:**
- This mod provides a data resource that you can edit to add audio entries
- It is currently recommended to use Content Patcher to implement this function
- C# and SMAPI content API support may be added in the future
📖 **Detailed User Guide:** Author's Guide
---
Special thanks 🙏
Thanks to Dolphin Is Not a Fish for your immense patience.
---
Source code and release image 🔗
📂 **GitHub repository:** Positional Audio
Install & use Install: SMAPI mod (Stardew Valley standard)
- Install SMAPI first (Stardew Valley's mod loader): download it from smapi.io, run 'install on Windows.bat' and pick your game folder.
- Unzip the archive from playbuff and find the folder that contains manifest.json — that folder is the mod.
- Copy that whole folder into Stardew Valley/Mods/.
- Launch the game through SMAPI (run StardewModdingAPI.exe or set it as the launch option). The console before the title screen lists each mod's load result.
Cheat-style tools may not need SMAPI — unzip and run them as the readme describes. Back up your save before editing it; SMAPI lists failed mods in its console.