# Intermediate Mapping

A more in-depth look at many mapping topics.

Mapping is level design. Design is both an art and a science. There is no "best" answer, but there are many "wrong" answers.

The Basic Mapping page is useful for learning what not to do as a new mapper. Once you have a bit of experience it’s time to take your understanding of mapping principles to the next level. Ultimately, the best way to learn to map is to simply keep at it.

Try. Adjust. Listen. Repeat.

# !Notice! This is a Stub Page


This is a stub page, content is a work in progress! Ask in #mapping-discussion if you want more info!

# Rule Breaking

Rules are made to be broken. However, they must be thoroughly understood before you can break rules and some have virtually no cases where breaking them is preferred. With experience and outside feedback, there is always value to exploring the full design space of beat saber mapping and pushing the limits of the rules.

Outside feedback is critical as the mapper! You know the rhythm and patterns better than any other person and will be ready to perform the motion before the notes ever show up. By getting third party feedback on broken rules, such as in the BSMG #testplays channel, you can have confidence in your unique patterns and in your map.

# Consistency & Variety

Representing music via consistent note placement when there are similarities in the music and varying mapping when there changes in music are core techniques of intermediate mapping.

  1. Representation is tied to music that your notes are following.
    At the basic level, the sounds that are mapped within each section should follow some kind of rule, such as following an instrument. You can get more complicated, such as mapping the left hand to drums, and the right hand to vocals, but there should be a rule for the mapping within each section.

  2. Consistency and Variety come into play in two places, within a section and when comparing separate sections of a song.

    1. Within a section, representation rhythm-wise should generally stay consistent as it allows players to establish that rhythm and enjoy the map. Being consistent with patterns is acceptable as well, but some variety of note placements within the bounds of the established patterns and rhythms is appreciated.
    2. Consistency and variety are more important when comparing sections of a song, as properly varying your mapping between sections will help the song shine via the map.
    3. Repeated sections of music should play similarly, and contrasting sections should play differently. The degree of this contrast is up to the mapper.
      • This does not mean that the exact same patterns need to be used, but players should be able to feel the similarities between sections with similar music. This can be done in a variety of ways, primarily it is achieved by mapping the same rhythms. If you choose to map a different rhythm, using similar patterns and motions will provide a similar effect.
    4. Varying the mapping appropriately when the music changes is also important. When a change in the music happens, the effect is a lot stronger when the change is reflected in the mapping.

If you’d like to explore this more in depth, checkout pishifat's video (opens new window) on mapping variety in osu!. While it is an osu! video, the concepts translate over to Beat Saber mapping quite well.

# Emphasis

While big towers, windows, doubles, fast jumps, and fast streams are fun. Consider whether the patterns being mapped reflect the intensity level of the music.

  1. Within a section, the most prominent sounds should be emphasized more, and the less prominent less emphasized. Emphasis can be done in a variety of ways, such as:
    • Spacing notes further apart to induce bigger swings.
    • Adding doubles and stacks for oomph.
    • Mapping faster rhythms to induce faster swinging.
    • Not mapping less significant sounds or segments so the more important sounds or segments stand out more.
  2. The intensity of the mapping in each section relative to other sections should be somewhat in line with the intensity of the music. Try to rate the intensity of each section in your map from 1-10 and see if it lines up with the intensity you feel from the song.
  3. Deviation from the intensity of the music is fine as long as sections are not excessively elevated or lowered relative to the intensity of the rest of the song. An example would be fully mapping very quiet 1/4 drums when the rest of the map is mapped to 1/1 or 1/2 would unnecessarily elevate it in intensity above the rest of the song.

If you want to explore this more in depth, checkout pishifat's video (opens new window) on osu! spacing emphasis. While it is an osu! video, the concepts do translate to intensity in Beat Saber.

# Visibility

Players need to see the notes to comfortably prepare and react. Notes that are hidden until the last second are very jarring to play.

# Vision Blocks

