CRS File Format

(Redirected from The .CRS File Format)

CRS files define the courses used in the Nonstop, Challenge, and Endless modes.

All CRS files must reside in the "Courses" folder in the StepMania program folder. An example course location is Courses\default\

The following rules govern the course type:

  • Nonstop: No special tags are used.
  • Challenge: The #LIVES tag is set to 1-10.
  • Endless: The #REPEAT tag is set to ON.



  • #COURSE:...; - name of the course
  • #COURSETRANSLIT:...; - name of the course (transliteration)
  • #LIVES:<0..10>; - An integer between 0 and 10. Req. for Challenge course. 0 = Nonstop Course.
  • #REPEAT:<YES|NO>; - start over after last stage? Req. for Endless course.
  • #STYLE:...; This tag limits which style types can play this course to Single, Double, or your preference.
  • #SONG: - can use any one of the following formats:

#SONG and Examples

A fixed song:

       #SONG:<group folder>/<song folder>:<difficulty>:<modifiers>;
       example: #SONG:Nicolai Rimsky-Korsakov/Flight of the Bumblebee:BASIC;
       example: #SONG:Oldies/Jump Jive and Wail:MANIAC:sudden,shuffle,reverse;

A random song:

       #SONG:*:(<difficulty>|<meter range>):<modifiers>;
       example: #SONG:*:MANIAC;
       example: #SONG:*:11..20:1.5x,reverse;

A random song within a group:

       #SONG:<group folder>/*:(<difficulty>|<meter range>):<modifiers>;
       example: #SONG:Classical/*:5..10;
       example: #SONG:Techno/*:MANIAC:1.5x,reverse;

A players best song:

       #SONG:BEST<number>:(<difficulty>|<meter range>):<modifiers>;
       example: #SONG:BEST1:TRICK;
       example: #SONG:BEST4:MANIAC:1.5x,reverse;

A players worst song:

       #SONG:WORST<number>:(<difficulty>|<meter range>):<modifiers>;
       example: #SONG:WORST4:MANIAC;
       example: #SONG:WORST1:TRICK:1.5x,reverse,drunk;

Descriptions: group folder - The name of the folder that contains the song folder. (e.g. "Techno") song folder - the name of the folder that contains files for the song. (e.g. "Flight of the Bumblebee") difficulty - Can be one of the following: BEGINNER, EASY, MEDIUM, HARD, CHALLENGE. meter range - A value in the format "x..y" where x is the lowest meter allowed and y is the highest meter allowed. For example, the string "7..9" would choose only from songs with a meter of 7, 8, or 9. modifiers - A comma separated series of modifier strings. This value may be left blank. Any string you see on the Player Options screen is a modifier string. Some examples are:

     0.25x, 0.5x, 1.5x, 2.0x, 2.5x, 3.0x, 3.5x, 4.0x, 
     4.5x, 5.0x, 5.5x, 6.0x, 6.5x, 7.0x, 7.5x, 8.0x
     boost, wave, drunk, dizzy, space, mini
     hidden, sudden, stealth, blink
     mirror, left, right, shuffle, supershuffle
     little, reverse, note, flat, plain
     noholds, nofreeze, dark
     0.7xmusic, 0.8xmusic, 0.9xmusic, 1.0xmusic, 1.1xmusic,
     1.2xmusic, 1.3xmusic, 1.4xmusic, 1.5xmusic

Only for Extra Stages (

     battery, 1 life, 4 lives, norecover, suddendeath


The #MODS line goes before #SONG and is used to trigger mods mid-course (as found in ITG).

Beware: If a song is not loaded, mods meant for said song may stack on another song.


#MODS: TIME=(time to reach peak value):LEN=(duration):MODS=(modifiers):
#SONG:(as usual);


#MODS: TIME=20:LEN=30:MODS=expand:
#SONG:A Modded Song:HARD:;

Thanks to (donated web hosting)