【Blenderアドオン】衣装と素体を簡単マージ！Merge Armatures Tool

VRChatの衣装対応時における、衣装アーマチュアを素体アーマチュアにマージする非常に面倒で退屈な単純作業を自動化します！

衣装対応作業でなんども同じことをやるのが非常に苦痛だったので作りました…。

「Merge Armatures Tool」は、衣装アーマチュアを素体アーマチュアに"いい感じ"にマージするためのBlenderアドオンです。

衣装の"ボーン名/頂点グループ名"を素体側に合わせて、衣装を素体に"ワンクリック"でマージします。

■ 設定不要：

・事前のマッチング辞書の準備なしで、Modular Avatarのように自動的にボーンをマッピング

・揺れものなどを適切なボーン階層構造を維持したまま"一瞬で"マージできます

■ ウェイトを活かす：

・複数の頂点グループ名変更オプションも搭載し、頂点グループ名も素体アーマチュアに合わせて自動変更

・元のウェイトをそのまま活かしたいときや、ウェイト転送後に元のウェイトを参考にしつつ塗りたいときにも便利です

【日本語対応】

v1.3.0より日本語翻訳を追加しました！英語が苦手でもわかりやすくなりました。

※このツールが出来ることと望むことのミスマッチが起きないよう、購入前の注意事項を必ずお読みください。

***

MAで使用されている辞書データを参考に作成していますが、もしかしたらマッピングデータが不十分な可能性があります。

うまくペアレント化できないボーンがあればBOOTHのメッセージよりご連絡ください🙇‍♀️

VRMやVRoidは動作確認できてないので、人柱上等でお願いします…。

***

実際の作業イメージはこちらを見てみてください。

https://youtu.be/7VFxgdHy3_g?si=kzob_-zutXUH2fAq&t=604

👩‍👩‍👧‍👦どんな人向け？

・VRChat向け衣装作成者/対応者

・非対応衣装をBlenderで着せている方

・この商品説明ページの説明で何を行うツールなのかわかる方

🚀機能

衣装対応時における、衣装アーマチュアを素体アーマチュアにマージする非常に面倒で退屈な単純作業を自動化します。

【衣装→素体アーマチュアの自動マージ】

・ヒューマノイドボーン名に基づき、事前準備なしで自動的にマッピング

・揺れものなど衣装固有のボーンのみを適切な素体ボーンにペアレント化しマージ

・対象メッシュのアーマチュアモディファイアを素体アーマチュアに更新

【豊富なカスタマイズ】

・接頭辞/接尾辞対応: 接頭辞/接尾辞の命名規則を持つ衣装アーマチュアに対応

・メッシュ親の自動変更: 衣装メッシュの親を素体アーマチュアへ自動的に変更

・頂点グループ名の自動変更: 衣装メッシュの頂点グループ名を素体アーマチュアに合わせて自動的に変更

　複数のリネームオプション:

　　・素体ボーン名に置き換え

　　・元の頂点グループ名の前に'_'を付加

　　・素体ボーン名に置き換えつつ前に'_'を付加

　　・素体ボーン名に置き換えつつ後ろに'_'を付加

【その他機能】

・接頭辞/接尾辞のクリーンアップ: 衣装ボーンと頂点グループ名の両方から接頭辞/接尾辞を削除するオプション

・endボーンのクリーンアップ: 衣装側ヒューマノイドボーンからendボーンをマージと同時に削除するオプション

・バックアップ作成: マージ前に元のアーマチュアをコピーし保存するオプション

・実験的機能:

　・マージ時にUpperChestをChestに統合（ウェイトも自動統合）

　　・例えば「+Head」用衣装を他のアバターに対応したいときに

　・アーマチュアのマージを行わず、ボーン名のみ変更する機能（高度な設定と互換性あり）

　・PBマスク頂点グループ生成

　　・マージ時にPBボーン（揺れもの）領域のマスク用頂点グループを自動生成。

　　・ウェイト転送ツール（Robust Weight Transfer等）のMaskにそのまま使えます

🛠️インストール方法

1. Blenderの「編集」→「プリファレンス」→「アドオン」を開きます

2. 「インストール」ボタンをクリックします

3. ダウンロードしたmerge_armatures.zipを選択します

4. アドオン一覧で「Merge Armatures Tool」を有効化します

🧰使い方

■ 基本的な使い方

最もシンプルな衣装マージの手順：

1. ツールを開く

　・3Dビューポートの右側パネル → 「Merge Armatures」タブ

2. アーマチュアを選択

　・素体アーマチュア：アバターの素体のアーマチュア

　・衣装アーマチュア：マージしたい衣装のアーマチュア

3. 基本オプションを設定

　・✅ 元の衣装アーマチュアを保持（推奨）

　・✅ メッシュの親を変更（推奨）

　　・メッシュのコレクションを維持したい場合はオフに

