Modular Avatar (MA/NDMF) 導入ガイド

Modular Avatar（MA）は、bd_ 氏が開発したオープンソースの Unity パッケージです。VRChat アバターに衣装や小物を「非破壊的」に取り付けられるのが最大の特徴で、ベースアバターのデータをいっさい上書きせずに衣装を追加できます。

MA は NDMF（Non-Destructive Modular Framework）という基盤の上で動作します。ビルド時に自動でアバター構造を再構成するため、衣装を付けたまま元のアバター設定を自由に変更できます。BOOTH で「MA 対応」「NDMF 対応」と記載された商品はこの仕組みを前提に作られています。

1. 1VRChat Creator Companion（VCC）を起動します。VCC が入っていない場合は先に「VCC/ALCOM 基礎ガイド」を参照してください。
2. 2プロジェクト一覧から対象アバタープロジェクトを選び、「Manage Project」をクリックします。
3. 3パッケージ一覧の検索欄に「Modular Avatar」と入力します。表示されない場合は、左側の「Add Repository」からコミュニティリポジトリを追加してください。
4. 4「Modular Avatar」の横にある「+」ボタンをクリックして追加します。同時に NDMF も自動でインストールされます。
5. 5Unity に戻ってコンパイルが完了するまで待ちます。エラーが出ていないことを確認してください。

MA 対応衣装は、シンプルな手順でアバターに取り付けられます。従来の衣装の骨格（Armature）を手動で結合する方法と比べ、大幅に作業が簡略化されています。

1. 1購入した衣装の unitypackage を Unity にインポートします（Assets メニュー → Import Package → Custom Package）。
2. 2インポートされた衣装プレハブを、シーン内のベースアバターオブジェクトの子に配置します（Hierarchy ウィンドウにドラッグ＆ドロップ）。
3. 3衣装プレハブに「MA Merge Armature」などのコンポーネントがついていることを確認します。
4. 4Play モードに入らずに VRChat SDK のビルドボタン（Build & Publish）を押すか、「Avatar → Build & Test in VRChat」でテスト動作を確認します。
5. 5問題がなければ SDK からアップロードして完了です。

Write Defaults（WD）とは、Unity の Animator Controller にある設定で、アニメーション再生終了後に値をデフォルトに戻すかどうかを制御します。VRChat アバターでは「WD ON」「WD OFF」の統一が重要で、混在するとアニメーションの意図しない動作が起きることがあります。

MA はビルド時に WD 状態を整合させる処理を内部的に行いますが、元のアバターと衣装で WD の方針が異なる場合は表情やギミックが乱れることがあります。ベースアバターの WD 方針（商品説明や同梱の README に記載されていることが多い）を確認し、衣装が同じ方針で作られているかをチェックしましょう。バージョンや制作者によって方針が異なるため、一概には断言できません。