Beat Saber: How to Import and Align a Song in the Official Level Editor

Choose the map folder and import supported audio

Open the editor’s Settings and choose the directory for your beatmaps. Return to Song List and use its plus button to create a song. Enter the song name, custom beatmap folder name and initial BPM, then use the folder icon to select a WAV or OGG audio file. The editor moves the selected audio into the configured directory. Save and Open takes you into song settings. The creation fields and supported audio formats are documented together. Use a supported audio file and open its settings. [1]

Steps

1. Choose the beatmap directory in Settings, then return to Song List and click the plus button. [1]

Choose the environment and a Standard difficulty

Choose an environment before creating its lighting: changing it later can cause incompatibilities and lost lighting progress. Add a difficulty under Standard using its plus button. For a first map, the documentation recommends leaving Jump Speed and Spawn Offset at zero before opening that difficulty’s editor. The starter difficulty and movement values are part of the same procedure. The zero values are defaults for starting a map. [1]

Use the BPM tool when changing an existing song’s timing

The BPM text field initializes the song’s timing, but later edits to that field only affect the displayed value. Use the BPM tool button beside it to update existing song timing. This distinction matters if the number looks correct while the grid still drifts: changing that text again does not perform the timing edit. [2]

Steps

1. Open the BPM Edit Tool with the icon beside the BPM text. [1]

Align the first two beat markers and listen farther into the song

For a first map, use a song with a static BPM. In the BPM tool, Space plays the audio with a metronome; adjust their volumes so both are audible and compare their timing near the start and later in the track. The metronome and waveform help you check alignment. If alignment is wrong, choose Split and Round and split at marker 1.0. It turns blue; use Ctrl+Z if you split the wrong marker. Switch to Select with Stretch enabled. Move the blue 1.0 marker to the first beat, then the grey 2.0 marker to the second. Play again and check later beats for drift. [3]

Correct later drift and return to the song without losing alignment

If timing drifts later, adjust a later marker to realign the current region. Split into another region when a section needs separate timing; adjustments after that split leave the earlier region intact. You can return to the BPM tool after mapping, and the documentation says notes and lighting realign with those edits. A region split preserves the earlier section. Existing note and lighting data follow later BPM edits. [3]