This guide is for both Quest 1, Quest 2, and Quest 3.
Nobody has yet been banned for modding.
By choosing to use mods, you understand that:
You may experience problems that don't exist in the vanilla game. 99.9% of bugs, crashes, and lag are due to mods.
Mods are subject to being broken by updates and that's normal - be patient and respectful when this happens, as modders are volunteers with real lives.
Beat Games aren't purposefully trying to break mods. They wish to work on the codebase and sometimes this breaks mods, but they are not out to kill mods.
Do not attack the game developers for issues related to mods, and vice versa - modders and game developers are two separate groups. Just don't be a jerk ok.
I watched a video tutorial on YouTube, but I got stuck/it didn't work. What gives?
We at BSMG strongly advise against using any video tutorials for modding. Often, we find that they are either outdated or contain incomplete, erroneous, or straight up incorrect information.
Instead, you should follow the written guides here on the wiki or seek out help in the BSMG Discord.
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.
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.
To restore your data, open SideQuest and connect your Quest to your PC. Using the SideQuest file explorer, take the 3 files you saved from the Backup Save Data using SideQuest steps AvatarData.dat, PlayerData.dat and settings.cfg and put them in the sdcard/Android/data/com.beatgames.beatsaber/files folder.
BMBF is generally easier to understand for beginners with a simpler UI compared to QAVS, but lacks a built-in downgrading option. If you use BMBF to mod, you will need a PC every time you update Beat Saber.
QAVS is recommended for people who are using an Android device or don't have access to a computer at all times. It has built-in downgrading, which means you don't need to use a PC or phone every time you want to update Beat Saber to the latest moddable version.
QuestPatcher is a GUI based mod installer for any il2cpp unity app on the Oculus Quest that runs on Windows, Linux, or macOS.
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.