Skip to content

Installation and Setup

Jump to bottom
Christoph Honal edited this page May 1, 2021 · 21 revisions

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.
Clone this wiki locally