Rizline:Chart file: Difference between revisions

From Rhythm Game Wiki
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 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:
    • 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.
      • (line object) - A line

Theme object structure

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