CRS File Format

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

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

The following rules govern the course type:

Nonstop: Will appear if there is no #LIVES tag and #REPEAT is OFF.
Challenge (Oni): Will appear if there is a #LIVES tag and #REPEAT is OFF.
Endless: Will appear if #REPEAT is ON.

Header

#COURSE:...; - name of the course
#LIVES:<0..10>; - An integer between 0 and 10. This line is optional.
#REPEAT:<YES|NO>; - start over after last stage?
#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:*:8..10:1.5x,reverse;

A random song within a group:

       #SONG:<group folder>/*:(<difficulty>|<meter range>):<modifiers>;
       example: #SONG:Classical/*:3..6;
       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.5x, 0.75x, 1.5x, 2.0x, 3.0x, 4.0x, 5.0x, 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

#MODS

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.

Format

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

Example

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