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!

INFO

You only need to install one of these mod managers. Installing multiple of these might conflict with each other making mods not work in game.

Using BSManager

DANGER

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

THIS IS CURRENTLY THE RECOMMENDED MOD INSTALLER AND DOWNGRADER.

1. To install BSManager in your specific distro, just follow the instructions within the wiki guide located here.

2. Open BSManager and install the latest Beat Saber version with the recommended label. Click on the recommended version then click on the Download button.

NOTE: It's recommended to mod a downloaded Beat Saber version instead of the original Steam version since the Steam might update Beat Saber and break some of the mods installed.

3. Once done downloading, you will see the downloaded version on the left side panel. Click on that version and navigate to the Mods tab.

NOTE: A popup that will appear to warn you about modding the first time you try to install mods, accept this to continue.

4. Select the mods you want to download and click on the Install or update button.

5. Start Beat Saber from BSManager. Your mods should be installed.

Using BeatSaberModManager

DANGER

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

1. Download BeatSaberModManager from Github and extract it to a directory on your system.

2. Run the executable.

3. Read the Intro, then navigate to the Mods tab and select the mods you want to install, finally press Refresh Mods.

4. Wait for your mods to finish installing.
5. Start Beat Saber. Your mods should be installed.

Using Beataroni

DANGER

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

1. Download Beataroni from GitHub and extract it to a directory on your system.

tar -xzf Beataroni-linux64-1.0.tar.gz

2. Run Beataroni-Linux.sh.
3. Type in your Beat Saber installation location and select the correct version then press continue.

4. Select the mods you want to install then press continue. You will need BSIPA (at the top of the list) as it is a dependency for all other mods.

5. Wait for your mods to finish installing.

6. Start Beat Saber. Your mods should be installed.

Using Wine and Winetricks

DANGER

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

2. Install the dotnet472 and d3dcompiler_47 packages using winetricks. If it asks to restart choose 'Restart later'.

winetricks dotnet472 d3dcompiler_47

WARNING

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

3. Download a mod installer and put it in your install folder.
   
4. Move your Beat Saber folder onto your desktop and open a terminal
5. Navigate to your Beat Saber folder in a terminal and run your installer in Wine.

cd (YourSteamLibraryFolder)/steamapps/common
cd "Beat Saber"
wine ModAssistant.exe

After running the command, you should then see this error window. Click ok.

4. Direct the installer to your Beat Saber directory

5. Install your mods. You should now have a Plugins folder.
6. Close out of the installer and put the Beat Saber folder back into common.

7. 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

DANGER

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.
3. When asked, select the Windows 10 ISO. and start it.
4. After you are finished installing Windows, download a mod installer inside the VM.
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.
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 more quickly
3. Paste "winhttp"="native,builtin" on the bottom below the others, and save the file.

Have questions?

Visit the FAQ or drop by the #pc-help tab in the BSMG Discord!