Speed influences visibility heavily, as the note jump speed and jump distance dictate how much time the player has to see incoming notes. The player will have too little time to react to notes that spawn too close and approach too quickly. Likewise, vision blocks are more severe as the song gets faster- when the note exists for a shorter time, any time that the block is obscured is more impactful. At extreme speeds and slower note jump speeds, even bottom row blocks can obscure other bottom row notes (the same can be said for top row notes, but those are rarely used at a density where this is a problem).

# Note Jump Speed & Jump Distance

Note Jump Speed (NJS), Spawn Offset (or offset), and Jump Distance are additional factors you need to consider for visibility.

Slower NJS is useful for visibility on easier songs where players need to see things coming to react. Faster NJS is useful for fast songs which would otherwise appear cluttered without note spacing. Faster NJS also helps for visually cluttered maps which heavily use elements such as bombs or sliders that otherwise create visual noise.

Larger jump distances are good for maps which need high visibility to catch unusual or large motions such as dancey maps. Shorter jump distances are useful for maps which have simpler patterns but are faster- a shorter jump distance means that fewer notes are on screen, therefore being less cluttered.

Offset is used to adjust a song’s jump distance while keeping the NJS the same, since jump distance varies with NJS and BPM. Spawn offsets can be positive or negative and usually don't go above 1 or below -1. Below is a table of NJS, spawn offset, and jump distance values that can be used as a guide (but not as law) for determining your map’s parameters. Using this table, adjust the offset as needed to reach the target jump distance.

Speed & Style Jump Distance Target Expert NJS Expert+ NJS
Slow (< 100 BPM) Standard 24-27 14-16 17-19
Slow (< 100 BPM) Dancey 24-28 13-16 16-18
Average (100 - 160 BPM) Standard 23-27 14-16 17-20
Average (100 - 160 BPM) Dancey 24-28 13-16 16-19
Fast (> 160 BPM) Standard 21-25 15-17 18-21
Very Fast (> 200 BPM) Standard 20-24 16-19 20-23

# Understanding Flow

In Basic Mapping we covered the bare essentials of parity. Now we’ll dig deeper and explore why some hits just feel bad.

This video demonstrates some more advanced concepts of parity: YouTube (opens new window)

Flow is arguably the most important concept in mapping - how each arm travels to move from one hit to the next. This can be as simple as alternating between "forehand" and "backhand" notes, or as complicated as thinking about how one arm interacts with the other at the edges of the playspace. Since the player must see blocks in order to react to them, flow highly depends on speed and difficulty. Slower songs are far more forgiving and flexible with regards to flow, while a fast song is highly limited.


Still learning and not seeing some of the errors testplayers point out? Check out GalaxyMaster's parity checker (opens new window) to spot any parity breaks!

# Block Directions & Positions

Each swing a player makes leaves their arm in a new position. At hard difficulty and higher, the player will leave their arms in this new position while waiting for the next motion. The block that follows must consider the position of the arm.

Poor Positioning Poor Angles Good Position & Angle
Example of Poor Positioning Example of Poor Angle Example of Good Positioning and Angle
You can see here that the arm is not ready to hit down from the position it is left in. In order to hit the next block, the arm has to do a lot of extra motion to wind up. Taking both into consideration, you are left with a smooth motion.
  • Each block has a limited selection of following blocks that feel good to play.
  • It takes longer wind up for less optimal hits and more suggested motion to play, be it from another block, bombs, or walls.
  • Faster songs have less time to see and comprehend the next block, leaving the mapper with more limited options for patterns. Vision blocking notes/walls are risky for this same reason.
  • Counter-clockwise wrist motions are preferred with the right hand and clockwise wrist motions are preferred with the left hand. Try it yourself and feel the difference!

Sorted by how awkward they are for the right hand, left being the most awkward and right being the least. Note that this is mirrored for the left hand (Red Notes).

Awkward Backhands: Blue Note Down-left Blue Note Down Blue Note Left
Questionable Backhands: Blue Note Down-right
Awkward Forehands: Blue Note Up-right Blue Note Up Blue Note Right
Questionable Forehands: Blue Note Up-left

If you have to make either a double backhand/forehand or one of the awkward backhands/forehands, the result is a DD or a triangle pattern.

# Suggested vs. Required Motion

