Linux Modding Guide

Getting started on Beat Saber mods for Linux!

How to install mods

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.

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

Using Wine and Winetricks

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

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

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.

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.

DllOverrides

Have questions?

Visit the FAQ or drop by the #support tab in the discord!