Ever's Parent Constraint Converter|VRC親制約→Unity親制約変換ツール

説明
Ever's Parent Constraint Converter v1.0.0
Hierarchyの衣装を指定して、VRC Parent ConstraintをUnity Parent Constraintへ一括変換。元のPrefabアセットを保持する無料Unityエディター拡張です。
한국어 / English / 日本語
〖日本語〗
Hierarchyへ配置した衣装をツールに入れると、ルートと全ての子にあるVRC親制約を自動で検査します。変換できる項目と維持する項目を確認してから、まとめて適用できます。非アクティブな子も対象です。
主な機能 ・VRC Parent Constraint → Unity標準Parent Constraintへ一括変換 ・ソースの順序・参照・ウェイトと全体ウェイトを保持 ・ソースごとの位置/回転オフセット、Rest値、適用軸、Active/Lock、有効状態を保持 ・元のPrefab・FBX・アニメーション・コントローラーを保存・上書きしないシーン内処理 ・Prefabインスタンスの接続を維持 ・処理全体を1回のUndoで戻せる、Redoにも対応 ・韓国語 / English / 日本語UI
使い方
- ZIPを展開し、unitypackageをUnityへインポートします。
- 衣装をHierarchyに置きます。
- Tools → Ever's Parent Constraint Converterを開きます。
- 「衣装ルート」欄に衣装を入れて、自動検査の一覧を確認します。
- 「親制約を一括変換」を実行し、結果を確認してシーンを保存します。
インストール先:Assets/_Ever's/ParentConstraintConverter
変換せず維持する項目 別のTarget Transform、Solve In Local Space、Freeze To World、Rebake Offsets When Unfrozenなど、Unity標準の親制約で同じ設定を表せない項目は理由を表示して元のVRC制約を維持します。既存制約との競合、重複、不正値、自己参照、コンポーネント参照、検出したVRCプロパティへのアニメーション設定も対象です。クリップやコントローラーは書き換えません。
検証環境 ・Unity 2022.3.22f1 / 6000.3.18f1:実SDK 3.10.5のPlay Mode比較を実施。変換Prefab 163個・親制約 783個について、各バージョン106,488回の比較が許容誤差内で完了しました。 ・位置の許容差0.1mm、回転0.05°。最終アバター全体やVRChatクライアントでの視覚検査ではなく、制約計算を分離した数値検証です。 ・Unity 2019.4.31f1:APIコンパイル確認のみ。ライセンス認証のため実Editor実行は未確認です。SDK 3.10.5自体のUnity 2019対応を意味しません。 ・詳しい範囲と結果は同梱VALIDATION.mdを参照してください。
〖한국어〗
Hierarchy에 배치한 의상을 넣으면 루트와 모든 자식의 VRC Parent Constraint를 찾아 Unity 기본 Parent Constraint로 변환하는 무료 에디터 툴입니다. 비활성 자식까지 자동 검사하며, 실행 전 변환·유지 목록과 이유를 확인할 수 있습니다.
소스 순서·참조·가중치, 전체 가중치, 소스별 위치/회전 오프셋, Rest 값, 적용 축, Active/Lock, 컴포넌트 활성 상태를 유지합니다. 오프셋을 다시 계산하지 않습니다.
원본 프리팹·FBX·애니메이션·컨트롤러를 저장하거나 덮어쓰지 않고, Hierarchy의 씬 인스턴스만 변경합니다. 프리팹 연결을 유지하며 전체 작업은 Ctrl+Z 한 번으로 되돌릴 수 있습니다. Redo도 지원합니다.
사용 방법
- ZIP을 풀고 unitypackage를 임포트합니다.
- 의상을 Hierarchy에 배치합니다.
- Tools → Ever's Parent Constraint Converter를 엽니다.
- 「의상 루트」에 의상을 넣고 자동 검사 결과를 확인합니다.
- 「부모제약 자동 변환」을 누른 뒤 결과를 확인하고 씬을 저장합니다.
다른 Target Transform, VRC 전용 설정, 기존 제약 충돌, 참조 또는 애니메이션 연결처럼 그대로 옮길 수 없는 항목은 이유를 표시하고 원래 VRC 제약으로 유지합니다. 클립과 컨트롤러는 변환하지 않습니다.
Unity 2022.3.22f1 / 6000.3.18f1에서 실제 SDK 3.10.5를 사용해 변환 프리팹 163개·제약 783개를 비교했습니다. 버전별 106,488회 비교에서 허용 오차 초과는 없었습니다. 통과 기준은 위치 0.1 mm, 회전 0.05°이며, Animator·물리·렌더링을 분리한 제약 계산 검사입니다. 최종 아바타와 VRChat 클라이언트의 시각 검사를 대신하지 않습니다.
Unity 2019.4.31f1은 API 컴파일 확인만 완료했습니다. 라이선스 인증 문제로 실제 Editor 실행은 미검증이며, 최신 SDK의 Unity 2019 지원을 보장하지 않습니다. 자세한 내용은 VALIDATION.md를 확인하세요.
〖English〗
A free Unity Editor tool that converts VRC Parent Constraints under a Hierarchy outfit into Unity's standard Parent Constraints. Assign the outfit root to scan automatically, including inactive descendants. Review the conversion and preservation list before applying.
It preserves ordered source references and weights, global weight, per-source position/rotation offsets, rest values, affected axes, active/locked flags and component enabled state. Offsets are copied without recalculation.
Only scene instances are changed. Source prefab, FBX, animation and controller assets are not saved or overwritten. Prefab connections are retained. One Ctrl+Z undoes the complete operation, and Redo is supported.
Usage
- Extract the ZIP and import the unitypackage.
- Place your outfit in the Hierarchy.
- Open Tools → Ever's Parent Constraint Converter.
- Assign Outfit root and review the automatic scan.
- Click Convert parent constraints, inspect the result, then save your scene.
A different Target Transform, VRC-specific settings, conflicts, detected component references and animation bindings remain as original VRC constraints with a reason. Animation clips and controllers are not rewritten.
Actual SDK 3.10.5 comparisons in Unity 2022.3.22f1 and 6000.3.18f1 covered 163 converted prefabs and 783 constraints. Each version passed 106,488 comparisons within the stated tolerances: 0.1 mm position and 0.05°. The test isolates constraint calculation from unrelated animation, physics and rendering; it is not a final-avatar or VRChat-client visual test.
Unity 2019.4.31f1 passed compiler/API compatibility checks only. Live Editor execution was blocked by licensing, and current SDK support on Unity 2019 is not established. See VALIDATION.md for full scope and results.
〖ご利用前に / 사용 전 / Before use〗
・通常のシーンにあるHierarchyオブジェクトが対象です。Projectアセット、Prefab Mode、Play Modeでは実行できません。 ・일반 씬의 Hierarchy 오브젝트가 대상입니다. Project 에셋, Prefab Mode, Play Mode에서는 실행할 수 없습니다. ・Use Hierarchy objects in a regular scene. Project assets, Prefab Mode and Play Mode cannot be converted.
・変換にはVRC Parent Constraintを読み込めるSDKが必要です。Missing Scriptは復元しません。 ・변환에는 VRC Parent Constraint를 읽을 수 있는 SDK가 필요합니다. Missing Script는 복원하지 않습니다. ・Conversion requires a working SDK that can load VRC Parent Constraint. Missing scripts are not reconstructed.
・モデルとSDKは付属しません。使用するモデルの規約に沿って利用してください。 ・모델과 SDK는 포함되지 않습니다. 사용하는 모델의 이용규약에 맞게 사용하세요. ・Models and the SDK are not included. Respect the terms of the models you use.
内容 / 구성 / Contents EversParentConstraintConverter_v1.0.0.zip
ZIPを展開してunitypackageをインポートします。 ZIP 압축을 풀고 unitypackage를 임포트하세요. Extract the ZIP and import the unitypackage.
Included: EversParentConstraintConverter_v1.0.0.unitypackage + README.md + VALIDATION.md Editor-only tool and Korean/English/Japanese guides. No model or internal test assets are included.
Creator: Ever X: https://x.com/EVER_VRM
〖AI使用について / AI 사용 안내 / AI usage〗 本ツールの開発と商品紹介資料の作成にはAIを活用しています。 이 툴의 개발과 상품 소개 자료 작성에 AI를 사용했습니다. AI assisted the development of this tool and the preparation of its product information.