Skip to main content

PlayerData 编辑器

ClientSim 可以模拟 VRChat SDK 的"持久化"功能。PlayerData 编辑器窗口允许您调试世界中的持久数据。您可以通过"VRChat SDK" > "ClientSim PlayerData" 打开它。

用法​

ClientSim PlayerData Window

  1. 用于选择显示哪个玩家 PlayerData 的下拉菜单。
    • 默认选择本地玩家。
    • 如果在播放模式下生成了远程玩家，也可以选择他们。
  2. 所选玩家的 PlayerData 键、值和数据类型列表。
    • 显示内容随 PlayerData 更新实时更新。
  3. "Clear All PlayerData" 删除当前场景的所有 PlayerData。
    • 例如，如果您更改了世界使用 PlayerData 的方式，这允许您"重新开始"。
  4. "Refresh" 允许您刷新 PlayerData 列表。
    • 您可以手动查看或编辑场景的 JSON 文件。更改在播放模式下立即生效，但您必须点击"Refresh"按钮才能看到变化。
  5. "Open Local Data Folder" 打开 ClientSim 存储此场景持久数据 JSON 文件的文件夹。
    • 如果您的脚本使用 PlayerData，ClientSim 会自动创建 JSON 文件。它们保存在项目中，并在播放模式会话之间持久存在。
    • PlayerData 文件是场景唯一的。每个使用 PlayerData 的场景都有一个关联的 JSON 文件。场景名称用于此关联：如果您重命名场景并希望保留数据，则必须重命名相应的 JSON 文件以匹配新场景名称。
  6. "Add Test Data For Remote Player" 允许您为远程玩家创建 PlayerData。
    • 此按钮仅在播放模式下选择了远程玩家且本地玩家有数据时显示。
    • 由于 PlayerData 只能为本地玩家设置，此按钮会复制本地玩家的测试数据 JSON 文件并随机化每个值。假设 PlayerData 的结构在玩家之间应该一致，但值可以不同。
    • 这样创建测试数据会发布相应的 OnPlayerDataUpdated 事件，允许创作者验证他们的世界是否正确处理多个玩家之间的数据更新。
    • 每次点击按钮时，远程玩家的数据都会被随机化。

PlayerData 的数据可以在项目根目录（Assets 文件夹旁边，不在其内部）的 <root>/ClientSimStorage/PlayerData 中找到。