SabaProps Soft Props
PC VRChat world向けの接触変形shaderと、ふとん、ベッド、ソファー、クッションのmodel／Prefab生成器です。VRChat Worlds SDK 3.10系のWorld Contactsを使用します。
家具の種類、接触 probe、比較用ステージを同じ Scene で確認できます。
ドキュメント
- デモの導入とレビュー: 自動比較、手動接触、家具への立位、実行画像
- 独自modelへの適用: Mesh、Collider、接触slotの設定
- 性能設計: 更新頻度と配置cost
- 更新と配布: 0.2.0への移行、バージョン方針、リリース手順
- 変更履歴
要件
- Unity 2022.3
- VRChat Worlds SDK 3.10.x（3.10.4で検証）
- PC build target
- Built-in Render Pipeline
VPM依存としてcom.vrchat.worlds 3.10.xを宣言しています。3.10.4で検証し、VRChatのVPM互換性指針に従ってbreaking versionを3.10系へ限定します。Quest向けshader variantは収録していません。
導入と生成
レビューには Tools > SabaProps > Soft Props > Open Demo Scene を使用してください。同梱済みの家具4種、肌Materialの接触試験台、指／棒／板のPickup、3形状×3設定の自動比較台、静的な形状比較、照明、床、VRChat Spawnを含むsceneをimportして開きます。事前のPrefab生成や手動配置は不要です。デモの導入・レビュー手順に確認項目と制限を記載しています。
- VCC／ALCOMで本packageをworld projectへ追加する
- Unityの
Tools > SabaProps > Soft Props > Generate All Prefabsを実行する Assets/SabaProps/SoftPropsGenerated/Prefabsから必要なPrefabをsceneへ置く
Create Showcase In Sceneは4種をまとめてsceneへ配置します。generatorは以下を生成します。
| Prefab | 変形面 | 既定の性質 |
|---|---|---|
| Futon | 1 | 柔らかい、深い沈み込み、遅い復元、強めのしわ |
| Bed | 1 | 中程度に硬い、広い荷重分散、速い復元 |
| Sofa | 6 | 3座面＋3背面、座面と背面で異なる硬さ |
| Cushion | 1 | 最も柔らかい、局所的に深い、遅い復元 |
| ContactProbeTest | 1 | 指、棒、板のpickupで接触形状を比較する肌色test surface |
Create Contact Probe Test In Sceneでtest Prefabを配置し、Build & Test後に3個のpickupを表面へ押し当てて確認できます。指は点状、棒はcapsule状、板はoriented box状のfootprintになります。
DefaultSkinMatte.matはStandard lightingを用いるNonToon materialです。肌色、低Smoothness、微細なsurface grainを既定値とし、ContactProbeTestへ適用しています。shader自体の初期値も同じ方向へ揃えています。家具用Materialは織り目を明示的に有効化しています。
再生成時は上記生成先にある既知のMesh、Material、Prefabを置き換えます。生成物を直接変更する場合は別のfolderへ複製してください。
仕組み
各変形面は次の構成です。
- 登録済みworld probeはSphere／Capsule／Box Colliderの底面と未変形面の距離を評価する。距離が0以上なら新たな荷重を発生させない
- Avatarの接触は薄いBox型
VRCContactReceiver、立位荷重はOnPlayerCollisionStayで検出し、登録probeと合わせて最大8接触を保持する - 荷重とfootprintを応答／復元の時定数で補間し、instance化したMaterialへlocal座標で渡す
SabaProps/Soft Surfaceがvertex stageで沈み込み、周辺隆起、横方向の逃げ、しわ、normal補正を計算する
登録probeの中心沈み込みはColliderの侵入量以下に制限します。離脱後は復元途中の凹みが残ります。Avatar側ContactSenderProxyから元のSender寸法は取得できないため、初回接触点のroot相対offsetを追跡する近似であり、任意avatarに対する接触開始の一致は保証しません。Finger／Hand／Foot／Torsoは円形、検証用の指／棒／板は形状別footprintを使います。
立位荷重は上向きの面に対するplayer capsuleの衝突と足元の高さから検出します。ローカルプレイヤーには接地状態と下向きRaycastによる支持Collider照合も使用し、標準Senderや衝突イベントのないClientSimでも確認できます。この補助経路は自分の足元のみを評価し、リモートプレイヤーはSDKイベントに依存します。足のmeshや左右の足の接地を解く方式ではありません。
接触状態はnetwork同期しません。各clientが既に受信しているavatar poseとWorld Contactsから同じ見た目を再構成するため、Udonのnetwork trafficは発生しません。
調整
Prefab内の変形面にあるSoftSurfaceContactControllerで設定します。
| Parameter | 内容 |
|---|---|
| Hardness | 0で柔らかく深く、1で硬く浅く狭い変形になる |
| Maximum Indent | 最大沈み込み距離。visualのみでColliderは変形しない |
| Contact Radius | 1接触点の影響半径 |
| Finger Radius | Finger系tagの点接触半径 |
| Rod Half Length / Radius | SoftProbeRodのcapsule footprint |
| Plate Half Length / Width | SoftProbePlateのoriented box footprint |
| Rim Lift | 沈み込み外周の小さな隆起 |
| Wrinkle Strength / Frequency | 接触周囲のしわの振幅／密度 |
| Response Seconds | 荷重へ追従する時定数 |
| Recovery Seconds | 離れた後に復元する時定数 |
| Update Rate | Material parameter更新頻度。既定30 Hz |
| Impact Response | 進入速度による瞬間的な追加荷重 |
| Probe Colliders / Kinds | 評価対象のColliderと形状（0=指、1=棒、2=板）。配列の先頭から接触slotを予約する |
| Player Standing Load | 上向き面でplayer capsule衝突を立位荷重として扱う |
| Automatic Probe / Cycle Seconds | 登録probeを所定の周期で上下させるデモ制御 |
| Approach Height / Press Depth | 自動デモの退避距離／侵入距離。local単位 |
Avatar Contactの検出領域はVRCContactReceiverのBoxで調整します。既定は表面上方12 mm、下方最大18 mmです。これは検出領域であり、登録probeの荷重開始距離ではありません。登録probeはCollider底面が未変形面を通過してから反応します。
実行開始時にcontrollerが同じ値をMaterialへ反映します。Material側の値だけを変更してもruntimeに上書きされるため、物理presetはcontroller側で調整してください。色、織り目、surface grain、SmoothnessはMaterialで変更します。
性能
- probe未登録かつ非接触時はcontrollerごとに4 Hzまで更新頻度を下げる。登録probeは移動検出のため既定30 Hzで評価する
- 接触時は既定30 Hzで最大8組の接触位置／footprint
Vector4をMaterialへ設定する - 変形はvertex stageのみ。接触点のloopをfragment stageへ持ち込まない
- World Contact Receiver数はFuton 1、Bed 1、Sofa 6、Cushion 1
- shaderは1頂点あたり最大8接触点を評価するため、遠距離家具ではRendererを無効化するかLODを設定する
VRChatのWorld Contactsにはworld全体でactive component数の上限があります。大量配置時の見積りはperformance.mdを参照してください。
制限
- Unity Colliderおよびplayer capsuleは変形しません。見た目の沈み込みとcollision surfaceには最大沈み込み分の差が生じます。
- Contact permissionやSafe Modeでavatar Senderが無効な場合、手・頭・胴体のContact経路は反応しません。立位荷重と登録world Colliderは別経路です。
- 任意のColliderを自動探索しません。world物体は対象面のProbe Collidersへ明示的に登録します。MeshColliderは未対応です。
- 自動デモはkinematic Colliderの規定運動であり、剛体と柔軟体の連成simulationではありません。
- avatar標準Senderの形状はavatarごとに異なるため、厳密な圧力や質量のsimulationではありません。
- shaderはlocal +Y方向を表面法線として扱います。縦置きの背面cushionはGameObjectを回転して使用してください。
- 静的batchingは使用できません。shaderの
DisableBatching=Trueは、object-localの接触座標を維持するために必要です。
詳細なmodel追加手順はauthoring.mdを参照してください。
ライセンス
本パッケージは Apache License 2.0 で提供します。全文は LICENSE.md を参照してください。外部依存・モデル・素材には、それぞれの配布元のライセンスが適用されます。