　・✅ Endボーンを削除（推奨）

　・頂点グループ名を変更：「素体名の後に'_'を追加」を選択

4. 実行

　・「アーマチュアをマージ」ボタンをクリック

5. 結果確認

　・画面下部に処理結果が表示されます

■ 高度な使い方

<衣装ボーンの接頭辞/接尾辞処理>

衣装ボーン名に接頭辞または接尾辞が存在する場合：

　・接頭辞/接尾辞を指定

　・必要に応じてペアレント後の接頭辞/接尾辞削除オプションを設定

<ボーン除外オプション>

不要なボーンを自動除外：

　・Breastボーン：胸用ボーンの除外

　・Hip揺れボーン：おしりの揺れボーン除外

　・Twistボーン：腕のTwistボーン除外

　・必要に応じて除外ボーンの頂点グループを削除オプションを指定

※除外対象のボーンにその他の子ボーンが存在しない場合のみ除外されます

<実験的機能>

　・UpperChest統合：

　　・UpperChestのボーンと頂点グループ、ウェイトをChestに統合

　　・ウェイト統合方法を選択（平均、加算、最大値）

　・ボーン名のリネームのみ実行：

　　・アーマチュアをマージせずに衣装アーマチュアのボーン名のみを変更

■ PBマスクの使い方（実験的機能）

ウェイト転送時にPB領域（スカート、髪など）を保護したい場合：

1. 高度な設定 → 「PBマスク頂点グループを生成」にチェック

2. 通常通りマージを実行

3. 衣装メッシュに「_pb_mask」頂点グループが自動生成されます

4. ウェイト転送ツール（Robust Weight Transfer等）で

Maskに「_pb_mask」を指定し、Invertで転送

🛠️要件

Blender 3.6.0以上（5.0での動作も確認済）

⚠️使用にあたっての注意事項

高度な設定でボーン除外機能が追加されました：

- Breastボーンを除外: 除外対象外の子ボーンがない場合にBreastボーンを自動削除

- Hip揺れボーンを除外: 除外対象外の子ボーンがない場合にHips揺れボーン（Hips_L/R、Butt_L/R等）を自動削除

- Twistボーンを除外: 除外対象外の子ボーンがない場合にTwistボーン（上腕、下腕、手首のみ）を自動削除

これらのオプションは後方互換性を保持するためデフォルトで無効になっています。

無効の場合、以下のボーンは通常の衣装ボーンと同様に扱われます：

・Breast（胸）ボーン

・腕等のTwistボーン

・Hips（揺れ用）ボーン

そのため、素体側のボーンとの意図しない紐付けを防ぐために：

・高度な設定で適切な除外オプションを有効にする

・マージ前に衣装アーマチュアから削除する

・もしくはマージ後に手動で削除する

のいずれかの対応が必要となる場合があります。

実行後は実行結果を確認するようにしてください。

⚠️購入前の注意事項

このツールは自動で着せ替えできるような魔法のようなツールではなく、ウェイト転送やメッシュ調整を自動化するものでもありません。

以下のワークフローのみを自動化するものです。

・揺れもの等衣装用ボーンのペアレントを素体アーマチュアへ変更

・衣装メッシュのペアレントを素体側へ変更

・衣装メッシュの頂点グループ名を素体ボーン名へ変更

あくまで衣装対応時に機械的に行う必要のあるだるい作業を自動化して楽になるためのツールです。

📚ライセンス

個人・商用問わず自由に利用できます。

■支援版ライセンスについて

めちゃくちゃ楽になったな～と価値を感じられた場合や、商用でのご利用時には支援版ライセンスの購入をご検討いただけると嬉しいです！

📝免責事項

本アドオンの使用によるいかなる損害やトラブルについても、開発者は責任を負いません。

UNDOは可能ですが、実行前に一度保存しておくことをおすすめします。

📢更新履歴

詳しい更新情報は添付のCHANGELOGを確認してください。

アドオン更新後はBlenderを再起動してください。

一部動作が更新されない可能性があります。

■ 2026-07-02 v1.5.1リリース

【修正】

・「メッシュの親を変更」オプション有効時、衣装メッシュが何らかのコレクションに属しており、かつマージ先（素体）アーマチュアがどのコレクションにも属していない（シーンコレクション直下に配置されている等）場合に、「ビューレイヤーにないため選択できません」エラーでマージが失敗する問題を修正

■ 2026-03-17 v1.5.0リリース

【追加】

・[実験的] PBマスク頂点グループ生成オプション

　マージ時に衣装固有ボーン（PhysBone等）のマスク用頂点グループを自動生成

　ウェイト転送ツールのマスクとして利用し、PB領域へのウェイト上書きを防止

　マスクグループ名を設定可能（デフォルト: _pb_mask）

【修正】