When mapping unusual patterns that break typical conventions for flow, extra motion is suggested to make the pattern work. An example is a scoop:
In order to hit the up note following the side note, the arm must take a longer scooping path to be in position. This motion is suggested, where an extra note block down would require the motion instead.

Suggested motion is risky due to the fact that players will read and react to patterns differently than intended. One player may hit a scoop as intended, but another player may recoil and flinch given the pattern and have a negative experience from the pattern. This problem can never be entirely avoided when suggesting motion rather than requiring. Clever use of bombs, walls, or crossovers can help suggest more strongly the intended motion, but must be used with care to avoid vision, tangle, or flow issues.

# Soft Resets

Soft resets are resets where implied motion strongly suggests resetting the hand. The most common example of this is a half-double, present in many maps. This is where a down double followed by a single up followed by a down double, where its implied that both arms should raise on the single up despite only 1 note being there.

While these patterns allow for more freeform dancey motion, they are very difficult to sightread and throw the player off of their natural rhythm. This is due to the fact that only one of the two hands on a soft reset feels the haptic feedback of slashing a note. These are best used when the player is familiar with the rhythm and motion, and requires a large offset to see them approaching.

# Arm Tangles

Arm tangles happen when a pattern requires one arm to swing through another arm’s spot. Care must be taken to ensure that crossovers at risk of tangling are either kept above/below the other arm, or returned to their side before the other arm’s next hit.

Slower maps typically reward dancier and larger arm motions, causing arm tangles to have a stronger negative impact. On the other hand, faster maps typically are hit with less full-arm motion and can cheat arm tangles by having just the tip of the saber hit crossovers.

# Crossovers

Crossovers happen when one arm swings to the opposite side of the playspace. This is a challenging motion reserved for harder difficulties or slower maps. Crossovers open up the playspace for many interesting patterns so long as they are handled with care.

When swinging far from the natural position of the arms, bad flow is more pronounced. Additionally, the risk of arm tangles arises when crossovers do not consider the positions of notes to unwind the player during or after the sequence.

# Spacing

Spacing is the distance between notes on the grid. The further apart two notes are on the grid (ignoring time), the larger the spacing. In general, larger spacing requires larger motions to hit and requires either larger arm motion or very precise wrist motion. Spacing is larger horizontally than vertically due to the extra rows. Inverted notes (up arrows in the bottom row and down arrows in the top row) create the largest spacing due to the fact that the player must swing from outside the grid to hit these blocks.

# Walls

Walls are a versatile tool in maps that are often overlooked. They provide the most direct way to influence full body motion, as well as an immersive visual element. Overuse/misuse can lead to visual clutter or full vision blocking- so care must be taken. Treat any wall placed in either of the middle two lanes as a vision block for that lane, as they block the same (if not more) space. Additionally, walls placed in both middle lanes at the same time are never acceptable - most players cannot safely move out of the way within their playspace. Even players who are able to dodge these walls will not enjoy the amount of movement required.

# Moving the Player with Walls

Walls are a way to encourage the player to move left, right, down, or a combination of the three while playing. They are extremely powerful at doing this since players cannot touch them for too long.

# Dodge Walls

Left and right movement should feel natural and never be forced.

  • The note pattern should already encourage the player to move in that direction.
  • There should be enough space between walls if using left/right back to back.
    • Often 1 beat between the end of one and the start of next is enough. Though depending on the BPM more space is required.
  • Groove Walls are a situational exception to this but, are hard to execute correctly.

# Crouch Walls

Down movement is trickier as it is easier to do more harm than good.

  • Most players dislike crouch walls, be very selective when using them.
    • Crouch walls should be avoided when the jump distance is very short and NJS is high as they make even fully telegraphed crouch walls too fast to react to.
  • Keep them short, there’s rarely a good reason to have them longer than 1-2 beats.
  • If you are ending a crouch wall with notes just after, be extremely careful with what direction you start (up/down).
    • Starting down too quickly is uncomfortable and almost always unnecessary.
    • Starting up too late is also awkward.
  • It is easy to justify a crouch wall if the lyrics in a song say "down", "under", or any other reference to a downward motion.
  • Side notes are more natural to hit while under a crouch wall than up/down notes.
  • It is better to have a crouch wall end early than late as it plays better for any player in general. Especially those who have physical trouble crouching for too long.
    • If your crouch wall is longer than 1 beat, shorten it by 0.5.
    • If less than 1 beat and greater than 0.5, shorten by 0.25.
    • Otherwise, leave it.

