Skip to content

song.ini Tags

Song/Chart Metadata

Tag Name Description Data type
cassettecolor Hex color to use in the song screen for the cassette. hex color
tags Miscellaneous tags for the chart.
Only valid value is cover.
string

Chart Properties

Tag Name Description Data type
hopofreq Overrides the natural HOPO threshold using numbers from 0 to 5.
No clue how it actually behaves, but here's my interpretation of the code based on what would be reasonable: 0 = 1/24th, 1 = 1/16th, 2 = 1/12th, 3 = 1/8th, 4 = 1/6th, 5 or higher = 1/4th.
Not recommended for new charts, use hopo_frequency instead.
number
early_hit_window_size Sets the "early hit window" size.
Valid values are "none", "half", or "full".
string
pro_drum Same as pro_drums? boolean
tutorial Marks a song as a tutorial and hides it from Quickplay. boolean
boss_battle Marks a song as a boss battle. boolean?

Save Data

Tag Name Description Data type
scores High score data. string
scores_ext Additional score data. string
count Play count. number

Career

Tag Name Description Data type
See Careers for details.
unlock_id Career ID for this song. string
unlock_require The career ID that must be completed to unlock this song. string
unlock_text Text to display if the song is locked. string
unlock_completed Indicates if the song is unlocked. number

Sources

These tags are sourced from existing song.ini files and from these resources: