2. Map Structure

Audio

Meaning

Before starting a map we mappers usually choose a song. It can be anything you want.
The song formats will be OGG and WAV.
This file will also determine the length of the map and cannot be changed anywhere else.

Notes

• Usually best to keep it song.ogg
• It is recommended to use OGG (lossy audio format) compared to WAV (lossless audio format) as your file format since you won't get far with the 15MB limit on Beat Saver.
• Try to find the best quality of the song you want to map.
  If you can, buy the song on Bandcamp or Beatport or any other service that gives you access to a lossless audio format. this way you also support the artist :)

Info

Meaning

This file includes all the info beat saber needs to know for handling your map like song's name, song's author, mapper(s), base BPM, difficulty files, mod requirements and suggestions and more.
This file is called info.dat and cannot be changed to something else. keep in mind that this file is a JSON file with a different name and should be treated as a JSON file.
Any error even the smallest one in the file will cause the map to not load in the game.

Structure

• _version - Format version
• _songName - The name of the song. will be used as the map's title in the game.
• _songSubName - The subname of the song. Could be seen next to the title but smaller text. This is usually used for remixs or different versions of the song you are mapping
• _songAuthorName - The author of the song. Can be seen under the name of song in the game.
• _levelAuthorName - Put your name here. can be seen after the song's author inside []
• _beatsPerMinute - The bpm of the song. To find the bpm of the song you can use bpm tappers or Arrow Vortex to automatically find it.

Notes

• Always info.dat
• Errors(invalid json) will cause the map not to load inside beat saber.