# Aesthetic Walls

These walls are one option for adding a visual element to the map close to the player. They narrow down the field to a smaller region, making notes feel closer together and faster approaching. They can also be used to represent sounds not mapped by notes, or even used to flesh out quiet/slow/vocal drifting sections.

Using Mapping or Noodle Extensions opens up a huge space of possibilities by allowing walls to be of almost any height, width, and location but, requires a significantly larger amount of effort and is not playable without the respective mod. See Extended Mapping for more info.

# Bombs

The opposite of notes, bombs count as misses when they are hit. This opens up more opportunities for patterns, but have significant limitations. Notes specify the direction, timing, and hand all in one block. Bombs, on the other hand, have very little limitation imposed on the player.

Just as notes are placed with flow in mind, bombs should be placed as well! Bombs located where the sabers will be after swinging will not flow well due to the abrupt motion required to avoid it. Bombs placed at the same time as notes are particularly limiting as they either will restrict the swing path or offer little value to the map other than decoration.

Note that since bombs do not strictly define any motion, different players will approach bomb patterns with different motions. Care must be taken to ensure bomb patterns are easy to read and smooth to play, otherwise they will cause frustration.

As a result, bombs are not often used in maps other than for bomb resets. Bomb resets are a way to reset both hands to the same direction, but if used too quickly will feel abrupt and uncomfortable. This can be remedied by having notes immediately before the bomb reset guide the player to resetting more smoothly.

# Sliders

Sliders are the use of multiple notes at different times all hit with the same swing. They fit well for sounds that are sustained for slightly longer than a normal note, but have significant restrictions.

Conventionally, sliders are started with an arrow block and followed with dot blocks spaced at 1/16 or 1/24 from the original block. Sliders slower than these precisions require the player to alter their swing speed to successfully hit, which is not desired. Sliders faster than these precisions are essentially stacks/towers.

The using 1/16 vs. 1/24 precision depends on bpm though 1/16 is a safe choice for most speeds. It is more important for sliders to be playable than to match with the rhythm. If a 1/8 sound is mapped with 1/8 sliders, it may be too slow to play comfortably in one swing.

Note that there are directions that work more comfortably than others. Namely, sliders should travel clockwise for the left hand, and counterclockwise for the right hand. Sliders are almost always restricted to 3 notes or less, as changing directions mid-slider is extremely difficult to score well on. Sliders that end in the opposite lane (Such as left (Red) sliders ending in the rightmost lane) are easy to miss.

Sliders can also cause significant vision blocks when use in bulk even if the center two positions are not used due to how much visual space the dots fill. Window sliders (3-note sliders that omit the center note) can be used to avoid face notes and clear up vision, but risk being hard to read.

# Inverts

Inverts are notes that are placed in a location which forces the player to swing considerably more than if they were located in a more traditional position. They add emphasis to the map and require proper setup to play comfortably.

Be aware that inverts can be quite hard to read especially in rapid succession or at higher speeds.

Example placements
Invert Example

# Note Alignment for MMA2

It is not apparent in MMA2 but this is how some notes align in game.

MMA2 Alignment Example

# Single Saber/Handedness Switches

Alternating the hand leading a pattern can be highly effective at providing variety, interesting motions, or unique rhythms but have limitations.

Typically the player expects patterns to be in the sequence of: Blue Down To > Red Down To > Blue Up To > Red Up

Deviating from this can allow for unique motions and crossovers without tangling, but risks being challenging to read or play at higher speeds. For example if done mid-pattern, it requires one hand to flick twice as fast. While this might not be an issue for slower patterns, faster ones with less visibility or more aggressive motions can be problematic.

# Reading vs. Reacting to Notes

Fundamentally, the player needs to know how to swing in order to follow notes. As speeds increase, the time to read, process, and move accordingly decreases. This is tempered by following convention at higher speeds, such as following the alternating hand sequence as mentioned in the previous section.