・非ヒューマノイドボーン名の重複回避時に頂点グループ名が更新されない問題を修正

・「ボーン名のリネームのみ実行」で頂点グループ名が更新されない問題を修正

・「ボーン名のリネームのみ実行」でボーン名重複時にレポートが実際のボーン名と不一致になる問題を修正

・複数Armature Modifier使用時に無関係なModifierが差し替えられる問題を修正

・ボーン除外マッピングの不具合修正（Breast空文字列、heel重複登録）

・アクティブオブジェクト未設定時にアーマチュア複製が失敗する問題を修正

■ 2025-10-04 v1.4.2リリース

これまでの動作と変更となった部分があります。ご注意ください。

【修正】

・マージ時にメッシュオブジェクトが意図せずアーマチュアのコレクションにリンクされる問題を修正

・ 「メッシュの親を変更」オプションの有無にかかわらず、Armatureモディファイアの参照先を常に更新するように変更

・メッシュの親（オブジェクト階層）は「メッシュの親を変更」オプションが有効な場合のみ変更されるように修正

・メッシュオブジェクトは明示的にペアレント設定しない限り、元のコレクションに残るように修正

■ 2025-09-03 v1.4.1リリース

【修正】

・しなのちゃんの胸ボーンがボーン除外オプションの対象にならない問題を修正

■ 2025-07-27 v1.4.0リリース

【追加】

・高度な設定にマージ処理におけるボーン除外オプションを追加

　・このオプションを有効にすることで、マージ前後に胸やHips揺れボーン、Twistボーンをいちいち削除する必要がなくなりました

　・除外ボーンの頂点グループ削除オプションも合わせて利用することで、頂点グループからもマージと同時に削除可能になりました

■ 2025-06-26 v1.3.0リリース

【追加】

・日本語の翻訳を追加しました

【変更】

・頂点グループ名変更のデフォルトモードを「素体名の後に'_'を追加」に変更

■ 2025-04-19 v1.2.1リリース

【修正】

・メッシュの親を変更する際、ビューレイヤーに存在しないエラーが発生することがある問題を修正

■ 2025-03-29 v1.2.0リリース

【追加】

・実験的機能の追加:

　・UpperChestをChestに統合する機能

　　・UpperChest頂点グループとウェイトをChestに統合

　　・3種類のウェイト統合方法をサポート: 平均、加算、最大値

　　・統合後にUpperChest頂点グループを削除

　・アーマチュアのマージなしでボーン名を変更する機能

　　・マージを行わずに衣装ボーン名を素体ボーン名に変更

　　・元のアーマチュア階層を維持

　　・高度な設定（接頭辞/接尾辞とUpperChest→Chest統合）と互換性あり

■ 2025-02-24 v1.1.1リリース

【追加】

・頂点グループのリネームオプションを追加

　・「Suffix New with _」オプション：新しいボーン名の後ろに'_'を付加

　・このオプションを使用することで、ウェイト転送後に頂点グループ名をボーン名でソートすると、元のウェイトを参照しやすくなるかなと思います

【改善】

・ボーンマッピングの精度を向上

　・完全一致するボーン名を優先的に使用するよう改善

　・特定のアバター（くうたくん等）でのマッピング問題を修正

・衣装ボーンの名前処理を拡張

　・接尾辞（suffix）のサポートを追加

　・既存の接頭辞（prefix）機能と統合

　・今回の拡張で接頭辞/接尾辞両方に対応

■ 2025-02-18 v1.1.0リリース

【追加】

・衣装側アーマチュアのボーン名に接頭辞がある場合においてもマージできるように

　・指定された接頭辞に基づいてマッピングを自動調整

　・衣装ボーンから接頭辞を除去するオプションを用意しました

　　・頂点グループ名の変更オプションが有効のとき、頂点グループ名からも接頭辞を除去します

【改善】

・処理結果の出力を改善

　・接頭辞指定によるボーン名変更も反映して表示するようにしました

　・削除されたendボーンの情報を表示するようにしました

・内部処理の最適化と型定義の強化（リファクタリングを実施）

　・デバッグ用ログを追加しました

　　・もし動作が怪しい場合はBlenderのコンソールに出力されるログを確認してみてください

【修正】

・_endボーンの判定処理を改善し、特定のボーンで削除できなかった問題を修正

・UpperChestボーンが誤ってChestボーンとしてマッピングされる問題を修正

　・正しくUpperChestとして認識されるように改善

　・頂点グループ名が意図せず変更される問題を解消

　→うまく動作しない場合、メッセージから教えていただけるとうれしいです

■ 2025-02-02 v1.0.0リリース

クレジット

このツールは以下のプロジェクトのボーンマッピングデータを参考にしています：

・modular-avatar by bdunderscore（MIT）

・AvatarModifyTools by @HhotateA_xR（MIT）

・BoneRenamer by Azukimochi（MIT）