Rhythm Game Data

Introduction

This is a new home for data on rhythm games, designed to power card draw and other technical needs.

This is currently a work in progress. Eventually you will be able to follow along (or contribute!) at github.com/RhythmGameTools/rgt-data

JSON Schema

Currently this site provides only a JSON Schema definition describing a valid data shape for what will eventually be hosted here. The schema's permanent URL is https://data.ddr.tools/schema/v1.json.

Broadly, it describes that a game data file is a JSON document containing:

• Metadata about the game in the `meta` key
• Default card draw configuration in the `defaults` key
• Translations for game-specific terms in the `i18n` key
• And songs as an array under the `songs` key

Each song is an object containing:

• `name`, `artist`, `bpm` and other base info
• `flags` as an array of strings that help filter songs
• a `jacket` key with a string indicating where to find a jacket image
• and most importantly, `charts`, an array of playable charts for the song

And each chart must be an object including:

• `style` e.g. "single" or "double"
• `diffClass` e.g. "difficult", "expert", "challenge", etc
• `lvl` a integer number indicating difficulty level
• and optionally, some overrides of fields found on the song, such as `jacket`, `flags`, etc

Data Files

Eventually all data files powering ddr.tools will be hosted here, available programatically to others for any purpose.