# 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 Beataroni

WARNING

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

  1. Download Beataroni from GitHub (opens new window) and extract it to a directory on your system.
tar -xzf Beataroni-linux64-1.0.tar.gz
  1. Run Beataroni-Linux.sh.
  2. Type in your Beat Saber installation location and select the correct version then press continue.

Beataroni Beat Saber Installation and Version Select Screen

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

Beataroni Mod List Screen

  1. Wait for your mods to finish installing.

Beataroni Log Screen

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

# 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 (opens new window) and Winetricks (opens new window) installed before starting.

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

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 (opens new window) installed before starting.

  1. Download a Windows 10 ISO (opens new window)
  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 (opens new window)!