Editing Rizline:Chart file

''[[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.

== 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 format versions?}}}}
  {{DataStructureField|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.}}
  {{DataStructureField|themes|array|List of themes; there is always two {{verify|This was written before Rizline 1.1 - is this still correct?}} themes:|
    {{DataStructureField|0|theme object|Default theme. See [[#Theme object structure]] for details.}}
    {{DataStructureField|1|theme object|Challenge-time theme. See [[#Theme object structure]] for details.}}
  }}
  {{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|checkPoint|float|Purpose currently unknown.}}
      {{DataStructureField|start|float|Start of challenge time (in beats).}}
      {{DataStructureField|end|float|End of challenge time (in beats).}}
      {{DataStructureField|transTime|float|Transition time (in beats).}}
    }}
  }}
  {{DataStructureField|bPM|float|Initial BPM of 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|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|lines|array|List of all lines in the chart. This part usually takes up most of the chart file.|
    {{DataStructureField||line object|A line}}
  }}
}}

=== Theme object structure ===

{{DataStructure|
  {{DataStructureField|colorsList|array|List of colors; there are always 3 {{verify|This was written before Rizline 1.1 - is this still correct?}} colors:|
    {{DataStructureField|0|color object|Background color. See [[#Color object structure]] for details.}}
    {{DataStructureField|1|color object|Note color. See [[#Color object structure]] for details.}}
    {{DataStructureField|2|color object|Particle color. See [[#Color object structure]] for details.}}
  }}
}}

=== Color object structure ===

{{DataStructure|
  {{DataStructureField|r|int|Red value (from 0 to 255).}}
  {{DataStructureField|g|int|Green value (from 0 to 255).}}
  {{DataStructureField|b|int|Blue value (from 0 to 255).}}
  {{DataStructureField|a|int|Alpha value (from 0 to 255).}}
}}