ARBSMapDo – Advanced Ranked Beat Saber Map Downloader

ARBSMapDo is a custom map downloader for Beat Saber, which is a VR Rhythm Game developed by Beat Games. If you have never heard of this game, just watch one or two gameplay videos and you’ll understand 😉 (And yes, this game can be very demanding physically!)

Beat Saber allows the creation of user-generated custom maps and has a vibrant modding community. Part of this is the competitive community with a public leaderboard called ScoreSaber. Only selected maps which fulfill specific requirements may qualify as ranked maps. The difficulty of these maps is displayed by a star rating. Unfortunately, looking for very specific map types can be quite cumbersome.

I was looking for a map finder with advanced options like “download 100 new ranked songs with a difficulty range from 3* to 5.5*, a song length from 1:30 to 3:00 and where at least 75% of all votes are positive ones”. Since the tools I found so far only allowed fairly basic filtering options and did not offer the functionality I wanted, I decided to create one myself.

ARBSMapDo is a tool that allows downloading huge amounts of maps, filtered by custom options. The command-line tool uses information provided by Scoresaber and Beatsaver.

Since I know not everybody is used to work on the shell and likes dozens of arguments, you can set up the custom options by following a guide (simply start the tool), providing arguments directly via command line or by using preset files. (Useful if you want to check out new maps with the same options from time to time again for example)

You can check out the tool as standalone release as well as the python sources at its Github page.

Features

  • Easy mass downloading of maps crawled from Scoresaber
  • Filtering options not relying solely on the (undocumented) Scoresaber API – new options can (and will!) be easily added
  • Presets – if you want to apply the same filters and download new maps again in a few weeks, you can simply save your settings
  • Open Source, of course.

What is planned?

  • More options, of course.
  • Maybe direct upload/syncing to BMBF for Quest users?
  • Check out the Github issues 🙂

Legal Disclaimer

ARBSMapDo is a tool that helps filtering and downloading Custom Levels for the Game Beat Saber developed by Beat Games. The level information is accessed from both the ScoreSaber API and BeatSaver. The levels itself are user-generated content hosted on BeatSaver, which is where they are downloaded from as well. BeatSaver allows users to upload these levels and hosts them for other users to download.

I am not affiliated with BeatSaver in any form, nor do I host user-generated maps myself. Any potential copyright infringements have to be directly reported to BeatSaver via a DCMA request as I am not responsible for any specific content hosted there.