Installing the editor
Download
Windows/Linux
-
You can download the editor from these URLs:
-
Alternatively, you can download from github
- Go to the MercuryMapper GitHub repository.
- In the Releases section, find the latest release (it’s usually at the top of the list).
- 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)
Requires .NET 8.0.12
Install
This is for Windows, but the core concepts can be transferred to other operating systems.
- Once the download is complete, navigate to your download location.
- Right-click the
MercuryMapper-Win-Portable.zip
file and select Extract All or use a tool like 7zip to extract it. - Navigate to the extracted folder.
- 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.
- Open Audacity or Tenacity and import your song.
- 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.
- 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:
- Export the edited audio using
File -> Export Audio
, It's recommend to export as WAV as it tends to work the best.
Reaper
- Open Reaper
- If this is your first time running reaper, make sure Grid Lines are enabled:
Then, go toFile -> Project Settings
, changeTimebase for items/envelopes/markers
to Time, and clickSave as default project settings
- Drag and drop your audio, or use
Insert -> Media File
- Set your song's BPM on the bottom right
- Hold shift+click to drag the track without grid snapping, and time the audio to the measure line.
- 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
- In the editor, select
File -> New
to create a new chart. - Set the BPM and Time Signature here, if you don't have them you can usually find them pretty easily or calculate them yourself.
-
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
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
Right
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.
- For latin alphabet - full width characters can be found at: https://lingojam.com/FullWidthTextGenerator
- For kanji and kana - hiragana: https://www.lexilogos.com/keyboard/hiragana.htm
- Alternatively, https://romajidesu.com/translator/ - click "Kana" instead of "Romaji"
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
- 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, and0.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
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 infoMusic 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
Hitsound Volume
- Changes all hitsounds volumeStart Metronome
- The metronome that plays for 1 measure at the start of the chartConstant Metronome
- A constant metronomeModify 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
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
Settings
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).
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 clickNearest
in theSelection Info
tab. If there are multiple notes at once, you can click< Previous
orNext >
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.
- Highlighting (Red) is used to select certain notes (useful when overlaps are present) and to view information in the
- To delete a note, either undo with
Ctrl + Z
or select a note and pressDelete
/clickDelete Selection
in theModify Notes
tab. - To edit the type/size, you can use the edit note keybinds or use the
Edit [Shape]
andEdit [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