# Linux Modding Guide

# Preface

Most Beat Saber mod installers weren't built to run on Linux, so we have to do some small things to get it to work on Linux. It is very similar to a Windows install, but you will need some workarounds.

WARNING

Using mods in Linux isn't supported by mod developers, so you might encounter bugs!

# Using Wine and Winetricks

WARNING

Run the game at least once before trying to mod the game! This applies to reinstalling your game too.

Make sure you have Wine and Winetricks installed before starting.

  1. Make a new 32-bit Wine prefix.
$ export WINEARCH="win32"
$ export WINEPREFIX=~/.winemods
$ wineboot -u
  1. Install the dotnet472 package using winetricks. If it asks to restart choose 'Restart later'.
$ winetricks dotnet472

dotnet472

WARNING

There will be multiple install prompts you will have to go through, this is normal!

  1. Download a mod installer and put it in your install folder.
    Install Folder
  2. Move your Beat Saber folder onto your desktop and open a terminal
  3. Navigate to your Beat Saber folder in a terminal and run your installer in Wine.
$ cd Desktop
$ cd "Beat Saber"
$ wine BeatSaberModManager.exe

BeatSaberModManager

  1. Direct the installer to your Beat Saber directory BeatSaberModManager
  2. Install your mods. You should now have a Plugins folder.
  3. Close out of the installer and put the Beat Saber folder back into common. Beat Saber folder
  4. Start Beat Saber and check if the mods are installed. If they aren't you may need to do a DLL override

# Using a Virtual Machine

WARNING

Run the game at least once before trying to mod the game! This applies to reinstalling your game too.

Make sure you have VirtualBox installed before starting.

  1. Download a Windows 10 ISO
  2. Make a new Windows 10 virtual machine and start it. VirtualBox
  3. When asked, select the Windows 10 ISO. and start it. VirtualBox
  4. After you are finished installing Windows, download a mod installer inside the VM. ModAssistant Install
  5. Make a shared folder by going to 'Devices > Shared Folders > Shared Folder Settings...'. Make a new shared folder with the common folder /.local/share/Steam/steamapps/common/ and turn Auto-mount on. Shared Folder Shared Folder
  6. Run the mod installer you have downloaded, and manually select your Beat Saber folder, then install your mods.
  7. Exit the VM and start Beat Saber. Your mods should be installed. If they aren't, go to DLL Override

# DLL Override

Wine doesn’t use DLLs the same way Windows does, so you have to change a few things to make the IPA injection work.

DANGER

Messing with registry files can be dangerous, make sure you don't touch anything besides what the guide tells you to.
If you messed up the registry file, either verify your game files or reinstall Beat Saber after backing up your files.

  1. Navigate to /.local/share/Steam/steamapps/compatdata/620980/pfx/ and open user.reg
  2. Inside the file, navigate to [Software\\Wine\\DllOverrides]. Try Ctrl + F and type DllOverrides to get there quicker
  3. Paste "winhttp"="native,builtin" on the bottom below the others, and save the file.

DLL Overrides

# Have questions?

Visit the FAQ or drop by the #support tab in the BSMG Discord!