Installation and Setup - StarGate01/AmongUs-Mumble GitHub Wiki
Installation
On Windows, use the Installer to install, update or remove the mod.
Alternatively, download the latest compatible release from https://github.com/StarGate01/AmongUs-Mumble/releases/ , or build it yourself. Drop the winhttp.dll
file into the same directory as the Among Us.exe
program (see this explanation if you are confused).
Windows
Install the Mumble client from https://www.mumble.info/downloads/ . Install the game using Steam.
If you did a manual installation, and you don't have the Visual C++ Redistributable for Visual Studio 2015
installed, get it from https://www.microsoft.com/en-us/download/details.aspx?id=48145 . Choose the x86 version, even if your PC is 64 bit. The installer tool automatically does this step for you.
If the path Mumble was installed to is not C:\Program Files\Mumble\mumble.exe
(if you installed the 64 bit version), you have to specify it by editing the configuration file using an editor or the in-game GUI.
You can also change the Steam launch options of Among Us, for example like this: --mumble="C:\Program Files (x86)\Mumble\mumble.exe"
if you installed the 32 bit version on a 64 bit system.
Linux
Please note that Linux support has a few known problems. See below for details.
The installer does not work on Linux, so you have to install the mod manually.
Install the Mumble client using your package manager (e.g. $ sudo apt-get install mumble
) or follow the instructions on https://www.mumble.info/downloads/ .
Install Steam and enable "Steam Play" for all titles (Steam -> Settings -> Steam Play). We use Steam Play (Proton 5.0-10) as compatibility layer. Please note that starting with Proton 5.13, the Steam Linux Runtime is enabled. This sandbox prevents any RPC calls to Mumble. To work around this issue (until Valve fixes it), either use Proton 5.0 or use a tool like https://github.com/frostworx/steamtinkerlaunch to disable the SLR.
Then install the game using Steam. Depending on your GPU (Vulkan support), you might have to set these launch options (right click on the game entry in your library -> Properties -> General) for the game:
PROTON_NO_ESYNC=1 PROTON_USE_WINED3D=1 %command%
Install some requirements using your package manager:
libpng12
(Might not be needed depending on your distribution)winetricks
Update the library cache:
$ sudo ldconfig
Install Protontricks from https://github.com/Matoking/protontricks, choose the installation method according to your distribution.
Install the VC Redistributable into the emulation layer of the game:
$ protontricks 945360 vcrun2015
Start the WINE configuration tool:
$ protontricks 945360 winecfg
Add to the Libraries->DLL overrides
section:
winhttp
ucrtbase
api-ms-win-crt-convert-l1-1-0
Start the game once and exit it again to generate the initial configiration file. Configure the mod using the ProximityConfig.ini
file (in the same directory as Among Us.exe
and winhttp.dll
, usually ~/.steam/steam/steamapps/common/Among Us/
):
no-directx=true
mumble="/usr/bin/mumble"
wine-uid=1000
Adjust the values to match the output of the commands $ which mumble
and $ id -u
. We also recommend setting no-log-console=true
, because the Wine console tends to be unstable.
To see the log output of the mod without a working console, check the ProximityLog.txt
file.
Known Linux-specific issues
- The sandbox of the Steam Linux Runtime precents RPC calls, see above.
- The overlay does not work because the DirectX hooks fail when using the OpenGL-based WinedD3D (we recommend setting
no-directx=true
). DXVK / Vulkan support is being evaluated. - In Proton 5.0, printing to the console does not work due to a bug in Wine: https://bugs.winehq.org/show_bug.cgi?id=22216 . Use a more recent version of Proton or don't use the console.
- Minimizing or maximizing the console window crashes the game.
If you have issues and want to debug Wine, add WINEDEBUG="+seh,+loaddll"
(or any other debug channel, see https://wiki.winehq.org/Debug_Channels) to the game launch options. Then check the content of ~/steam-945360.log
.
Mod configuration
Use the generated file ProximityConfig.ini
for configuration. The default state is this:
; AmongUs-Mumble
; Mumble executable path
mumble="C:\Program Files\Mumble\mumble.exe"
; Path to the log file
log-file-path="ProximityLog.txt"
; Disable logging to the console
no-log-console=false
; Disable logging to a file
no-log-file=false
; Disable the configuration button overlay
no-overlay=false
; Disable the overlay DirectX hooks
no-directx=false
; Log verbosity
log-verbosity=3
; Wine UID
wine-uid=1000
; Set ghost voice mode
; 0 = Purgatory
; 1 = Spectate
; 2 = Haunt
ghost-voice-mode=0
; Enable directional audio
directional-audio=true
; Imposter Radio Hotkey
imposter-radio-key=84
Every configuration optuion can also be set via the command line, using the syntax --config-option-name=value
. Alternatively, you can also set these options using the in-game GUI.
Mumble configuration
Install Mumble (Tested: Version 1.3.3) if you have not already: https://www.mumble.info/downloads/ .
In Mumble, the proximity audio options have to be enabled and configured beforehand:
- Run
Configure -> Audio Wizard
and configure your Headset - Enable
Plugins -> Options -> Link to Game and Transmit Position
- Enable
Plugins -> Plugins -> Link v1.2.0
if its not already (note that the version can differ) - Enable
Audio Output -> Interface -> Positional Audio
- Set
Audio Output -> Positional Audio -> Minimum Distance
to 1.0m (lowest setting) - Set
Audio Output -> Positional Audio -> Maximum Distance
to something between 2m and 6m - or even more, according to your preferences - Set
Audio Output -> Positional Audio -> Minimum Volume
to 0% (lowest setting)
Then run the game and observe the output of the console window (if you run the game in full screen, you might want to tab out or switch to windowed mode). Ensure that the mumble binary path is correct. Mumble should notify when the game connects.
Other Notes & Tips:
- To uninstall, just delete/move
winhttp.dll
or use the installer tool.