If you have not already, go to Preparations and follow those steps. You should now have Developer Mode enabled and SideQuest Advanced installed on your PC.
It is recommended to disable the proximity sensor of your quest in the SideQuest device settings. This prevents it from going into sleep mode during the modding process. Alternatively you can tape up the sensor between the lenses.
Make sure you do not have multiple accounts an your Quest!
Modding currently does not work with multiple accounts. You will need to temporarily remove all secondary accounts before modding the game. You can add them back once the modding process is completed.
Take a USB cable and connect your Quest to your PC. Inside your Quest, two dialogs should pop up (if you are doing this step for the first time). One dialog asks for permission for the PC to access the Quest's files. Click "Accept". The other dialog asks if you want to trust the computer. Click "Always Trust" so it does not show up again.
Once you have done that, open SideQuest and look at the top left corner. If there is a green dot, everything is working and your Quest is connected.
If it is red, try the following troubleshooting options:
Navigate to the SideQuest start page within the app. You should find a search field there. Type "BMBF" and press Enter.
In the search results, you should see a program with a Unicorn as the icon. Click the download/sideload button. You will see a red notification at the top of the app indicating that the app is being installed. Once the installation is complete, a green notification will appear in the top right corner.
Launch Beat Saber and look at your feet. There should be a version number displayed. If it matches the currently moddable version, you can skip the downgrading step. You can find the latest moddable version information in the BSMG Discord.
Open SideQuest. In the top right of the navigation bar, click the icon with nine squares. This will display all the apps currently installed on your headset. Locate Beat Saber and click the settings icon on the right.
On the page that opens, there should be a button to uninstall Beat Saber. Click it and wait for SideQuest to confirm the game has been uninstalled.
Visit OculusDB and click "Download Latest Moddable Version." If you encounter a 404 error page, you need to log in with your Meta account here. Save the downloaded APK file to a location where you can easily locate it.
Open SideQuest again and click the Install APK icon (a box with an arrow pointing downward). An explorer window will appear. Select the APK file you downloaded from OculusDB. Once the installation is complete, you can disconnect the Quest from your PC.
Launch Beat Saber and check if the version number at your feet now matches the latest moddable version. If not, repeat the steps mentioned above.
Go to the app menu in your headset. In the top right corner, you should see a filter option where you can select "unknown sources." If "BMBF" does not appear there, try installing it via SideQuest again.
Open BMBF. It might take up to 1-2 minutes to load. It will prompt you for folder permissions. If it does, click the "Use This Folder" button at the bottom. Do not navigate to another folder!
Follow the steps provided by BMBF. It may also ask for app permissions. If it does, enable the slider and click the back arrow in the top left corner.
Installing Mods, Custom Songs, Models and external sources
Regardless of what you install using BMBF, remember to sync it with Beat Saber by clicking the "Sync" button in the top right corner.
You can install mods directly within BMBF. Before installing any other mods, it is recommended to install CrashReporter first. CrashReporter is a mod that uploads crash reports to this site, allowing you to view logs if your game crashes and you are unable to start it again.
Once you have installed CrashReporter, start your game. In the main menu, press the settings button, then choose "Mod Settings" and select "QuestUI" on the left. Click on "CrashReporter." A menu will appear where you can configure CrashReporter. Enable full log and set a user ID that you can remember.
In the main menu of Beat Saber is a "More Songs" button in the menu on the left. There you can download every Song listed on BeatSaver. It is recommended to install the "BetterSongSearch" mod since it provides more search features.
Installing External Sources via BMBF's Web Interface
We strongly advise against installing mods that do not originate from official mod sites. Unverified mods could potentially contain viruses. We do not provide support for any such mods.
PC Mods Do Not Work on Quest!
Only mods with the ".qmod" extension work on Quest. Mods downloaded from sources like BeatMods will not work.
BMBF provides the option to upload files from a PC. To open the web interface, first ensure that your Quest and PC are connected to the same network; otherwise, it will not work. Navigate to the "Tools and Options" tab in BMBF. You will find an IP address that you can enter into your browser (e.g., http://10.0.0.2:50000). Make sure to use http: and not https: at the beginning.
If you encounter issues while modding Beat Saber, you can always seek help in the BSMG Discord. You can ask any questions in the quest-help channel. Please note that we are all volunteers and there is no on-call support. So, if no one responds immediately, please be patient. In addition, here are a few troubleshooting steps:
This is most likely due to having an outdated BMBF App, grab the latest BMBF Release by downloading it from SideQuest. If the BMBF version for your Beat Saber is not there then please wait a while for the unicorns to update BMBF.
If you can not press the Play button on a map press the question mark at the top right to see which mods are missing and install them.
If your BMBF is on the latest version and mods wont be enabled in game, uninstall Beat Saber with the uninstall BS button in the BMBF Tools tab then reinstall and remod.
After installing mods, be sure to press the "Sync" button in BMBF. Additionally, not all mods have visible effects. Some mods place their settings on the left side of the main menu, while others can be found in the mod settings under Quest UI.