PCVR Modding Guide

This guide covers modding the PC version of Beat Saber

This guide will help you:

Note: This guide focuses on the PCVR version of Beat Saber. This contains no support for Standalone Modding.

Here's what your game could look like with mods installed:

Note: This site's code was "beautified" by DeepSeek and may contain AI generated code. I am lazy.

Getting Started

This guide applies to all PCVR headsets including Pico, Vive, Index, and also Virtual Desktop.

Firstly, lets install BSManager

  1. Go to BSManager's GitHub page and download the latest installer.
  2. Run the installer and follow it to completion
  3. Open the settings via the cog icon and enable one-click installs.
  4. Install a version of Beat Saber:

Recommended Version

We'll install 1.40.4, as that's the recommended version as of now.

Important: This version of Beat Saber uses OpenXR over OpenVR, a change implemented on versions 1.29.4 and above.

SteamVR

We'll need to change the version of SteamVR we're using to beta.
We need to do this because the stable branch has a bug that introduces jittering.


As it hasn't been pushed to the stable branch of SteamVR, we'll need to switch our beta channel.
To do this, right click SteamVR, click properties and then go to the betas tab.

SteamVR Beta Settings SteamVR Beta Selection
Note: This only applies to SteamVR headsets. Quest/Rift users can ignore this. If issues persist, install 1.29.1.

Once you're done:

  1. Login with the platform you own Beat Saber on (its safe, just needed to verify that you own the game)
  2. Once it has installed, click on the newly installed version and open the settings.
  3. Find Shared Folders, then Link all.
Warning: This will only work if your drive is formatted in a filesystem that supports it. For example: NTFS is fine, exFAT is not.

Mods

  1. Click on the mods tab
  2. Install a leaderboard and whatever else you want, just don't install too many mods or your game will lag.
Note: Scroll down to see recommended mods (strongly recommended!!)
These mods are used by a lot of people, some essential, some not.
  1. Click on the models tab and grab custom sabers/platforms/etc. You can also use the BSMG models channel.
  2. Open your game and verify that all your mods are there and working

    You can do so by looking to the left in the main menu.
Do note that, some mods will only appear in Mod Options, which is a seperate menu.
The same goes with song select, some mods will appear in the mods tab above your modifiers.

Recommended Mods

  • Chroma
  • Custom Sabers
  • BeatLeader
  • Noodle + Mapping extensions
  • SoundReplacer
  • EasyOffset
  • BeatSaberPlus (see below)
  • Beat Saber RPC
  • Counters+
  • JDFixer
  • KeepMyOverridesPls (if available)
You can look into what these mods do individually, though most of them are self-explanatory.

BeatLeader

  • Open BeatLeader in your browser and login with steam/oculus
  • Customise your profile :)
  • You can grab every ranked map by clicking the link, and then the green hand icon (this will take a while!!)
  • Ping @limatt for an invite to jof clan. this makes your scores auto-appear in the channel.
  • Once invited, accept it on the clans page

    • Beat Saber+ & Multiplayer+

    Install BS+ by placing it in your Beat Saber root directory:

    Additional Resources

    The BSMG Wiki contains comprehensive modding information.

    Migrating to newer versions

    Time to finally get off 1.29.1!

    As mentioned prior, it's now safe to migrate to newer Beat Saber versions as SteamVR FINALLY fixed their shit.
    This is more or less a copy paste of the previous guide but with some important stuff added in.
    This includes mandatory mods, settings and things to look out for BEFORE deleting your old version.

    Note: It's CRUCIAL that, if you DON'T want to lose your controller settings, then DO NOT UNINSTALL 1.29.1.

    Firstly, lets install BSManager

      If you don't use BSManager already, then I'd STRONGLY recommend using it.
      It makes version changes and migration easy, painless and simple. Stop using ModAssistant, let it go, unc.

    1. Go to BSManager's GitHub page and download the latest installer.
    2. Run the installer and follow it to completion
    3. Open the settings via the cog icon and enable one-click installs.
    4. Install a version of Beat Saber:

    Recommended Version

    For now, just install the recommended version. This will usually be the version with the most mods.
    If you're on 1.40.3 and 1.40.4 just came out, don't worry about updating until the next major update drops.
    It's never that deep.

    SteamVR

    If you use SteamVR, then, you must switch your SteamVR version to beta. To do this, right click SteamVR, click properties and then go to the betas tab.

    this ONLY applies to headsets that use SteamVR. If you're on Rift/Quest, Set Quest Link as your default runtime.

    Data Migration

    Copying over Maps & Playlists

    Copy over your Playlists and CustomLevels folders.

    📁 Beat Saber\Playlists
    📁 Beat Saber\Beat Saber_Data\CustomLevels
    📁 Beat Saber\Beat Saber_Data\CustomWIPLevels

    Controller Settings Migration

    As said already, Controller presets are different, so we'll use these 2 tools to convert your prexisting settings.

    You can follow this tutorial by Noam15A to help you from here.

    Mod Configuration

    There are 2 ways of doing this.

    Method 1: Fresh Config

    Not moving your configs and just reconfiguring them manually is generally better.
    You will avoid any issues with mods that have updated since 1.29.1, as mod support has been dropped for it long ago.

    Method 2: Copying over Configs

    Copying over UserData may cause issues if mods have changed since 1.29.1.

    To do this, we'll simply copy over the UserData folder.

    📁 Beat Saber\UserData

    We'll also want to delete "Beat Saber IPA.json" when moving our mod configs.
    This is to ensure the modloader doesn't think our mods are outdated.

    📁 Beat Saber\UserData\Beat Saber IPA.json

    After doing this, your newly updated Beat Saber copy should function just like before, with all the new benefits!
    If not, then head over to Troubleshooting and see if your issue is listed.

    Useful Guides

    Beginner's Guide by Tibytes

    Accuracy Guide by Taddus

    Controller Settings by Xoomies

    References & Help

    Community ran Websites and servers

    Beat Saber Modding Group

    The central hub for modding resources and support.

    Join BSMG Discord

    BeatSaver

    Primary repository for custom maps and playlists.

    Visit BeatSaver

    ModelSaber

    Custom models repository (quite outdated).

    Visit ModelSaber

    limatt's Repository

    Personal collection of sabers and configurations.

    Access Repository

    Troubleshooting

    Have you tried turning it off and on again?

    I lag when more than on old versions // I lag when starting a song

    Delete your AppData. Your data is located at: C:/users/you/AppData/localLow/Hyperbolic Magnetism/Beat Saber.
    This will remove your colours, favourites and settings but should solve your issue.

    X Mod is not available for X version

    Check BSMG or the mod's Github for the latest version.
    Modloaders do not push mods immediately. You can also check other people's forks for updates.

    My controller settings are wrong on new versions!

    Yes, they are.
    Beat Games migrated to OpenXR and therefore, the preset positions are different. You can follow the migration tutorial for a fix.

    My game stutters

    You can cap your framerate via your GPU vendor's control panel.
    Use google for this.