Quest Modding using ModsBeforeFriday

This guide is for Quest 1, 2, 3, 3S and Pro headsets only!

WARNING

Modding your game will disable Official Multiplayer as well as viewing and uploading scores on the base game leaderboards.

If you would like to play modded multiplayer, you need the mods, Beat Together and MultiplayerCore, which allows for cross-play between PC and Quest and for custom songs to be used.

Bear in mind that these are not core mods, so they may not be available on your desired version yet!

You can check the BSQMods repo or MBF to see if these are available for your version.

To get leaderboards on custom songs and to be able to get Performance Points (PP) from ranked songs you need the ScoreSaber or BeatLeader mod.

You can grab ScoreSaber from their website linked above.

BeatLeader can be found on MBF or the BSQMods repository.

Requirements

To begin, make sure that you have the latest version of (vanilla) Beat Saber on your Quest.

MBF will automatically downgrade this version to the latest moddable version.

Quest 1

Quest 1 requires a different flow: ModsBeforeFriday (MBF) can update/patch Quest 1 up to Beat Saber 1.40.8 (last officially supported Quest 1 version is 1.37.101).

If you previously modded (or switched release channels) and your version doesn’t match what MBF expects, make sure you are not on the legacy release channel.

How to leave the legacy release channel:

1. Go to Beat Saber store page
2. Log in with the account used on your headset.
3. Scroll down to Version + release notes (you can use Ctrl+F on the page to find it)
4. Open the version dropdown and select LIVE.
5. Reinstall Beat Saber on your headset, then return to this guide.

Browser Support

MBF needs an up-to-date Chromium browser to work. For example:

• Microsoft Edge (included with Windows)
• Google Chrome, etc..

It will not work on Firefox or Safari!

You will be warned if your browser is out of date or incompatible.

Modding the Game

To get started, head to the ModsBeforeFriday website then:

1. Plug your Quest into your PC with a USB cable.
2. Click the Connect to Quest button. You will be presented with a dialog that looks like this:

NOTE

This dialog may look different if you're using a different browser!

3. Select your device, and click Connect, then wait a few seconds. Your screen should look like this:

NOTE

If you do not already have the latest moddable version of Beat Saber, you will prompted to downgrade the game.

This happens automatically, just follow the guide as normal!

4. Click "Mod the app" and wait until it finishes.

WARNING

Do not unplug your cable while the game is being modded!

5. You're all done!

You can now install custom songs inside the game using the SongDownloader mod, which is installed by default.

Adding additional mods

MBF has a built-in mod browser that you can use to add additional mods.

Simply select "Add Mods" in the main menu and hit "Install" on any mods you want!