Skip to content

ChartInfo

Introduction to chart basic information.

Tips

All fields on this page have compatibility level 0.

JSON Example

json
{
  "Name": "UnTitled",
  "Author": "Unknown",
  "IllustrationAuthor": "Unknown",
  "IllustrationData": [],
  "SongAuthor": "Unknown",
  "SongOffset": 0,
  "SongData": [],
  "Level": "UK  Lv.0"
}

Structural specifications

Unique IdentifierFieldTypeDescriptionDefault ValueAdded Version
1NamestringChart NameUnTitled1
2AuthorstringChart AuthorUnknown1
3IllustrationAuthorstringIllustration AuthorUnknown1
4IllustrationDatabyte[]?Illustration Datanull1
5SongAuthorstringSong AuthorUnknown1
6SongOffsetintThe time offset between the song start and the chart, in milliseconds01
7SongDatabyte[]Song Data-1
8LevelstringChart Difficulty LevelUK Lv.01

Field Behavior Rules

  • IllustrationData stores binary illustration data, usually in PNG or JPEG format
  • IllustrationData can be null, meaning no illustration is provided. A default black image is recommended in this case.
  • SongData stores binary song data, usually in MP3 or OGG format.
  • SongOffset adjusts the song's start time in milliseconds. Can be negative.
  • In the Level field, UK and Lv must be separated by two spaces.

Proto Paragraph

protobuf
syntax = "proto3";
package PhiCommonChart.ChartStructs;

message Info {
   string Name = 1;
   string Author = 2;
   string Level = 3;
   string IllustrationAuthor = 4;
   bytes IllustrationData = 5;
   string SongAuthor = 6;
   int32 SongOffset = 7;
   bytes SongData = 8;
}