BeatMapper Tools

BeatMapper Tools

Tools and services for Beat Saber Mappers


“Bloody brilliant! OMG this is going to make my new mapping hobby so much easier! I’m off to donate to your cause!”


“BMT simplifies the mapping workflow by managing the files, tools, and interfaces mappers need most, and lets you concentrate on the fun part – mapping! It’s highly configurable and flexible and just plain works. An example from my workflow: open BMT, click a button, and Mediocre Mapper is open and ready to use. Click save on a map, and it’s not only ready to playtest in VR on my PC, it’s also been backed up to another directory, AND deployed wirelessly to my Quest. And speaking of Quest, if you have one and plan on mapping, then BMT is THE tool to have. Automatic, wireless deployment of your map to the Quest is absolutely the easiest way to map and test with the Quest. On top of all this goodness, the developer, Darkuni, is extremely responsive to user’s needs and exceptionally quick with maintenance and enhancement of the application. After the map editor, this is the most important tool in a mapper’s arsenal. If you’re not using BMT, you’re mapping the hard way!”


“BMT is an indispensable addition to every MM user’s kit – a simple and elegant solution to the headaches associated with packaging, uploading, synchronizing and locating your custom songs. The accompanying Guide is straightforward and descriptive, making the BMT accessible and easy to implement for even the greenest neophyte. “

BeatMapper Tools V2.4 Release (90/360 Mapper Tools)
With the addition of 90/360 maps and the community mapper tools not fully supporting these new functions, I've spoken with members of the mapping community...
Read More "BeatMapper Tools V2.4 Release (90/360 Mapper Tools)"
BeatMapper Tools V2.2b Released
This is more of a maintenance update to handle 90/360 maps and fix some changes in the mapping scheme parsing. New: Support for 90/360 map...
Read More "BeatMapper Tools V2.2b Released"
BeatMapper Tools V2.1 Released
It is out! Go check out the Downloads and the Release Notes. Bring any issues to Discord! You will want to read up on using...
Read More "BeatMapper Tools V2.1 Released"


Full Releases

BeatMapper Tools v2.5 

Released 1/6/2020; Windows 7/8/10;.NET 4.5 required; Release Notes

Incremental Updates

BeatMapper Tools v2.8 (EXE only)

This gives you new features without a full download – just replace your existing .exe with this one. Be sure to check the release notes!

Released 3/6/2020; Windows 7/8/10;.NET 4.5 required; Release Notes

Disclaimer This version of BeatMapper Tools is constantly in development and there are always potential issues (none should cause a loss of data, though).  This version works with all editors, including MM MK4.1 and MK5 as well as as MMA2.

Installation and Usage

Download the application. Unzip it wherever you like; it is “portable” – no install or support files are required.

Double click on “BeatMapper Tools.exe”.

You’ll be asked if you’re ONLY going to be using an Oculus Quest with Beat Mapper Tools.  If you say yes, you’ll be asked to select the custom song folder that contains your Mediocre Map custom songs.

Next, you’ll be asked to choose an EGG file (the OGG song in the new Song Format 2.x) in one of your custom map folders. This helps the app figure out where all your Work In Progress maps are being stored. If you are storing your WIP maps in C:\Program Files (x86)\Steam\steamapps\common\Beat Saber\WIP Songs and have a song in there called ElectricDreams, use the file dialog box to select the EGG file in that folder: (Only EGG files will be shown so you can’t pick the wrong thing)

If you are not using just a Quest (or using both a Rift and a Quest), you’ll be asked to choose your Beat Saber game exe (for Steam, it might be in a location like C:\Program Files (x86)\Steam\steamapps\common\Beat Saber and for Oculus users, it may be in a location like C:\oculus\software\software\hyperbolic-magnetism-beat-saber).

Song Screen

After completing the short wizard, you’ll get the main interface – and the watcher tool will be OFF. Click the Watcher Mode button to turn it ON (from now on, the tool will always start in ON; this is just to help you get familiar with the app).

That’s it! Go open Mediocre Mapper and work on one of your maps! Whenever a change is seen (even an AutoSave – if you have it enabled in MM) your song will be automatically converted and deployed with no action from you. When you’re ready to test, run Beat Saber and your song will be waiting for you.