Skip to content

Installing the editor

Download

Windows/Linux
  1. You can download the editor from these URLs:

    Windows

    Linux (x64)

    Arch Linux Logo AUR (Binary)

    Arch Linux Logo AUR (Source)

  2. Alternatively, you can download from github

  3. Go to the MercuryMapper GitHub repository.
  4. In the Releases section, find the latest release (it’s usually at the top of the list).
  5. Under the latest release, find the assets section and download the version for your operating system.
OS X

Due to the requirements to develop for mac, the mac version is seperately maintained by h3llo_wor1d. (No guarantees this works/doesn't break)

1. Go to the MercuryMapper Mac Repository 2. In the Releases section, find the latest release (it’s usually at the top of the list). 3. Under the latest release, find the assets section and download MercuryMapper-Win-Portable.zip 4. Alternatively, you can download from one of these links:

OS X (ARM64)

Requires .NET 8.0.12

Install

This is for Windows, but the core concepts can be transferred to other operating systems.

  1. Once the download is complete, navigate to your download location.
  2. Right-click the MercuryMapper-Win-Portable.zip file and select Extract All or use a tool like 7zip to extract it.
  3. Navigate to the extracted folder.
  4. Locate and run MercuryMapper.exe

Setting up audio


Audacity/Tenacity

This guide will use audacity, but the core concepts can be transferred to other audio editors.

  1. Open Audacity or Tenacity and import your song.
  2. Insert one or two measures of silence at the start of the audio, use one if you want the song to start immediately after the metronome.
  3. Ensure the song is synced so that the first beat lands at the start of a measure, you can use Generate -> BPM Labels to check this.

BPM Labels is not a stock plugin

If you don't have it, download it here: bpm-labels.ny

Example image, where the audio starts on measure 2 and the first played beat is on measure 4: BPM_Label_Image

  1. Export the edited audio using File -> Export Audio, It's recommend to export as WAV as it tends to work the best.

Reaper

  1. Open Reaper
  2. If this is your first time running reaper, make sure Grid Lines are enabled: Grid_Lines_Toggle
    Then, go to File -> Project Settings, change Timebase for items/envelopes/markers to Time, and click Save as default project settings Default_Project_Settings
  3. Drag and drop your audio, or use Insert -> Media File
  4. Set your song's BPM on the bottom right
  5. Hold shift+click to drag the track without grid snapping, and time the audio to the measure line.
  6. If you need to add measures, expand (click and drag) the left edge of your track until it snaps to a measure line, then click and drag the track to move it around.

Basics


Initial Chart Setup

  1. In the editor, select File -> New to create a new chart.
  2. Set the BPM and Time Signature here, if you don't have them you can usually find them pretty easily or calculate them yourself.
  3. In the right of the editor, open Chart Info and fill out all the information.

    3.1. See the User Interface Section if any fields are confusing

Hitsounds

Download the hitsounds zip here: hitsounds.zip.

Right-click the hitsounds.zip file and select Extract All or use a tool like 7zip to extract it.

Open the settings, then select Audio, from here you can change hitsound volume and assign the audio files to each hitsound type.

Keybinds

These are rebindable!

This is a list of all the keybinds the editor uses, grouping is the same as the settings menu in-editor.

File

Ctrl + N - Creates a new chart

Ctrl + O - Opens an existing chart

Ctrl + S - Saves the current chart

Ctrl + Shift + S - Saves the current chart with a new file name or location

Ctrl + Alt + S - Opens the settings menu

Edit

Ctrl + Z - Undoes the previous action

Ctrl + Y - Redoes the previous action

Ctrl + X - Cuts the selected note(s)

Ctrl + C - Copies the selected note(s)

Ctrl + V - Pastes the copied note(s)

Playback

Space - Begin playback

Ctrl + L - Toggle Loop

Ctrl + , - Set Loop Start

Ctrl + . - Set Loop End

Add - Increase playback speed

Subtract - Decrease playback speed

Right - Jump Measure Forward

Left - Jump measure back

Up - Jump Beat Forward

Down - Jump Beat Back

Ctrl + K - Add Comment

Selection

Shift + W - Highlight Next Note

Shift + S - Highlight Previous Note

Shift + Q - Highlight Nearest Note

A - Select All

Alt + A - Deselect All

Shift + Alt + A - Checker Deselect

Ctrl + B - Box Select

Shift + Space - Select Highlighted Note

Shift + R - Select Note Collection References

Edit Note Collections

Return - End Note Collection

Shift + Return - Edit Note Collection

Shift + B - Bake Selected Notes

Ctrl + Shift + B - Bake Selected Notes [No Render]

Ctrl + H - Stitch Note Collection

Alt + H - Split Note Collection

Shift + H - Insert Segment

Ctrl + Delete - Delete No-Render Segments

Edit Notes

I - Insert a note at current size and position

Shift + E - Edit selected notes' shape

Ctrl + E - Edit selected notes' type

Ctrl + Shift + E - Edit selected notes' shape and type

Shift + M - Mirror current selection

Ctrl + R - Reverse current selection

Delete - Deletes current selection

Shift + Up - Increase selected notes' size 1 unit

Shift + Down - Decrease selected notes' size 1 unit

Shift + Right - Shift selected notes right one unit

Shift + Left - Shift selected notes left one unit

Ctrl + Shift + Up - Increase the first selected notes` size by one, second by two, third by three, etc.

Ctrl + Shift + Down - Decrease the first selected notes` size by one, second by two, third by three, etc.

Ctrl + Shift + Right - Shift the first selected note right by one, second by two, third by three, etc.

Ctrl + Shift + Left - Shift the first selected note left by one, second by two, third by three, etc.

Ctrl + Up - Shift selected notes forward in time

Ctrl + Down - Shift selected notes backward in time

V - Set hold segment render flag to true

Alt + V - Set hold segment render flag to false

Ctrl + M - Flip note direction

Ctrl + N - Convert to instant mask

Shift + P - Paint Selected Traces

Shift + L - Set Scroll Layer

Note Types

1 - Set note type: Touch

2 - Set note type: Slide (Clockwise)

3 - Set note type: Slide (Counterclockwise)

4 - Set note type: Snap (Forward)

5 - Set note type: Snap (Backward)

6 - Set note type: Chain

7 - Set note type: Hold

8 - Set note type: Add Mask

9 - Set note type: Remove Mask

0 - Set note type: Trace

oem4 - Set note type: Damage

Shift + 1 - Select note modifier: None (If using masks, set mask style to clockwise)

Shift + 2 - Select note modifier: Bonus (If using masks, set mask style to counterclockwise)

Shift + 3 - Select note modifier: R-Note (If using masks, set mask style to center)

Rendering

Shift + Add - Increase note speed

Shift + Subtract - Decrease note speed

User Interface

Top

File

New - Create a new chart

Open - Open an existing chart

Save - Save the current chart

Save As - Save the current chart with a new name or location


Export

Export for Mercury - Exports in a format compatible with WACCA

Export for Saturn/Create Saturn Folder - Exports for use in Saturn


Online

Create Session - Creates an online session that other people can join.

Join Session - Join someone elses' online session

Disconnect - Disconnect from the current session


Settings - Open the settings menu


Exit - Closes the MercuryMapper program

Edit

Undo- Undoes the last action

Redo- Redoes the last undone action


Cut - Copy and delete current selection

Copy - Copy current selection

Paste - Paste current selection at current position

Select

Select All - Selects all objects

Deselect All - Deselects all objects

Checker Deselect - Deselects every other selected object, starting with the first selected note


Select Similar

Selects similar notes to the one highlighted

Filter Selection - De-selects every note that doesn't match the filter

Threshold - How many units of variance is tolerated (Ex: a size 10 note with a threshold of 2 will select size 8-12 notes but not size 13+/7- notes)


Box Select - Creates a box that selects everything that is inside of it. When activated, the user will be given a note-style object that they can shape by clicking and dragging around the ring to define width, after the mouse is released the cursor can be moved to change depth, a final click will finalize the selection.


Select Note Collection References - Selects all segments in note collections that currently have selected segments

Select Highlighted Note - Selects the highlighted (red) note

Tools

Mirror Chart - Mirrors the chart on the current axis set in Modify Notes - Mirror Axis

Shift Chart - Shifts the chart by specified amount, useful for (re)syncing a chart to audio


Fix off-by-one Errors - Rounds the timestamps of all non-hold-segment notes to the nearest 10s digit. (Ex: 1919 > 1920, 479 > 480, 241 > 240)


Scale Selection - Changes the time scale of the currently selected notes. Values below one will bring the notes closer together in time, while values above one will increase the distance


Reconstruct Note Collections

Applies to entire note collection, even if only part is selected

Collection to Collection - Re-traces a note collection with a fixed interval between segments, useful for making extra segments to use with jagged note collections

Note Collection to Chain - Same as Collection to Collection, but segments are converted to chains afterward, useful for creating slides with chains or overlaying chains on a hold


Generate Jagged Note Collections - Moves segments of the hold to give it a jagged shape, reconstruct holds can be used to increase segment density for denser spikes.


Proofread - Checks for problems with your chart, very sensitive so will point out legal patterns. It's recommended to check anywhere it warns to ensure the chart follows good practices.

Left

Bottom UI

Chart Info

The Current Filename


Assorted Note Count Statistics


Version - The version of the chart, this not displayed in-game

Title - The title of the song

Ruby - The title with the kana reading of the kanji, used for sorting/bingo.

Artist - The author of the song

Chart Author - The author of the chart, probably you

BPM Text - The BPM to display on the Song Select Screen.


Chart Background - Saturn only, changes the styling of the background during gameplay.


Diff(iculty) - The difficulty level of the chart, includes a 5th option of WORLD'S END in reference to Chunithm that is used for experimental/joke charts.

Level - The decimal difficulty value

  • The game starts '+' values at .7, so a 13.6 is a 13 while a 13.7 is a 13+
  • The game doesn't support 14+, so difficulties of 14.7-14.9 should be avoided

Clear Threshold - Determines how much score is needed to clear

  • It's recommended to use 0.5 for Normal, 0.6 for Hard, and 0.83 for Expert/Inferno


Preview - Preview start/length fields are the time in seconds for where the preview starts/how long it lasts respectively

  • The preview time is used for what is heard during song select and song preview
  • The preview button will play the section that would be previewed and then stop


BGM Offset - Offsets the audio relative to the chart, it's recommended to synchronize the audio itself (see: Setting Up Audio)

BGM - Button to select the audio file for the chart, displays the currently loaded BGMs' filename below the selection button


BGA - The Background Animation (aka Movie/Video), does not display in-editor


Jacket - The jacket is the image for the song (aka album art, cover, etc)

  • Has current jacket filename displayed over the jacket selection button
  • Current jacket is shown below the button

Selection Info

Shows how many notes are selected (this info also appears in blue text next to the gimmick selector)

Main use is to change the highlighted note/view information about the currently highlighted note

Quick Settings

Note Speed - How fast the notes scroll during playback, values are the same as scroll speed in WACCA

Beat Division - The amount of grey beat lines per measure

Show Speed Changes - Toggles if speed changes are shown both while editing and during playback, includes stops, useful for doing complex HiSpeed sections

Draw No-Render Holds - No-Render hold segments are used exclusively for judgement, and as the name implies, are not rendered


Show Timing Windows - Shows the timing windows of each note

  • It's recommended to enable Cut Early on Holds and Cut Overlapping with all windows enabled to ensure all patterns are possible/fair to hit, see Game Mechanics for more info


Music Volume - A controls music volume

Hitsound Volume - Changes all hitsounds volume

Start Metronome - The metronome that plays for 1 measure at the start of the chart

Constant Metronome - A constant metronome

Modify Notes

Edit [Shape only] - Changes the selected note(s) size and position to be that of the cursor.

Edit [Type only] - Changes the selected note(s) type to be that of the cursor, includes bonus type.

Edit Selection - Changes both the shape and type of the selected note(s) to be that of the cursor

Delete Selection - Deletes all currently selected objects


Mirror Axis - Change the axis on which mirror operations are performed (visualized by a white line on hover)

Mirror - Mirror all currently selected notes along the mirror axis

Reverse - Reverse the order in time of the currently selected notes

  • Example: if you have a chain selected at measure 1, and a tap selected at measure 2, this button will move the tap to measure one and the chain to measure 2


Flip Note Direction - Flips the direction of a Slide, Snap, or Mask without mirroring it's position

Convert to Instant Mask - Subdivides the currently selected mask to smaller pieces to cause the mask to instantly add/remove the section


Trace Color - Sets the color for the next placed traces

Paint Selected Traces - Applies the selected color to all selected traces


Scroll Layer


Hold Bake/Ease - Bake hold will fill the area between a selected segment of a hold and the next segment of a hold with more segments to achieve a smoother result

  • The easing type to the left of the bake button determines where the inserted segments are placed
  • If you want your non-linear eases to look closer to official charting (see: less smooth), use eases and then reconstruct hold to 1/16th intervals. After that delete any unnecessary extras, and bake linearly.
  • Examples of non-linear curves can be seen at this website

Insert Segment - Inserts a hold segment at the current time with the same size/position as the cursor in a hold if one of its' segments are highlighted.


Stitch Note Collection - If only a hold end and a hold start are selected, they will fuse into a singular hold.

Split Note Collection - Splits a hold in two at the highlighted segment


Set Render Type - No-Render hold segments are used exclusively for judgement, and as the name implies, are not rendered


Delete No-Render Segments - Deletes all selected No-Render segments

Miscellaneous

Add Comment - Adds a comment at the current measure.

Set Loop Start/End - Place either a loop start or loop end at the current measure, visualized on the playback slider as a green and red line respectively

Bottom

Bottom UI

Settings

??? info "Appearance"

***Colors***

***Rendering***

Editor

Quantize on Pause - Whenever you pause, snaps to the nearest beat based on your beat division. (Highly recommended)

Highlight Placed Note - Automatically highlight a note when you place it.

Limit to Mercury Bonus Types - If unchecked, allows bonuses to be used on any note (Not compatible if charting for mercury).

**Keymap**

Change the bindings for keys, see [Keybinds](#keybinds) for functions and default binds

**Audio**

`Hitsound Offset`

`Mute Hitsounds on preview`

`Start Metronome`

`Constant Metronome`

Note Placement

  • You can adjust note size and position by clicking and dragging in the viewport or with the sliders found in Current Note Settings on the left.
  • Place notes by pressing I or by clicking the button under those sliders.
  • Select note type with the colored buttons in the top left or by pressing number keys.
  • Place Bonus/R Notes by using the buttons under the note type panel to change bonus type.

Holds

  • Once you place a hold note, you can only place hold segments until you finish the hold note.
  • To finish a hold note place the last segment and then click the End Note Collection button next to the insert button.

Selecting, Editing, Deleting

  • To select a specific note, Ctrl + Left Click or scroll to it and click Nearest in the Selection Info tab. If there are multiple notes at once, you can click < Previous or Next > while highlighing to cycle though them.
  • Highlighting and Selecting are two different things
    • Highlighting (Red) is used to select certain notes (useful when overlaps are present) and to view information in the Selection Info tab
    • Selecting (Blue) doesn't show info in the Selection Info tab and can select multiple notes at once.
  • To delete a note, either undo with Ctrl + Z or select a note and press Delete/click Delete Selection in the Modify Notes tab.
  • To edit the type/size, you can use the edit note keybinds or use the Edit [Shape] and Edit [Type] buttons to change the selected note into the shape/type of the currently selected shape/type.
  • MercuryMapper converts copied sections to text in modern versions, so you can paste between windows or even paste into discord to share a pattern.

Gimmicks

Hi-Speed

  • Can be used to slow down or speed up the scroll speed
  • If a hold that moves/changes size is in the view port during a really slow hispeed (under 0.01), the game may have issues/crash.

Stop

  • Stops the movement of notes, effectively a 0 hispeed
  • Mixing Stop gimmicks with Hi-Speed gimmicks will result in unintended behavior, so it is generally not recommended (does not apply to Saturn)

Reverse

  • Creates a section where notes scroll backward before playing back normally
  • Almost exclusively used when referencing another game that does it
  • Mixing Reverse gimmicks with any other gimmick will cause crashes. Please leave plenty of space after the reverse end