Short/Simple Guide To Keep Updates From Breaking Your Mods (2025)

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!

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)

If for some reason you need a very specific version OR easy access to multiple instances of different versions:

• Install BS Manager[github.com].

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.

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:

• Legacy Installer[github.com]
  
• Legacy Launcher[github.com]

Update Skipper tricks Steam into never forcing you to apply the next update.

• Update Skipper[github.com]

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