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.

Using BeatSaberModManager ​

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 ​

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

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

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 ​

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

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

winetricks dotnet472 d3dcompiler_47

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

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 ​

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.

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!