RPE Chart Root Structure

Warning: This page was written based on RPE 1.4.1 as of 2024-07-25. Information such as added versions for older content has not been added yet.

Root structure

BPMList

BPMList is a JsonArray of JsonObjects. Each object has:

Field	Type	Description	Version
bpm	float	BPM value	-
startTime	beat	BPM start time	-

META

META is a JsonObject with:

Field	Type	Description	Version
RPEVersion	int	RPE version, 100–160	-
background	string	Background image path relative to chart root	-
charter	string	Charter name	-
composer	string	Composer	-
id	string	Chart ID (used by RPE to identify chart)	-
illustration	string	Illustrator	141
level	string	Chart level	-
name	string	Chart name	-
offset	int	Music offset in milliseconds	-
song	string	Music file path relative to chart root	-

• When offset is negative, music starts -offset ms before chart start; when positive, offset ms after.
• When auto-generated by RPE, id is a long; in practice it can be any string.

DANGER

RPE 1.5.0–1.6.0 (excluding 1.6.0, including Alpha): META RPEVersion stayed 150.

DANGER

RPE 1.6.1: META RPEVersion stayed 160.

chartTime

Not needed for simulators.

• chartTime is a double in seconds (editing duration), added in version 141.
• If RPE loses focus, timing continues; when focus returns, time is rolled back to when focus was lost. The previous behavior where the timer stopped changing after 30 seconds of inactivity has been removed.

judgeLineGroup

Not needed for simulators.

• judgeLineGroup is a string[]; each string represents a judge line group. Its exact behavior still needs to be documented.

judgeLineList

• judgeLineList is a JsonArray of JudgeLine.

multiLineString

Not needed for simulators.

• multiLineString is a string for RPE multi-line editing: space-separated numbers for judge lines. 1:20 selects lines 1 through 20.

multiScale

Not needed for simulators.

• multiScale is a float for scaling the multi-line edit view in RPE.

xybind

Simulators may ignore.

• xybind is a bool: whether X/Y are bound. If true, every XEvent has a matching YEvent of the same length.