Rizline:Chart file: Difference between revisions
Jump to navigation
Jump to search
Created page with "''Rizline:Rizline'' chart files use the JSON file format. A chart file contains information about colors, lines, notes, challenge time, BPM and other information. == JSON structure == {{DataStructure| {{DataStructureField|fileVersion|int|File format version. This is usually 0, but in some charts like <code>Plum - Tempest [IN]</code>, this is set to 1. {{verify|Are there more charts/more file format numbers? What is the difference between different file forma..." |
mNo edit summary |
||
Line 20: | Line 20: | ||
{{DataStructureField|bPM|float|Initial BPM of the song.}} | {{DataStructureField|bPM|float|Initial BPM of the song.}} | ||
{{DataStructureField|bpmShifts|array|Changes of BPM in the song.| | {{DataStructureField|bpmShifts|array|Changes of BPM in the song.| | ||
{{DataStructureField||key point object|The value of the key point is a multiplier of the initial song BPM. If the initial BPM is 120, then a key point with a value of 1.5 means a new BPM of 180. A value of 0.5 would mean the new BPM is 60. These key points, unlike other key points, are not interpolated in any way. The changes of BPM are always instant. The <code>easeType</code> property of the key point has no effect.}} | {{DataStructureField||key point object|The value of the key point is a multiplier of the initial song BPM. If the initial BPM is 120, then a key point with a value of 1.5 means a new BPM of 180. A value of 0.5 would mean the new BPM is 60. These key points, unlike other key points, are not interpolated in any way. The changes of BPM are always instant. The <code>easeType</code> property of the key point has no effect. See [[#Key point object structure]] for details.}} | ||
}} | }} | ||
{{DataStructureField|offset|float|Audio or chart offset. It is currently unknown if this value shifts the audio or the chart forwards, nor is it known if this value is in milliseconds or seconds (although it is more likely seconds). Always <code>0.0</code>. {{verify|Is this still true?}}}} | {{DataStructureField|offset|float|Audio or chart offset. It is currently unknown if this value shifts the audio or the chart forwards, nor is it known if this value is in milliseconds or seconds (although it is more likely seconds). Always <code>0.0</code>. {{verify|Is this still true?}}}} |
Revision as of 20:27, 1 December 2024
Rizline chart files use the JSON file format. A chart file contains information about colors, lines, notes, challenge time, BPM and other information.
JSON structure
- (root)
fileVersion
(int) - File format version. This is usually 0, but in some charts likePlum - Tempest [IN]
, this is set to 1. [verify]songsName
(string) - Title of the song; often it is an empty string. This seems to be a leftover value from charting software, it is unused in-game.themes
(array) - List of themes; there is always two [verify] themes:0
(theme object) - Default theme. See #Theme object structure for details.1
(theme object) - Challenge-time theme. See #Theme object structure for details.
challengeTimes
(array) - Challenge times of the chart; currently there is always exactly one challenge time, but there could be more in the future. [verify]-
(object)
- A challenge time.
checkPoint
(float) - Purpose currently unknown.start
(float) - Start of challenge time (in beats).end
(float) - End of challenge time (in beats).transTime
(float) - Transition time (in beats).
-
(object)
- A challenge time.
bPM
(float) - Initial BPM of the song.bpmShifts
(array) - Changes of BPM in the song.-
(key point object)
- The value of the key point is a multiplier of the initial song BPM. If the initial BPM is 120, then a key point with a value of 1.5 means a new BPM of 180. A value of 0.5 would mean the new BPM is 60. These key points, unlike other key points, are not interpolated in any way. The changes of BPM are always instant. The
easeType
property of the key point has no effect. See #Key point object structure for details.
-
(key point object)
- The value of the key point is a multiplier of the initial song BPM. If the initial BPM is 120, then a key point with a value of 1.5 means a new BPM of 180. A value of 0.5 would mean the new BPM is 60. These key points, unlike other key points, are not interpolated in any way. The changes of BPM are always instant. The
offset
(float) - Audio or chart offset. It is currently unknown if this value shifts the audio or the chart forwards, nor is it known if this value is in milliseconds or seconds (although it is more likely seconds). Always0.0
. [verify]lines
(array) - List of all lines in the chart. This part usually takes up most of the chart file.- (line object) - A line
Theme object structure
- (root)
colorsList
(array) - List of colors; there are always 3 [verify] colors:0
(color object) - Background color. See #Color object structure for details.1
(color object) - Note color. See #Color object structure for details.2
(color object) - Particle color. See #Color object structure for details.
Color object structure
- (root)
r
(int) - Red value (from 0 to 255).g
(int) - Green value (from 0 to 255).b
(int) - Blue value (from 0 to 255).a
(int) - Alpha value (from 0 to 255).