Ninja Level Design Basics

Good arcade levels teach without tutorials and pace without pausing. Here are the working rules behind the courses in these games, useful whether you play or build them.

Arcade level design has one hard constraint: the player will not read anything. Every rule below follows from that.

Rule 1: teach with the level, not with text

A player who has to be told how something works has already been let down. Good design introduces a mechanic in a place where failing is cheap.

The standard pattern is introduce, repeat, combine:

  1. Introduce the wall in isolation, with nothing else happening and plenty of space.
  2. Repeat it with a small variation — a taller wall, a different approach speed.
  3. Combine it with something learned earlier.

Ninja Obstacle Master applies this across the whole run rather than within a level: wall towers only enter the block pool after 6,400 pixels, by which point the player has spent minutes on jumps and slides.

Rule 2: stay inside the reachability envelope

Every character has fixed movement limits. In Mystic Ninja: an apex of about 122 pixels, air time of 0.70 seconds, and roughly 210 pixels of horizontal reach.

Generation is constrained against those numbers — pits capped at 78% of the reach, floating platforms at 82% of the apex. The margins are what make an imperfect jump survivable.

This is the rule that cannot be broken. A level outside the envelope is not hard, it is broken, and players correctly stop trusting a game that produces one.

Rule 3: mark the intended route with collectibles

Collectibles are the quietest teaching tool available.

In Ninja Dash, coin arcs mirror the shape of the jump needed to clear the obstacle beneath them. In Ninja Obstacle Master, stars sit on the designed line through each block. A player following the collectibles is executing the intended solution without ever being told what it was.

The corollary is equally useful: when a collectible sits somewhere awkward, that marks the risky route. The game is offering a bet rather than a gift.

Rule 4: pace with lulls

An unbroken sequence of obstacles is exhausting and unreadable. Ninja Obstacle Master leaves 160 pixels of clear ground between blocks; Ninja Dash derives its spacing from the current speed.

Those quiet stretches are not filler. They are where the player resets their eyes, re-establishes position and prepares. Without them there is no rhythm, only noise.

Rule 5: forbid the unfair combination

Some pairs are structurally impossible regardless of spacing, because they require two actions inside one uncancellable animation.

A slide beam followed by a gap is the standard example. Ninja Dash's spawner refuses it outright.

Most generators need a short list of these prohibitions. Writing that list is unglamorous work and it is the difference between a game players trust and one they abandon.

Rule 6: make the risky route optional and visible

Good levels offer two paths: a safe one and a rewarding one. The player should be able to see both and choose.

Mystic Ninja puts most gems on the floating platforms while the ground remains faster and safer. Neither is wrong. The choice is the content.

What breaks this is making the rewarding route mandatory, which removes the decision, or hiding it, which removes the informed part of the informed choice.

Rule 7: fail fast, restart faster

An arcade level should end quickly when the player makes a mistake, and restart immediately.

Mystic Ninja restarts the current level with score and collected gems intact; every other game here restarts on a single key press. The point of a restart is to let the player try a different plan while the last one is still in memory — anything that slows it down wastes that.

Key takeaways

  • Teach with the level: introduce a mechanic in isolation, repeat it with variation, then combine it.
  • Never generate outside the character's real movement envelope, and leave a margin inside it.
  • Collectibles mark the intended route — and awkward ones mark the risky one.
  • Pace with deliberate lulls; they are where the player resets.
  • Forbid structurally unfair combinations outright.
  • Offer a visible choice between a safe route and a rewarding one, and restart instantly after failure.

Frequently asked questions

How are arcade levels designed to teach without tutorials?

By introducing each mechanic where failing is cheap, repeating it with small variations, then combining it with something already learnt.

What is a reachability envelope?

The set of distances and heights a character can actually cover — derived from jump velocity, gravity and movement speed. Level generation must stay inside it.

Why do collectibles follow the obstacles?

They mark the intended solution. Following a coin arc usually means executing the jump the designer had in mind.

Are these games' levels hand-made or generated?

Both approaches appear here. Ninja Dash generates obstacles within rules; Ninja Obstacle Master uses hand-designed blocks in a random order; Mystic Ninja generates whole levels inside the jump envelope.

Ready to put this into practice?

Everything above is easier to feel than to read about. Open the game and try one run with just one of these ideas in mind.

Play Ninja Obstacle Master

Games covered in this guide

All games →