Whether you’re new to modding Beat Saber, or you need to reinstall mods after the latest Beat Saber update (with the Crab Rave song), and realized your Mod Manager has stopped working, these instructions to add custom songs in Beat Saber should have you swinging your arms and chopping blocks to your favorite beats in no time.
Note: Before using these methods you will need to have already installed and launched Beat Saber at least once, so that it will create some necessary files and sub-directories.
Option 1: Use new automatic installer Beat Saber Mod Manager (recommended)
Modsaber.org and the ModSaber Mod Manager shut down at pretty much the same time the Beat Saber update was released, but a new community-built fork from the Beat Saber Modding Group has sprung up to replace it. You can get the latest version on github at https://github.com/beat-saber-modding-group/BeatSaberModInstaller/releases/ This is a patched version, meant as a replacement for Beat Saber Mod Manager by Umbranoxio. It has been adapted to work with https://beatmods.com instead of the now defunct https://modsaber.org
Download the latest release and run it from anywhere. Upon opening you will probably run into an error that says “We couldn’t seem find your Beat Saber installation.” Just click okay and browse to the correct folder: C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\ if you bought Beat Saber from the Oculus store, or C:\Program Files (x86)\Steam\steamapps\common\Beat Saber\ if you bought it from Steam.
Check the boxes for all the mods you want, then click Install/Update, and be sure to check out the SyncSaber mod as well ass all the pre-selected requirements.
Option 2: Manually download and install Mods
Download zip files from the new mods repository https://beatmods.com/#/mods and extract the .dll files to your Beatsaber Pluggins directory. For Rift users the default directory is C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\Plugins. If you purchased the game through steam the Plugins folder should be in C:\Program Files (x86)\Steam\steamapps\common\Beat Saber\ by default. Make sure to get all of the required core and libraries mods listed below.
Required core mods
- BSIPA (new mod loader)
- BeatSaver Downloader
- Custom UI
- Ini Parser
- BS Utils
- Stream Core
- Mapping extension (used by some songs for new unique block placements)
Now that you have your mods installed its time to add some custom songs
Add songs using SyncSaber (my preferred method)
Automatically download songs that you have bookmarked at bsaber.com with the SyncSaber Mod. To use SyncSaber you need to install the mod and link to a Beast Saber account. I recommend this method because if you ever have to reinstall, then getting all of your favorite songs back is much easier than manually picking and choosing again.
Launch Beat Saber and enter your bsaber.com username in settings.
or you can edit the modprefs.ini in C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\UserData. If you prefer to just edit the .ini file enter your username on the line that says BeastSaberUsername=
Note: SyncSaber checks your bookmarks when you launch Beat Saber, so you may (probably) have to close and restart Beat Saber before the automatic downloads begin.
Add songs individually using Song Browser
You should see a “MODS” button below the main menu in Beat Saber. Click on that and then choose “More Songs.”
This mod allows you to view and add songs in the game. Browse, search and download to your hearts content.
Where are my custom songs?
There’s a new interface that separates content into different packs that you see below the songs list in Solo or Party Mode. Scroll to the right until you see custom maps.
That’s it, just browse through your songs and get ready to sweat to some sick beats.
Bonus song management method: BeatDrop (includes playlists function)
A handy tool available at https://bsaber.com/beatdrop/ allows you to manage custom songs outside of VR. BeatDrop has the ability to create and manage playlists (I use this feature to favorite songs for different players).
A redesigned Beatdrop2.0 should drop any day now, and should offer another method to automatically install mods and download custom songs.
BeatDrop 2.0 is out now! It has a new improved interface, and offers another method to manage and install mods automatically. This might very quickly become the top method I recommend.
Final words of advice
If you’re modding Beat Saber that was purchased through the Oculus Store, occasionally they will push an update and you might see a notification that Beat Saber failed to update. To fix this issue simply uninstall Beat Saber and install it again, then proceed to apply mods and songs again. This is why I recommend SyncSaber—all your songs download again after you sign in.
Sometimes Beat Saber updates also require the mods or the Mod Manager to be updated to work with the new version, so you might want to wait a few days or check the status of mods from before forcing the update.