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
The following rules govern the course type:
- Nonstop: No special tags are used.
- Challenge: The
#LIVEStag is set to 1-10.
- Endless: The
#REPEATtag 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 (ExtraX.crs):
battery, 1 life, 4 lives, norecover, suddendeath
#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:;