User:Usr d55a5e23-4ccd-4692-b9bb-f1beb1447e7b/Constraints-ja

Note: This page is NOT in the official namespace yet, and is subject to change.

コンストレイントとは、Unityにおいてゲームオブジェクトの位置、回転、スケールなどを他のゲームオブジェクトに関連付けるためのコンポーネント群である。

VRChatはUnity標準のコンストレイント (以下、本稿では便宜的にUnity Constraintsと呼ぶ) に加え、独自実装であるVRChat Constraintsを提供している。VRChat ConstraintsはUnity標準の6種類のコンストレイントに相当する機能を提供し、VRChatでの利用に合わせた追加機能を持つ。

前史

VRChatの初期では、後にUnity 2018.1で導入されるUnity標準のコンストレイント自体がまだ存在していなかった。 Unity標準のコンストレイントがアバターで利用可能になったのは、VRChatがUnity 2018へ移行した2020年である。

しかし、それ以前にも、アバターに含まれるオブジェクトをワールド空間に固定する、いわゆる「ワールド固定」を実現するために複数の手法が用いられていた。

• 2018年には、Particle SystemのSimulation SpaceをWorldに設定し、Particle System Rendererで任意のメッシュを描画することで、アバターの移動から独立してパーティクルをワールド空間上に残す手法が用いられていた。さらにParticle System RendererをMeshに設定し、任意のメッシュをパーティクルとして生成することで、アバターから独立したオブジェクトのように扱う方法も用いられていた。2018年の日本語記事では、このような「ワールド座標シミュレーションのメッシュパーティクル」が、それまでワールド座標へ固定されたオブジェクトを表現する一般的な手法であったとされている。この方式では同一のメッシュを複数生成できる一方、複雑なGameObjectをそのまま配置できないことや、メッシュの姿勢の扱いなどに制約があった。
• 同時期、RigidbodyおよびFixed Jointを利用してゲームオブジェクトそのものをワールド空間に固定する方法が利用されていた。Connected Bodyを指定しないFixed Jointを利用して仮想的なワールド座標系を作り、RigidbodyのIs Kinematicを切り替えることで、オブジェクトの固定とアバターへの追従を切り替えるものであった。 この方式はVRChatの更新やワールドの設定などによって正常に動作しない場合があった。
• 2018年4月24日、VRChat 2018.1.1とともに配布されたSDKに、アバター上のワールド空間Particle SystemをIK計算後のボーン位置へ追従させるためのVRC_IKFollowerコンポーネントが追加された。日本語圏でも、VRC_IKFollowerを利用するワールドパーティクルの作成方法が紹介されていた。しかし、VRC_IKFollowerは特定の階層以下に入れると視界に表示されなくなるという制約が存在した。
• Unity標準のコンストレイントが利用可能になる以前には、Fixed Jointのほか、有料UnityアセットのFinal IKをワールド固定に利用する方法も存在した。2019年に公開され、2020年5月に更新された日本語の記事では、日本語圏ではFixed Jointを利用する方式が比較的多かったとされている。
• 2020年4月1日にリリースされたVRChat 2020.1.1では、VRChatのUnityバージョンがUnity 2018.4.20f1へ更新され、Aim Constraint、Look At Constraint、Parent Constraint、Position Constraint、Rotation ConstraintおよびScale ConstraintがSDK2のアバター用allowlistに追加された。これ以降、Unity標準のコンストレイントを利用したワールド固定などの手法が用いられるようになった。
  • 2020年4月3日に公開された日本語の解説記事では、それ以前のFixed Joint方式と比較し、Constraintを利用する方式はワールド側の設定によって壊れないことが利点として挙げられている。

VRChatにおける用途

アバターに組み込んだアイテム（武器など）の持ち替え、ワールド固定、補助ボーン、通常の人体の構成を外れた（いわゆる「人外」）アバターの偽物の腕や身体の制御などに用いられる。

VRChatのアバターでは、許可されたコンポーネント以外の任意のカスタムスクリプトを利用できない。そのため、後述のVRChat Constraintsが導入される以前から、Unity標準のParent Constraintなどを仕込んでおき、擬似的にヒエラルキー上の親子関係を変更したような挙動を実現する手段が用いられていた。

ここでいう「擬似的」とは、実際にTransformの親子関係を変更するのではなく、コンストレイント対象のTransformの位置や回転を、指定したソースの子であるかのように評価することを指す。UnityのParent Constraintも、対象をHierarchy上で実際に子へ移動することなく、ソースの子であるかのように移動・回転させる。

