Skip to content

install mods on your version

Jump to bottom
github-actions[bot] edited this page Jun 8, 2025 · 1 revision

Table of Contents

With BSManager

How to Install Mods with BSManager

  1. Download and install BSManager from one of the following sources:
  2. Launch BSManager and select the version of Beat Saber that you want to use from the list on the left side of the interface.
  3. Go to mods by clicking on the Mods tab.
  4. Find the mods that you want to install from the provided list. You can use the search bar at the top of the interface to filter mods by name.
  5. Check the box next to the name of each mod that you want to install.
  6. Click Install or Update at the bottom-right corner of the interface.
  7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from BSManager to enjoy your new mods!

How to Import Mods with BSManager

  1. Download and install BSManager from one of the following sources:
  2. Launch BSManager and select the version of Beat Saber where you want to install mods from the list on the left side of the interface.
  3. Go to the Mods tab.
  4. From here, there are two possible methods:
    1. Click on ⁝ button, then select Import mods and choose the .zip or .dll file to import.
    2. Drag and drop your .zip or .dll file directly onto the mods interface in BSManager.
  5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from BSManager to enjoy your new mods!

Important

The file must be in .zip or .dll format to be imported.

Manual Installation

Important

This guide assumes your game already has core mods installed

If it doesn't: open BSManager, select the game version you want to mod, go to the Mods tab, and click Install or Update. Then, run your game once, go to the main menu, and close it. ℹ️*

  1. Open BSManager and select the version of Beat Saber you want to install the mod to.

  2. Click on the version options button at the top-right corner, then select Open Folder.

  3. Download the desired mod from a trusted source, often found on community GitHub repositories. Search for the mod's name followed by "GitHub" in your search engine.

  4. Installing Different Types of Mods:

    • For mods that come as a single .dll file: If the mod consists of a single .dll file, copy this file into the Plugins folder in the directory you opened in step 2.

      [!NOTE]

      Do not place files in Beat Saber_Data\Plugins. If you do not see a Plugins folder directly in the folder you opened in step 2, make sure you have core mods installed and have run your game at least once after installing mods.

    • For mods that come as a .zip file: If the mod includes multiple files or folders, you need to maintain the provided folder structure. Double-click the zip file to open it, press CTRL+A and then CTRL+C to copy all files/folders inside the zip, go to the directory you opened in step 2, and press CTRL+V to paste them there. Do not paste them in any subfolder, such as Plugins or Beat Saber_Data. If you are prompted to merge folders or overwrite files, click "Yes."

  5. The mod should now be installed. Run Beat Saber to check if the mod functions correctly. If it doesn't, double-check that you:

    • Have all required dependencies installed. These are typically listed somewhere on the mod's release page.
    • Placed the mod in the correct install folder.
    • Downloaded a mod intended for your game version.

🌐 Navigation

📚 Guides

🛠️ Installation and Updates
🔑 Login
🎮 Content Management
🤝 Contribution

🐞 Troubleshooting

💾 Installation Problems
🔍 Debugging Tips

Clone this wiki locally