Costume Support Tools【衣装対応補助ツール】

柚ノ葉 T01『Costume Support Tools』

概要

Blender 5.0 環境でのVRChat衣装対応作業を効率化するために開発された補助アドオンです。

衣装に関係のない素体アバターの髪や服といった不要ボーンの削除や、頂点グループ名の統一、揺れ物ボーンを含むArmatureの一括結合といった、地味でミスが起きやすい作業の補助機能をサイドバーの1パネルに集約。

上から順に実行するだけで、面倒な作業をある程度自動化できます。

細かい内容については下記URL先へ

https://yzhav.github.io/costume-support-tools/

主な機能

1. Bone Cleaner (ボーン整理)

衣装FBXに含まれる「素体のボーン（着せる側には不要なボーン）」を自動で解析し、一括削除します。

・ウェイト解析: 実際にメッシュで使用されているボーンだけを保護します。

・選択補助: 指ボーンや子階層の一括選択機能付き。

・コレクション整理: 残った素体ボーンを「Body」コレクションなどにまとめて整理可能。

2. Vertex Manager (頂点グループ名管理)

衣装の頂点グループ名を、アバター（素体）のボーン名に合わせて自動でリネーム・統合します。

・自動マッチング: 距離判定により、名前が異なっていても近いボーンを推定して紐付けます。

・胸ボーン対応: 揺れものボーンの複雑なウェイトも自動判定で、Rootか子ボーンかを判断しウェイトを移動させます。

3. Armature Merger (結合)

衣装のアーマチュアをアバター本体にワンクリックで結合します。

・衣装側の揺れものボーンも、適切な親ボーンへ自動で付け替えます。

4. Weight Polisher (ウェイト調整)

衣装の突き抜けを防ぐためのスムース処理ツールです。

・素体保護: HipsやSpineなど、動かしたくない素体部分のウェイトを「アンカー」として保護したまま、境界部分だけを滑らかにします。

・4ウェイト制限: インフルエンス数の制限及び正規化も同時に行えます。

5. Data Checker (データ診断)

アップロード前にモデルの不備をスキャンします。

・N-Gons（5角形以上のポリゴン）、孤立頂点、ウェイト無し頂点などを検知。

・エラー箇所を自動選択し、即座に修正に移れます。

動作環境 / 注意点

Blender 5.0

※ 本アドオンはBlender 5.0でのみ動作確認を行っています。それ以前のバージョン（3.6や4.2など）では正常に動作しない可能性がありますのでご注意ください。

・一部機能は衣装側の揺れ物ボーンにPrefixがついていることを前提として作られています。そのためPrefixをつけていない衣装についてはあらかじめ一括リネームツール等で何らかのPrefixをつけておくことをおすすめします。

更新履歴

2025/12/01 v1.0.0 リリース

2025/12/02 v1.1.0

【Selection Stats (選択統計)】

仕様変更: 誤検出を防ぐため、命名規則判定を廃止し「Basis以外のシェイプキー合計数」を表示する仕様に変更。

UI改善: 解析ボタンを廃止し、選択時に常時表示されるように変更。

【Bone Cleaner (ボーン整理)】

ロジック改善: 末端ボーンは「維持」、顔周りのボーンは「削除」がデフォルトになるよう判定を調整。

新機能: 「Select End Bones」ボタンを追加（維持判定された末端ボーンを一括削除指定）。

修正: アーマチュア非表示時にエラーではなく警告を出すように修正。

2026/02/28 v1.2.0

機能削除: Selection Stats パネルを削除

仕様変更: Armature Merger: マッピングリスト空の場合にガイドメッセージとボタンを追加

Weight Polisher: デフォルト値の簡略化、フォールバック動作の改善

その他軽微な修正・UIの改善

2026/05/31 v1.3.0

不具合修正: Armature Merger: .001 などの数値サフィックス付きボーンが結合後に残る問題を修正

仕様変更: Armature Merger / Vertex Manager: 無視 Prefix に一致するボーン・頂点グループを削除・統合対象外に変更

Weight Polisher: しきい値削除・孤立ウェイト削除を追加、設定項目と保護動作を改善

その他軽微な修正・パフォーマンス改善

利用規約

商用利用可・個人／法人問わず利用可能