PlayerData Editor

ClientSimはVRChat SDKの「Persistence（永続化）」機能をシミュレートできます。PlayerDataエディターウィンドウを使用すると、ワールド内の永続データをデバッグできます。このウィンドウは「VRChat SDK」>「ClientSim PlayerData」から開くことができます。

使い方

1. 表示するプレイヤーのPlayerDataを選択するためのドロップダウンメニューです。
   • デフォルトではローカルプレイヤーが選択されています。
   • プレイモード中にリモートプレイヤーがスポーンされている場合、そのプレイヤーを選択することも可能です。
2. 選択したプレイヤーのPlayerDataのキー、値、データ型のリストです。
   • PlayerDataが更新されると、表示はリアルタイムで更新されます。
3. 「Clear All PlayerData」は、現在のシーンのすべてのPlayerDataを削除します。
   • 例えば、ワールドでのPlayerDataの使いかたを変更した場合に、データを「最初からやり直す」ことができます。
4. 「Refresh」を押すと、PlayerDataのリストを更新できます。
   • シーンのJSONファイルを直接確認・編集することも可能です。変更内容はプレイモード中に即座に反映されますが、変更を確認するには「Refresh」ボタンを押す必要があります。
5. 「Open Local Data Folder」をクリックすると、このシーンの永続データ用JSONファイルが保存されているフォルダが開きます。
   • スクリプトでPlayerDataを使用している場合、ClientSimが自動的にJSONファイルを作成します。これらのファイルはプロジェクト内に保存され、プレイモードを終了してもデータは保持されます。
   • PlayerDataファイルはシーンごとに固有です。PlayerDataを使用する各シーンには、それに関連付けられたJSONファイルが存在します。この関連付けにはシーン名が使用されます。そのため、シーン名を変更してデータを保持したい場合は、対応するJSONファイル名も新しいシーン名に合わせて変更する必要があります。
6. 「Add Test Data For Remote Player」を使用すると、リモートプレイヤー用のPlayerDataを作成できます。
   • このボタンは、Playモード中にリモートプレイヤーが選択されており、かつローカルプレイヤーにデータが存在する場合にのみ表示されます。
   • PlayerDataはローカルプレイヤーに対してのみ設定可能であるため、このボタンはローカルプレイヤーのテストデータJSONファイルを複製し、各値をランダム化します。これは、PlayerDataの構造はプレイヤー間で一貫している必要があるものの、値自体は異なっていても良いという前提に基づいています。
   • このようにテストデータを作成することで、対応するOnPlayerDataUpdatedイベントが発行され、作成者は自身のワールドが複数のプレイヤー間でのデータ更新を正しく処理できているかを確認できます。
   • リモートプレイヤーのデータは、ボタンをクリックするたびにランダム化されます。

PlayerDataのデータは、プロジェクトのルート（Assetsフォルダの中ではなく、Assetsフォルダの横）にある以下の場所に保存されています：<root>/ClientSimStorage/PlayerData。