Rhythm Lunatic edited this page Aug 17, 2018 · 15 revisions


StepMania is a free and open source, cross-platform rhythm game. It supports common key-based rhythm game formats (including 4-panel and 5-panel dance games among others), as well as keyboard and dance pad controllers. It is customizable with user-made add-ons such as themes, and provides an integrated editor for creating your own simfiles.

StepMania can also be used with dance game cabinets, and has been used as the basis for several major commercial products including Pump it Up Infinity and Step Maniax.

Hey, listen!

The docs need a TON of work! Please ask on the forums and suggest anything you think should be in here. We devs know way too much detailed technical stuff and it's hard to pick up what people actually want to know - so any requests for documentation are really welcomed.

Command Line

StepMania accepts a number of command line arguments.

  • --theme="themename" - Sets the theme to use.
  • --language=lang - Sets the language to use.
  • --ExportLuaInformation - Exports Lua documentation to Lua.xml.

Basic Engine Info


User data locations

Supported file formats

Supported games

Play modes


Charting Help

Note types

Timing segments

Label segments

Note And Timing Gimmicks

(advanced) NewField Mod System

Theming Help





Programming Help

Compiling StepMania

Adding new lua functions

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.