Note

Each note has these parameters:

Field	Type	Description	Default	Version
above	int	1 = from front of line, other = from back	1	-
alpha	int	Opacity; 0 transparent, 255 opaque	255	-
endTime	beat	End time; for type 2 (Hold) = Hold end, else = startTime	-	-
startTime	beat	Start time; for Hold = Hold start, else = endTime	-	-
isFake	int	1 = fake, other = real	0	-
positionX	float	X offset from line center	-	-
size	float	Size multiplier (in RPE this is width only)	1.0	-
speed	float	Speed multiplier	1.0	-
type	int	Note type; see table below	-	-
visibleTime	float	Visible time in seconds	999999.0	-
yOffset	float	Y offset (positive = up); also moves hit effect	0	-
hitsound	string?	Custom hit sound path relative to chart root	-	142
judgeArea	float	Judge area width multiplier	1.0	170
tint or color	int[3]	Note color [R,G,B] 0–255	[255,255,255]	170
tintHitEffects	int[3]?	Hit effect color [R,G,B]	[255,255,255]	170

• The size field actually corresponds to the width in RPE, meaning it only controls the width of a note, not its entire size.
• The above field is set to 2 for Hold notes that fall from the back by default. For all other notes, it is 0. However, if it is set to 1, the note will always fall from the front.
• The hitsound field does not exist if there is no custom sound effect.
• Fake notes do not have judgment, hit effects, or sound effects; they do not contribute to scoring or note count. If a note is a Hold, it will always be displayed in an unlit state.
• The color field is used to tint notes by applying vertex color multiplication, i.e., noteColor = noteColor * color.

DANGER

The color field has undergone a name change. Since the color version was used during public testing, later versions switched to tint. Therefore, either of these field names may be present in practice, while their definition remains the same. Please ensure compatibility accordingly.

• The tintHitEffects field is used to tint the hit effects of notes. When this field is present, regardless of whether the judgment is Good or Perfect, the hit effects will use this color (applied using the original material via vertex color calculation), with no additional computation required.

Note types

Value	Description
1	Tap
2	Hold
3	Flick
4	Drag
Default	Tap