PositionalAudio

v3.1.0·Updated 2023-06-13

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

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. 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.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. 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.

Dependencies

Install these first, or the mod will not work:

denikson-BepInExPack_Valheim

File & checksum

Filename
PositionalAudio-3.1.0.zip
File size
28.7 KiB