This tool is for Mediocre Mapper (MM) users that want a turn key way of play testing WIP (Work in Progress) maps without the chore of manual conversion, folder copying, etc. It uses tried and true songe-converter from lolPants to do the actual conversion while performing a number of tasks you would normally have to do manually.
There is also functionality for quickly packing up your maps for uploading. This strips out all the extra stuff that might be left over from your map making – and easily provides you with a file ready to share.
Why this tool?
Mediocre Mapper uses a “WIP Songes” folder to hold all your in-progress mapping creations.
Since MM is still using the “old” song format for Beat Saber, you would have to either convert the map manually or put it into a special Beat Saber folder – which then gets converted next time you run Beat Saber. This also removes all your “CustomLevels” you may have – moving them to some oddly named folder.
Even if you use lolPants “Song Syncer”, there are still manual processes to be done and it isn’t as elegant if you’re working on multiple maps frequently.
What exactly does this tool do?
- Auto converts maps AS YOU WORK ON THEM in Mediocre Mapper
- Deploys conversions to a WIP folder in Beat Saber so your songs are ready to test – without interfering with your other custom songs.
- Packs your finished map up for deployment to Beatsaver.com
- Has several little workflow helpers to relieve some of the non-creative efforts surrounding mapping.
Once you set your Beat Saber game folder and your Custom WIP song folder, you need only run this tool and let it sit there while you work.
While running it is watching your ENTIRE WIP folder for changes; not just the map you’re working on.
When you make changes using MM, the files inside your custom song folder change – triggering this tool into action.
When a change is found, it copies the custom song that was changed into a temporary folder, then runs lolpants’ Songe Converter over it.
After the conversion, the folder is moved to the official Beat Saber Custom WIP Levels folder:
When you launch Beat Saber, these maps will appear in the UI under WIP Maps:
Along with the automated deploying/converting, this tool will help you pack up your final map for uploading. This only takes the files you need and leaves out everything else (autosaves, files left over from conversion, etc). It will even put the song artist and title onto your clipboard for easy pasting into Beatsaver.com’s website.
Note: The packer assumes you’ve been using this tool to deploy your maps during editing. If you try to pack an unconverted song, you’ll be prompted to convert it first.
After packing for distribution, this app will ask you if you would like to finalize the map – moving it out of WIP MAPS and into CUSTOMLEVELS so you can play competitively.
Installation and Usage
Download the application below. Unzip it wherever you like; it is “portable” – no install or support files are required.
Double click on “BeatMapper Tools.exe”.
On your first run, 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).
Next, you’ll be asked to choose an OGG file in one of your custom map folders. This helps the app figure out where all your Work In Progress maps are being stored. Note: These are your MM 1.x version maps you’re editing.
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 OGG file in that folder: (Only OGG files will be shown so you can’t pick the wrong thing)
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.
BeatMapper Tools (Windows 7/8/10 w/.NET 4.5)
(Opens support channel in Discord – just easier to keep the channel updated than to constantly update in two places)
Disclaimer / Other Info
I know how valuable your custom maps are. Every attempt has been made to ensure this tool will NOT delete, corrupt or otherwise mess with your stuff (your own custom maps or the custom maps of others you’ve downloaded). That said, I am not responsible for any issues, data loss, corruption or random act of God that may lead to loss of data.
The app never directly opens or edits your files – it always works off of copies.
This tool is not open source, but I’ll share the code with anyone that wants to look at it. Not because I’m against open source or have anything to hide, I just don’t want to be told what a sloppy programmer I am. This is a hobby project and not a commercial one.
BeatMapper Tools uses a console application written by lolPants and is included with this download – specifically songe-converter which you can learn more about here. A license file is included with the distribution.