Rizline:Chart file

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 like Plum - 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).
  • 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.
  • 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 0.0. ^[verify]
  • lines (array) - List of all lines in the chart. This part usually takes up most of the chart file.
    • (object) - A line.

      This page has some work to do. Help the wiki by editing this page!

  • canvasMoves (array) - Changes of canvas position.
    • (object) - A move pattern for one canvas. The index of the element in the array is the canvas index.

      This page has some work to do. Help the wiki by editing this page!

  • cameraMove (object) - Changes of camera position.

    This page has some work to do. Help the wiki by editing this page!

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).

Key point object structure

• (root)
  • time (float) - Time of the key point (in beats).
  • value (float) - Value of the key point.
  • easeType (int) - ID of the ease type used for this key point. See #Ease type enum for details.
  • floorPosition (float) - Pre-calculated time of the key point (in seconds). This value is not always accurate, or even present.

Ease type enum

This page has some work to do. Help the wiki by editing this page!
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/ .

• 0 - unknown
• 1 - unknown
• 2 - unknown
• 3 - unknown
• 4 - unknown
• 5 - unknown
• 6 - unknown
• 7 - unknown
• 8 - unknown
• 9 - unknown
• 10 - unknown
• 11 - unknown
• 12 - unknown
• 13 - unknown