PositionalAudio
Positional Audio support via Mumble
About this mod Author’s original text
Mumble Positional Audio for Valheim
Not official or endorsed in any way by IronGate
This is a BepInEx plugin that feeds Mumble character and camera data from the
game to use in its positional audio system.
[Join the Discord!][discord]
[discord]:
Installation
Video walkthrough courtesy of Freedom.4x4
r2modman
Find the mod in "Online," click "Download." BepInEx should be installed as a
dependency. You're done!
It can also be found on.:
Manual
First, you're going to need BepInEx for Valheim. If you've already installed
another mod that uses it, you can skip this step. You can get it
here.
Follow the instructions. Note: if you're using Linux, you'll need to follow the
extra Steam setup described
here.
Once BepInEx is installed, head over to [Packages][packages] (or
) and grab the latest zip. Put the dll in
Valheim/BepInEx/plugins.
[packages]:
Usage
First start Mumble. If you haven't already, enable positional audio in
Configure -> Settings -> Audio Output -> Interface. You also need to check
"Link to Game and Transmit position" in Configure -> Settings -> Plugins ->
Options.
Mumble 1.4.x note: You'll also need to enable the "Link" from the
plugin list as it isn't enabled by default.
When Valheim starts with BepInEx, you should see a terminal with
Unity/BepInEx logs. You should see a line that says Mumble Link Loaded when
the plugin gets initialized. It won't do anything else until you join a game.
Once your character loads, you should see Mumble Shared Memory Initialized
in the logs. In the Mumble messages panel on the left side, you should now
see "Valheim Linked."
Now, two people on the same server should hear each others' voices coming
from their characters' location. You can also tweak the Positional Audio
settings in Audio Output to make it more realistic with regard to volume
dropoff over distance. Setting Minimum Distance to 1m, Maximum Distance to
50m, and Minimum Volume to 0% works well in my experience.
Global Voice Key
This is disabled by default. It's a bit of a hack. [A Mumble Shout/Whisper
shortcut is much better.][shout]
[shout]:
By default, T is bound to "Global Voice." This changes your mumble context
such that your voice (and everyone else's from your perspective) are no
longer directional. Use it if you want a "viking walkie-talkie" of sorts. It
can be configured via the the file generated in BepInEx/config/ file, or
with [BepInEx.ConfigurationManager][configmanager].
[configmanager]:
Server-side
Note: This section is entirely optional and applies to the Mumble server, not
Valheim
If you want to be able to enforce that mumble channel membership is
contingent on having the game linked, give [mumla][mumla] a shot. It's a
fairly simple Mumble bot that moves people around based on whether or not
they have a game linked for positional audio. People who have a game linked
will be automatically put in the corresponding channel for their game/server,
and people who don't have one linked will automatically be removed from those
channels. Admins are immune.
This will not work with the global voice key. Because it changes your
context, you'll just find yourself placed in a channel all by yourself, which
is the exact opposite of what you want. Set up a real mumble keybind instead.
[mumla]:
Troubleshooting
First, make sure BepInEx works. On Windows, you should get a terminal with
logs when you start Valheim. On Linux, you should see logs in
BepInEx/LogOutput.log. Next, make sure you see the startup message for
PositionalAudio.
If you have access to the mumble server and can enable grpc (might need a
dev
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: