# PC Modding

# Preface


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.

Beat Saber natively supports custom songs, so if that's all you're looking for, you don't require more mods! It's a wise idea to install SongCore though, as this mod expands upon the base game functionality to improve loading times and provide functionality for other mods like the in-game downloader, custom leaderboards, playlists, etc.


This guide is for PC-modding on Windows.
If you have a Quest, see the Quest Modding page.
If you're on Linux, check out the Linux page or QBeat (opens new window)

If you run into problems at any point, please head to the support page and see if you can identify what went wrong before asking in the Discord server. Chances are, your answer is on that page!

I watched this video by Elite Eric, but I got stuck/it didn't work. What gives?

We at BSMG strongly suggest against using any tutorials by Elite Eric. After reviewing much of his content, they contain a large amount of incomplete, erroneous, or straight up incorrect information. Attempts to reach out to him to correct these errors has unfortunately been met with silence and new (also incorrect) tutorials.

Instead, you should follow the written guides here on the wiki or seek out help in the BSMG Discord (opens new window).

# Installers

# Mod Assistant


Run the game at least once before trying to mod the game! This applies to reinstalling your game too.

A simple Beat Saber Mod Installer similar to the mod manager, but with additional features such as mod removal and version checking! Get it on Assistant's GitHub (opens new window)


# How to get more songs


Most maps in the "Top All", "Rating", "Downloads" or "Plays" sort filters were created before good mapping practices were established. Try downloading songs released between late 2019 and now to get the best custom levels experience.

# In-game Downloader

The BeatSaver Downloader Plugin allows you to download maps in-game using the MORE SONGS menu button on the MODS menu screen. This pulls maps directly from BeatSaver (opens new window)

# BeatSaver

BeatSaver (opens new window) is the master repository of custom songs made by the community. Many other tools and sites enhance the experience of downloading custom songs, but this site is where they are stored. To install songs downloaded from the site, unzip them into a folder and place it into Beat Saber/Beat Saber_Data/CustomLevels. You can also use the in-game downloader plugin, BeatList, or Mod Assistant's OneClick™ Install feature.

# Beast Saber

Beast Saber (opens new window) (bsaber.com) is a site that tries to help make finding fantastic maps to play easier. It does this by categorizing the thousands of songs on beatsaver and lets you sort by a song's genre and many other attribute tags. It also has a full social feature where players can review songs and comment on them. One of the most used features is the "Curator Recommended" feature where a team plays through most songs released each day and recommends the ones that stand out, letting you automatically download these in-game (opens new window).

# Song Management Apps

# Playlists

You need to install the PlaylistManager (opens new window) mod.

Then you can either:

  • Use the Install Playlist tool in the Options tab of Mod Assistant.
  • Place the playlist file into Beat Saber/Playlists, select it in-game, then hit download all songs.

You should see the playlist next to the Custom Levels album's in-game. The mod also supports managing playlists in-game.

# Install Folder

Where is Beat Saber installed?

# Default Location

Steam C:\Program Files (x86)\Steam\steamapps\common\Beat Saber\
Oculus C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\

# Other Locations

If you have moved your install folder to a different drive, it might be in the location below. Replace the drive letter F with the drive your game is installed on.

Steam F:\SteamLibrary\steamapps\common\Beat Saber\
Oculus F:\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\

# Manual Installation

A mod installer is the recommended way to install mods. See the section above. If you have patched the game and just need to install Plugins that are not available in the installer, skip to step 4.

Run the game at least once before trying to mod the game! This applies to reinstalling your game too.

# Install BSIPA

  1. Download BSIPA (opens new window).
  2. Navigate to your install folder. and extract the contents of BSIPA into it. Directory Clean Directory Ipa
  3. Double click IPA.exe to patch the game. Any mods in the Plugins folder will now be loaded when starting the game. If there are errors, you probably didn't follow step 2 correctly. Directory Patched

# Install Mods

  1. Download the mod(s) you wish to install, whether it be from GitHub, the BSMG Discord (opens new window) #pc-mods channel, BeatMods (opens new window) or other sources. Make sure to download any dependencies required by the mod. Directory Plugins
  2. Some mods have installation instructions, some don't. Generally you can just drag and drop the zip contents into your beat saber install folder, and the files should go into the corresponding folders.

# How to uninstall mods

Either remove the dll from the Plugins folder, or click the Uninstall button in Mod Assistant.

# Where to go from here

# Have questions?

Visit the support channels in the BSMG Discord (opens new window)!