D9speed Humanoid Alias Copy

ヒューマノイドのボーン名の違いを辞書で対応付け、シーン上のオブジェクト間でコンポーネントをコピーします。

0.1.1以降は有効なHumanoid設定を優先し、それ以外はSkinnedMeshRendererが参照するボーンとその親階層を辞書で照合します。例えば衣装のUpperLeg.LとCloth_Collider/UpperLeg_Lを区別し、コライダー側は補助階層としてコピーします。リグ情報がない場合は従来の名前照合を使用し、複数の実ボーン候補が残る場合は手動指定が必要です。

導入と使用

案内ページからVCC / ALCOMに登録し、D9speed Humanoid Alias Copyを導入してください。Editor Core 0.1.5以降が必要です。

  1. UnityのD9speed > Tools > Humanoid Alias Component Copierを開きます。
  2. コピー元とコピー先のシーンオブジェクトを指定します。
  3. VRC PhysBone（Colliderを含む）、Unity / VRC Constraint、MAの3タブから種類を選び、コピー元・コピー先と行のチェックを確認します。曖昧な対応は「コピー設定・手動対応」から指定できます。
  4. 表示中タブの選択項目をコピーします。他タブのチェック状態は保持されますが、コピーには含まれません。変更はUndoで戻せます。

SkinnedMeshRendererのマテリアルコピーは、上部のコピー元・コピー先の直下にあります。「対象メッシュを確認」を開いて個別に選択し、「選択マテリアルをコピー」からマテリアルだけをコピーできます。Unity Collider、VRC Contact、Particleは「その他・共通」の専用ボタンでコピーします。別タブのコンポーネントを参照する場合は、コピー先に対応コンポーネントがあるか「ボーン対応・参照の詳細」で確認してください。Fluent 2に合わせたEditor Core共通テーマ、ライト／ダーク表示、列幅の調整に対応しています。

既存コンポーネントの更新・追加、常に追加、既存をスキップの各モードに対応します。コピー対象からの除外と、コピー先に合わせた参照の置き換えも行います。PrefabアセットやPrefab編集モード内を直接コピー先にはできません。

ボーン辞書

Editor/Data/humanoid_bone_dictionary.jsonを同梱しています。パッケージの配置先から自動で読み込むため、Blenderのアドオンや外部ファイルのパス設定は不要です。初版は54項目の辞書です。

この辞書は配布データです。パッケージ更新で置き換わるため、直接編集した内容の保存は保証されません。ユーザー独自辞書の指定は初版には含めません。

動作環境

Unity 2022.3.22f1。Editor専用で、VRChat SDKは必須ではありません。SDK固有コンポーネントの全組み合わせは未検証です。旧Assets版との同時導入は型やGUIDが重複するため避けてください。

MIT License。連絡先: d09pseed@gmail.com

パッケージ名

io.github.d9speed.humanoid_alias_copy

ドキュメント

https://github.com/d9speed/unity_editor_tools/tree/main/packages/io.github.d9speed.humanoid_alias_copy

リポジトリ

バージョン

0.1.3 (変更履歴)

Unityバージョン

2022.3.22f1 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

MIT

作者

d9speed

リポジトリ内のパッケージJSON

{
  "name": "io.github.d9speed.humanoid_alias_copy",
  "displayName": "D9speed Humanoid Alias Copy",
  "version": "0.1.3",
  "unity": "2022.3",
  "unityRelease": "22f1",
  "description": "Copy components between scene hierarchies using a bundled humanoid bone alias dictionary.",
  "author": {
    "name": "d9speed",
    "email": "d09pseed@gmail.com",
    "url": "https://github.com/d9speed"
  },
  "license": "MIT",
  "vpmDependencies": {
    "io.github.d9speed.editor_core": ">=0.1.5 <0.2.0"
  },
  "documentationUrl": "https://github.com/d9speed/unity_editor_tools/tree/main/packages/io.github.d9speed.humanoid_alias_copy",
  "changelogUrl": "https://github.com/d9speed/unity_editor_tools/blob/main/packages/io.github.d9speed.humanoid_alias_copy/CHANGELOG.md",
  "url": "https://github.com/d9speed/unity_editor_tools/releases/download/humanoid_alias_copy_v0.1.3/io.github.d9speed.humanoid_alias_copy-0.1.3.zip",
  "zipSHA256": "787fe195c80815f8c0a563f281b946a4fd51e4b3a14a45365ea0717d23764e63"
}