name: vrc-udon-persistence-sync description: VRChat UdonSharp で local state、synced state、Player Data、Player Object、Persistence のどれを使うか判断するときに使う。保存単位、復元順、キー設計、同期と保存の責務分離を明示したい場合に使う。ネットワーク全体ルールの固定は vrc-udon-networking-rules に分ける。 metadata: version: "1.0.0"

VRC Udon Persistence Sync

役割

UdonSharp システムにおける状態保存と同期の責務を分ける。local state、synced state、Player Data、Player Object、Persistence のどれを使うかを判断し、混線を防ぐ。

この Skill を使う場面

• local / sync / Player Data / Player Object / Persistence を使い分けたい
• key 設計や復元順を決めたい
• 保存責務と同期責務を分けたい

この Skill を使わない場面

• networking 文書を先に固定したいだけの場合: vrc-udon-networking-rules
• モジュール構造設計から始める場合: vrc-udon-core-module

進め方

1. references/sync-decision-guide.md を読む。
2. Persistence も使うなら references/persistence-notes.md を読む。
3. 状態ごとに分類する。
4. 復元順を決める。
5. key 命名規則を決める。
6. Networking 全体の仕様が未整理なら $vrc-udon-networking-rules も併用する。

担当範囲

• 保存方式の選択
• 復元順の整理
• key 設計の整理
• PlayerObject と Persistence の関係整理

注意点

• Persistence はリアルタイム同期の代わりにしない
• 復元前提の値を Awake 相当で即参照しない
• 保存キーは後方互換を考えて決める
• 破棄できる状態まで永続化しない