Beat Saber

Beat Saber

Not enough ratings
Short/Simple Guide To Keep Updates From Breaking Your Mods (2025)
By doomslvt
A list of easy options you can use to prevent Beat Saber updates from breaking your mods.
   
Award
Favorite
Favorited
Unfavorite
Intro
This guide aims to simply point people towards the current best options for avoiding broken mods upon update.

"great! now i have to wait days/weeks for mods to be fixed" is an extremely common sentiment in the comments of every Beat Saber update. Multiple solutions to this problem exist. All other guides I could find on the subject were either outdated or overwhelming due to being more complicated than they need to be.

You don't have to do all of these, you only need to choose one. Every option listed will prevent you from noticing or needing to care when a new Beat Saber update is released.

Feel free to message me if you need help with something!
Option 1: Beta Branch
Using a beta branch is by far the easiest solution and should work for most people. Beat Games provides multiple legacy branch of the game. When you select a branch, Beat Saber will stay on the selected version.

1.29.1 is recommended as it is compatible with almost all mods. At current date (08.06.24), you can also choose 1.34.2 or 1.37.1.

  • Beat Saber Properties > Beta > Use the legacy 1.29.1 beta branch (legacy1.29.1_unity_ver2019.4.28f1 - pre unity upgrade build)
Option 2: BS Manager
If for some reason you need a very specific version OR easy access to multiple instances of different versions:


BS Manager allows you to install as many instances of Beat Saber as you want. Choose from literally any version of Beat Saber that's ever been released. You can also set it up so all the instances share your custom songs, maps, playlists, user data, etc. but this takes a small amount of extra setup. Make sure you install the correct version of whatever mods you want with each instance (e.g. Version 1.29.1 needs mods that are compatible with version 1.29.1).

With this solution, you can easily test out newer versions without worrying about messing up your daily driver version. Slightly more work than option 1, but very clean and tons of great features.
Option(s) 3: Misc.
Here are some other miscellaneous options. I have personally used all of these in the past, but they are all more cumbersome & require more effort to set up than the previous options. I don't recommend them unless for some reason the prior options don't work for you.

Legacy Installer/Legacy Launcher both essentially do the same thing as BSManager:

Update Skipper tricks Steam into never forcing you to apply the next update.
Shameless Self-Promotion<3
Some of my Beat Saber related socials :3

ScoreSaber - doomslvt[scoresaber.com]
YouTube - ghostberry13: I upload Beat Saber custom map playthroughs
Twitch - ghstbrry[www.twitch.tv]: I stream Beat Saber usually evenings EST time
3 Comments
doomslvt  [author] 25 Aug, 2024 @ 11:40pm 
@Fatalution
I do mention in the BSManager section:
"You can also set it up so all the instances share your custom songs, maps, playlists, user data, etc."

I didn't want to go into more detail than that because I wanted to keep the guide as high level as possible avoiding specific setup instructions.
Fatalution 24 Aug, 2024 @ 6:25am 
For BSManager, add info about syncing folders. This is one of the most important aspects of the tool - you can have multiple installs and sync maps, sabers, playlists etc. between them with a mouse click.

You can even sync mod settings (UserData folder) - BUT you will have to go to UserData/Beat Saber IPA.json and edit the line called "yeetMods". It's set to "true" by default - and we need to change it to "false". Otherwise, every time you gonna switch versions with the UserData folder sync'd, the mods would be reset
MrKrabzz 7 Aug, 2024 @ 6:18pm 
🐐