VRChatワールド RESONARK 4 ELVES (世代) のシステムからエクスポートされるデータ (以下、プレイデータと表記する場合がある) の解説をします。
プレイデータの書き出し機能は Version 4.0.3~ 利用可能です。
プレイデータのご利用にあたって
下記の注意事項をご確認いただいた上、VRChatワールド RESONARKシリーズからエクスポートされたプレイデータをご利用ください。
・プレイデータを利用した結果のいかなる損害についてもsep-neko-ya (弊サークル) は一切の責任を負いません
・プレイデータのエクスポート機能や本ドキュメントは、予告なく提供を停止する場合があります
・本ドキュメントで解説されるプレイデータの仕様は正しいことを保証しません
・ユーザー側でデータを利用したサービス (アプリやWebサービス等) を作成することは自由ですが、非公式である旨を明記してください
非公式サービスでのプレイデータ利用は、利用先サービスの利用規約等を確認の上、利用者自身の責任で行うようお願い致します。
プレイデータ仕様
基本的にJSONとして読み出せる形を想定しています。
Example
{
"version": "1.0.0",
"items": {
"41012310401003010": {
"id": 1040100301,
"title": "Tutorial",
"dName": "Tutorial",
"score": 0,
"tRate": 0,
"state": 0,
"platform": 0
},
"410111": "2023/05/08 00:42:47",
"410110": "Player Name"
}
}
データ定義
JSON Key | 型 | 詳細 |
version | String | 出力データのバージョンが返却されます。 この記事作成時点での想定Valueは”1.0.0″となります。 |
items | Object | エクスポートデータの本体が格納されています。 |
items 以下のKey詳細
{WorldID}{DataType}{DataID}
例: `1112223333333`
名称 | 桁数 | 詳細 |
WorldID | 3 | ワールドID どのRESONARKワールドかを区別します |
DataType | 3 | データタイプ どのようなデータの種類かを区別します |
DataID | 可変 (0~) | データID データタイプに基づき、何のデータを表すか区別します |
ワールドID
ワールドID | 意味 |
410 | RESONARK 4 ELVES Pt.1 で記録されたデータ |
今後ワールドが追加される場合はこちらのワールドIDが追加されていきます。
データタイプとデータID
データタイプ | 意味 | データID | データIDの桁数 | Valueの型 | Valueの詳細 |
110 | プレイヤー名 | なし | 0 | String | VRChat Display Name そのまま |
111 | セーブ日時 | なし | 0 | String | yyyy/MM/dd HH:mm:ss |
123 | 楽曲リザルト | 楽曲ID (10桁) + プラットフォーム (1桁) | 10 | Object | 下記で詳細を解説 |
「楽曲リザルト」データタイプのObject
Key | Valueの型 | Valueの意味 |
id | Int | 一意の楽曲ID データIDと同一想定です |
title | String | 楽曲タイトル ※ ゲーム側で楽曲タイトルが不明 (????? 等) になっている場合は、このValueもその表記になります。ユーザーによって一貫性がない参考情報です。 |
dName | String | 楽曲難易度名 ※ ユーザーによって一貫性がない参考情報です。 |
score | Int | Score |
tRate | Float | Tech-Rate |
state | Int | 楽曲クリアステート (下記に読み方の対応表を記載します) |
platform | Int | プラットフォーム (下記に読み方の対応表を記載します) |
楽曲クリアステート (state)
Value | 意味 |
500 | All A-Perfectでクリア (全A-Perfect以上) |
400 | All Perfectでクリア (全Perfect以上) |
300 | Full Comboでクリア (全Good以上) |
230 | 通常クリア |
100 | 失敗 |
0 | 未プレイ |
楽曲クリアステートは、今後のゲームのアップデートに伴って増える可能性があります。
プラットフォーム (platform)
データIDで利用されている値と、「楽曲リザルト」データタイプのObjectで利用されている値は共通の意味を持ちます。
Value | 意味 |
0 | VRChat PCVR |
1 | VRChat PCDesktop |
2 | VRChat QuestVR |
3 | VRChat Mobile (予約値) |
4 | Debug User |
プラットフォームは、今後のゲームのアップデートに伴って増える可能性があります。