Rizline:Chart file: Difference between revisions
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
''[[Rizline:Rizline|Rizline]]'' chart files use the [[JSON]] file format. A chart file contains information about colors, lines, notes, challenge time, BPM and other information. | ''[[Rizline:Rizline|Rizline]]'' chart files use the [[Wikipedia:JSON|JSON]] file format. A chart file contains information about colors, lines, notes, challenge time, BPM and other information. | ||
== JSON structure == | == JSON structure == | ||
| Line 12: | Line 12: | ||
{{DataStructureField|challengeTimes|array|Challenge times of the chart; currently there is always exactly one challenge time, but there could be more in the future. {{verify|This was written before Rizline 1.1 - this is outdated}}| | {{DataStructureField|challengeTimes|array|Challenge times of the chart; currently there is always exactly one challenge time, but there could be more in the future. {{verify|This was written before Rizline 1.1 - this is outdated}}| | ||
{{DataStructureField||object|A challenge time.| | {{DataStructureField||object|A challenge time.| | ||
{{DataStructureField|checkPoint|float|Purpose currently unknown.}} | {{DataStructureField|checkPoint|float|Purpose currently unknown. {{verify}}}} | ||
{{DataStructureField|start|float|Start of challenge time (in beats).}} | {{DataStructureField|start|float|Start of challenge time (in beats).}} | ||
{{DataStructureField|end|float|End of challenge time (in beats).}} | {{DataStructureField|end|float|End of challenge time (in beats).}} | ||
{{DataStructureField|transTime|float|Transition time (in beats).}} | {{DataStructureField|transTime|float|Transition time (in beats). {{verify|The transitions seem instant in game, what is this actually?}}}} | ||
}} | }} | ||
}} | }} | ||
| Line 22: | Line 22: | ||
{{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||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 ( | {{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 (or beats!). Always <code>0.0</code>. {{verify|Is this still true?}}}} | ||
{{DataStructureField|lines|array|List of all lines in the chart. This part usually takes up most of the chart file.| | {{DataStructureField|lines|array|List of all lines in the chart. This part usually takes up most of the chart file.| | ||
{{DataStructureField||object|A line.| | {{DataStructureField||object|A line.| | ||
| Line 50: | Line 50: | ||
{{DataStructureField||color key point object|A color change. See [[#Color key point object structure]] for details.}} | {{DataStructureField||color key point object|A color change. See [[#Color key point object structure]] for details.}} | ||
}} | }} | ||
{{DataStructureField|lineColor|array| | {{DataStructureField|lineColor|array|Gradient line color changes, based on time.| | ||
{{DataStructureField||color key point object|A color change. See [[#Color key point object structure]] for details.}} | {{DataStructureField||color key point object|A color change. See [[#Color key point object structure]] for details.}} | ||
}} | }} | ||
| Line 68: | Line 68: | ||
{{DataStructureField|cameraMove|object|Changes of camera position.| | {{DataStructureField|cameraMove|object|Changes of camera position.| | ||
{{DataStructureField|scaleKeyPoints|array|Scale/zoom changes of the camera in the song.| | {{DataStructureField|scaleKeyPoints|array|Scale/zoom changes of the camera in the song.| | ||
{{DataStructureField||key point object|A scale change. {{ | {{DataStructureField||key point object|A scale change. {{Unfinished|Which values correspond to zooming-in vs. zooming out?}} See [[#Key point object structure]] for details.}} | ||
}} | }} | ||
{{DataStructureField|xPositionKeyPoints|array|Position changes of the camera in the song.| | {{DataStructureField|xPositionKeyPoints|array|Position changes of the camera in the song.| | ||
| Line 106: | Line 106: | ||
=== Ease type enum === | === Ease type enum === | ||
{{ | {{Unfinished|This enum is currently unknown - to fill it, we have to find ease types in official charts and compare them to curves on https://easings.net/ .}} | ||
<ul> | <ul> | ||
| Line 149: | Line 149: | ||
{{DataStructureField|time|float|Time of the start of the key point (in beats).}} | {{DataStructureField|time|float|Time of the start of the key point (in beats).}} | ||
}} | }} | ||
== Navigation == | |||
{{RizlineGameNavBox}} | |||