Triangles, switch-ups, unexpected doubles, bombs, walls, etc. can all throw off the expected "reaction" the player will have to incoming notes. This is the reason why offset is so important to consider as dancey, slower patterns need extra time to read and process what approaches while faster songs must keep the screen less cluttered to allow players to follow instinct.

# High Speed Mapping

Playstyle slowly changes as the map reaches extreme speeds (around 200+ BPM). For slower songs, it is easier to perform large arm swings and contort the whole body to hit more unusual patterns. While at high speeds, there is very little time to process what approaches and the game becomes a combination of instinct, precision, and stamina. Patterns and placement gets more and more limited, and visibility becomes of the essence.

Hidden blocks will be virtually invisible at extreme speeds due to the short amount of time that blocks remain on screen. Inlines, 2-column streams, hitbox-abusing patterns, and large spacing one-handed jumps all become exponentially more problematic as speeds approach extreme speeds. Other, normally innocuous patterns also become challenging including double spam, complex streams, wide hits, and sliders.

While mapping, it is recommended to slow down playback speed of the song to time notes to the song as accurately as possible.

# Variable BPM Songs

If, while mapping, you notice that your song was properly aligned but suddenly changes or starts to fall off beat, then it's likely a BPM issue.

If the alignment suddenly and dramatically shifts for large parts of the song, but it seems consistent, it is likely your map has multiple BPMs. Depending on how often it occurs, this is relatively easy to fix. You can simply cut the map up into pieces where the grid becomes unaligned, and then run each one through Arrow Vortex to find the correct BPM for each part. You can then use BPM blocks to readjust the grid to align to the beat.

However, if the grid is less consistent and drifts around being aligned with no dramatic changes, then it is likely your song has a drifting BPM. This is common in older songs. This can be more of a hassle to deal with, but it is possible to address. Please see the variable BPM guide for more information.

# Downmapping

"Downmapping" is the process of taking your initial difficulty, and then breaking it down to be appropriate for other skill levels. As most mappers start with expert+ or expert, the process is usually referred to as "downmapping", since you work your way down through the difficulties. However, some people can and do work in the reverse, or even just map difficulties sporadically as they see fit. That said, starting from the top and working down gives you the benefit of saving time on timings, as expert+ is typically mapped to all of the most prominent rhythms.

While it takes a bit more time to downmap, as opposed to releasing just a single difficulty, the results can be very dramatic. Having multiple difficulties, and especially full spreads, helps to keep your maps accessible to a wide audience, as well as making your maps look more professional. A solid difficulty curve keeps players coming back to your maps over and over again as they improve, and allows you to build a reputation among all levels of players that will stick with them for all your future maps. While not every mapper is concerned with big download numbers or cultivating a larger playerbase, downmapping is still something to consider at any point in a mapper’s journey.

The key to downmapping lies in having a solid understanding of what is fun, and playable, for players of various skill levels. However, another important aspect to consider is how well you’ve represented the music within your mapping. It’s easy enough to throw together a map that a hard player can pass, but the magic of your initial difficulty can be lost if you do not properly translate it to the lower difficulties. You should know what the ‘key’ moments in your song are, and make sure you are highlighting them across all the difficulties. This sometimes requires coming up with multiple - but similar - patterns that fit a wide skill range, but it’s very important to keep life in your map.

You can check out the Basic Mapping guide for some basic structural guidelines on what is and isn’t appropriate for various difficulties. Keep in mind that NPS is NOT a great indicator of difficulty, and pattern complexity is far more important. While your difficulties should gradually drop in NPS as you go down, sometimes slower songs will have more changes in patterns than anything else, and that’s okay.


Beat Saber’s five set difficulties can create issues for some spreads. It’s perfectly acceptable to have a spread that is considered to be very difficult, but you should consider pushing your labels up if this is the case. A hard player that is expecting to play a hard difficulty, but actually finds a low expert+, is not going to have a fun time.

# Easy

