Installing ReMapper

Here's what you need to do once per system!

Deno Installation

ReMapper requires Deno to work. Deno is the thing that will actually be compiling the TypeScript code and running it.

In order to install Deno, open a Windows Powershell terminal like so:

Next, paste irm https://deno.land/install.ps1 | iex into the terminal and let it install!

VSCode Plugin

If you are using VSCode, you will also need to install the extension. Head into the extensions tab on the side and install it.

Setup Tool

ReMapper comes with a handy setup tool which automatically adds all of the relevant ReMapper stuff for your map.

Here are the install instructions.

Creating Output Playlist

When running scripts, you'll be obtaining an "output" copy of your map. You will need to have this end up in a playlist/folder you can play ingame. Luckily, SongCore has a feature that allows you to create playlists fairly easily.

First, locate your Beat Saber_Data/CustomWIPLevels folder and create a folder inside of it called OutputMaps.

Next, locate UserData/SongCore/folders.xml and open it in a text editor. Paste this inside:

<folders>
  <folder>
    <Name>Output Maps</Name>
    <Path>your path here</Path>
    <Pack>2</Pack>
    <WIP>True</WIP>
  </folder>
</folders>

• You need to replace "your path here" with the path to the OutputMaps folder you created earlier.

if you restart your game, you should see a new playlist show up where your output maps will be.

⚠️ The playlist will not show up if it has no maps! Try putting a map in it to test if it's working.

Extras

Blender Exporter

If you plan on importing primitive objects from Blender scenes into the map, you will need the ReMapper Blender Exporter.

Instructions on how to install this plugin are listed here.

---

Auto Script Refresh

If you want your script to reload when you save or when key files change (HIGHLY RECOMMENDED!) you will want Denon.

To install it, just run this command in a Powershell window:

deno install -qAf --unstable --global https://deno.land/x/denon/denon.ts

---

If you get an error along the lines of <path> cannot be loaded because running scripts is disabled on this system. try running this command:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

And then run the install command again.