また、複数のUnity Constraintsを組み合わせ、アバター上のオブジェクトをワールド空間上の位置に固定する、いわゆる「World Constraint」も用いられていた。VRChatは後に、この用途を単一のコンストレイントで実現するFreeze To WorldをVRChat Constraintsへ追加している。

VRChat Constraintsでは、このほかSolve In Local Spaceによるローカル空間での計算や、コンポーネント自身とは異なるTransformを操作対象にするTarget Transformなど、Unity標準のコンストレイントにはない機能も提供されている。

歴史

• 2024年5月2日: VRChatは、Unity標準のコンストレイントと同様に動作しながら、VRChatのアバター向けに最適化された独自のコンストレイントコンポーネントを開発中であることを発表した。また、Unity Constraintsをゲーム内で自動的にVRChat Constraintsへ変換する予定であることや、Solve In Local Spaceもこの時点で紹介された。
• 2024年5月30日: VRChat Constraintsの詳細な仕様が発表された。当初は複数の挙動を1つのコンポーネントで扱う実装だったものが、Unity標準のコンストレイントと同様に複数種類のコンポーネントへ分割された。また、SDKによるUnity Constraintsの自動変換や、Freeze To Worldなどが紹介された。この時点で開発は内部QAの終盤にあり、同年7月の公開を予定していた。
• 2024年7月24日: VRChat 2024.3.1 Build 1480のOpen BetaにVRChat Constraintsが導入された。VRChatはUnity標準実装より高い性能を特徴として挙げ、モバイル向けアバターでも利用可能になるとしていた。また、SDKによるUnity Constraintsからの自動変換もベータテストされた。
• 2024年8月14日: VRChat 2024.3.1 Build 1490が正式リリースされ、VRChat Constraintsがクライアントへ導入された。既存のアバターに含まれるUnity Constraintsについても、アバターのロード時にVRChat Constraintsへ自動変換されるようになった。
• 2024年8月16日: VRChat SDK version 3.7.0がリリースされ、アバター制作者がVRChat Constraintsを直接利用できるようになった。既存のUnity ConstraintsをSDK上で変換する機能も提供された。
• 2025年7月31日: VRChatは、PhysBonesおよびContactsとともにVRChat Constraintsをワールドでも利用できるようにする計画を発表した。また、ワールドではUdonからこれらのコンポーネントを操作できるようにする方針も示された。
• 2025年9月中旬頃: World Dynamicsのclosed community betaが開始され、PhysBones、Contacts、VRChat Constraintsのワールド対応についてコミュニティによるテストが行われた。9月25日のDeveloper Updateでは、約1週間前からclosed community betaを実施していると説明された。
• 2025年10月24日: VRChat SDK version 3.10.0がリリースされ、VRChat Constraintsを含むVRChat Dynamicsがワールドプロジェクトで利用可能になった。これらをUdonから操作するAPIおよびイベントも追加された。このリリースはベータ期間中にはversion 3.9.1として開発されていたが、互換性のないAPI変更のため3.10.0へ変更された。
• 2025年11月3日: VRChat 2025.4.1 Build 1749が正式リリースされ、ワールド上のPhysBones、ContactsおよびVRChat Constraintsにクライアントが正式対応した。

トリビア

• VRChat SDKの「Auto Fix」を使うと、アップロード対象のアバターに含まれるUnity ConstraintsをVRChat Constraintsへ変換できる。この変換では、コンストレイント本体だけでなく、それを参照しているアニメーションクリップのバインディングも変換できる。SDK内部ではVRC.SDK3.Avatars.AvatarDynamicsSetupクラスの変換処理が利用されている。
• Modular AvatarのConvert Constraintsコンポーネントでも、Unity Constraintsおよびそれを参照するアニメーションをビルド時に非破壊的にVRChat Constraintsへ変換できる。Modular Avatarがインストールされている場合、VRChat SDKのAuto Fixは必要に応じてこのコンポーネントをアバターのルートへ追加する。
• VRChat Constraintsでは、1つのコンストレイントに17個以上のソースを持たせること自体は可能である。ただし、アバターではAnimatorから操作できるのはSourcesリストの先頭16個までに制限されている。

参考資料

• Common Components | VRChat Creation, accessed September 29, 2026.
• VRChat SDK Releases | VRChat Creation, accessed September 29, 2026.