Install any map

Jump to bottom

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

Table of Contents

With BSManager

How to Install Maps with BSManager

Download and install BSManager from one of the following sources:
Launch BSManager and select the version of Beat Saber where you want to install maps from the list on the left side of the interface.
Go to the Maps section by clicking on the Maps tab.
Click the Add button to access the list of online maps.
Use the search bar at the top of the interface to filter maps by name, type, mods, tags, notes per second, or duration, and order the list by latest, relevance, rating, or curated.
Download to install it.
Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from BSManager to enjoy your new maps!

How to Import Maps with BSManager

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

Important

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

Manual Installation

Find the map you want to install on a site like BeatSaver.
Download the map to your computer.
Open BSManager and select the version of Beat Saber to which you want to install the map.
Click on the version options at the top-right corner of the interface, then select Open Folder.
Move the downloaded map .zip file into the CustomLevels folder, which is located at Beat Saber_Data\CustomLevels.
Right-click the .zip file, select Extract All, then press Extract in the popup. You can then delete the .zip file.
Launch Beat Saber, and the map should now be available to play.

One-Click Installation

Launch BSManager and make sure that the One-Click installation feature is enabled for maps.
Go to one of the supported websites and search for the map you want to install.
Once you've found the map, click on the One-Click or Install button on the website.
A pop-up window will appear, asking for confirmation. Click on Yes to proceed with the installation.