Skip to content

Setting Maps Up

Swifter edited this page Nov 20, 2025 · 8 revisions

Here's what you need to do on a per map basis!

Setting Up Workspace

This tutorial will be using Visual Studio Code.

Let's get our workspace setup! Inside of VSCode, navigate to File > Open Folder. Navigate to the map that you are going to work on and double click it.

image

You should see the map's hierarchy in the file explorer. If you don't, click on the icon the red arrow is pointing to.

image

It is very important that VSCode recognizes that we are working in this folder. Lots of things rely on our map being considered a workspace. In fact, we can save the state of our window as a file, so that we can just double click it again whenever we want to come back to it.

Navigate to File > Save Workspace As... and save the file in your map's folder.

image

Important

It is incredibly important that VSC recognizes this workspace as a Deno workspace. Open the Command Palette with Ctrl + Shift + P and search for Deno: Enable. Click on it, and yes to everything.

image

Adding Script Files

Now it's time to use that setup tool from before!

Navigate to Terminal > New Terminal to open an integrated Powershell window in your map's directory.

image

Assuming you did everything correctly, you should see your project's path in the terminal window.

image

Now run the setup command. Assuming it runs successfully, you should see some new files in your file hierarchy! Go ahead and click into the src/main.ts file.

image

This will be your bare minimum script where you will make your changes to the beatmap.

Running The Script

If this is your first time using the latest version of ReMapper, the link in the import * as rm statement will give you trouble saying that the dependency is unresolved! This is because Deno saves packages to a cache on your computer, but not automatically.

In order to cache the ReMapper package onto your computer, hover over the URL in the statement and hold alt. You should see a Quick Fix option. Press it and select the option that lets you cache the dependency.

image image


Now, in order to run the script, we have two options, both go in the terminal:

Standard Deno

deno run --no-check --allow-all src/main.ts

With this method, you will run this in the terminal each time you want to run the script. Though, you can press the up arrow on your keyboard inside of the terminal to bring up the same command again!

Denon

denon rm

This will call upon the scripts.json that should be in your map directory to automatically run the Deno command each time key files are refreshed. This will trigger even if you save your scripts (Ctrl + S) without having any changes!

Clone this wiki locally