Easy is, essentially, the "Grandma Difficulty". Players that can only pass easy maps likely have zero experience with video games, and especially not VR. It is very, very easy to take for granted how much innate knowledge you might have from growing up in a digital age. VR is extremely overwhelming for someone that has never experienced anything even remotely similar to it. Your map might be the first VR experience the player ever has!

Keeping that in mind, it’s important to keep your easy difficulty as simple as you can. Easy players are soaking in the experience and are learning the most basic of fundamentals, including which arm is which, and even how to orient themselves within a virtual world. They prefer to play the game as a very slow drumming simulator. Outward horizontal swings are a nice way to keep things interesting, as are the occasional dot notes, which they will likely stab.

# Normal

Most players will start playing Beat Saber on the normal difficulty. You can expect the normal player to be less distracted and have a larger grasp of Beat Saber’s core premise as a game. They are more likely to understand obstacles and actually read notes, as opposed to just swinging at them.

That said, they still need a good amount of time to properly react and recover, especially from big moments in a map. They will reset at any given opportunity and predominantly enjoy the "drumming" style of play. Big, flashy movements with a lot of time before and after are a great way to win a normal player’s heart.

# Hard

Hard is where Beat Saber as a game really begins. Players with any sort of background in VR, or even video games as a whole, will likely start off at this difficulty, or will very quickly graduate to it within a matter of hours. Core mapping principles become very important in hard, although the slower speed (compared to expert and above) can make some patterns less egregious. Flow, in particular, should become standard, and every swing should obey parity, although hard players will still reset given enough time.

Hard players will have an understanding of the mechanics of the game, including how the scoring system is operated. Players in this range are starting to be introduced to different styles of mapping, and may begin to prefer certain styles or gravitate towards competitive play. It’s important to make sure your hard difficulty has some sort of identity, and properly represents the music. Some hard players will be more drawn towards dance maps and larger movements, while others will start to really enjoy very simple and short streams that rely on speed. Consider your hard difficulty to be the entrypoint for your specific mapping style. It should be an introduction to skills they will need in the later difficulties.


Hard and Expert are considered some of the hardest difficulties to map for. If you’re struggling, try finding a lower skilled player to play your map! You don’t need in-depth feedback; simply knowing if something is too difficult or unfun can be very important.

# Expert

Your expert difficulty should continue to grow and expand upon the style introduced in hard. An expert player can typically do everything at some level; they can read complicated patterns, can play at 1/4 speeds for longer periods of time, and can generally play the game at a higher level. However, it is a trade off. Complicated crossovers, or dramatic jumps, for example, should not be done at high speeds. Sightreading is still a skill that is being developed for most expert players, and you should make sure you’re giving the player enough time to react.

For non-dancy expert maps, standard mapping conventions become very, very important. Everything should be comfortable and flow well. Even on dancey maps, you should still very carefully weigh the pros and cons of utilizing anything like a 90 degree hit, for example. Expert players tend to have higher standards and will expect more of the map. Most emphasis options are on the table for expert, but you may still need to make adjustments from your expert+ patterns to better suit expert players.

As a whole, expert players tend to enjoy more horizontal movement and good usage of diagonals with flashy doubles as emphasis. Single saber patterns, especially simple polyrhythms, can be a great way to elevate an expert map in a way they enjoy. Be wary of cutting down fast streams from your Expert+ difficulty to slower jumps for Expert; this can be equally as difficult for Expert players, as a good portion play with a lot of arm movement. Excessive top lane hits at fast speed can also be very challenging.

# Expert+

Expert+ can vary greatly and is quite open-ended. However, if you have a spread that works its way up to Expert, consider if the song can actually support an Expert+ difficulty. It's okay to not include one if the difference between your Expert and Expert+ would be minimal. Be wary of overmapping!

# Swing In a Song and How Shuffle Helps


This is a stub section. If you’d like to contribute, submit suggestions via this form (opens new window).

See this guide by Sykes What swing is, and how "shuffle" will make your mapping easier (opens new window) on how to use the built in shuffle feature to make mapping songs that have swing easier.

# Credits

Content in this section was authored by Checkthepan, CyanSnow, Uninstaller, Skyler Wallace, Kolezan, Pyrowarfare, DarkGrisen and Vaser888.