NDMF(Non-Destructive Modular Framework)は、Modular Avatar や Avatar Optimizer(AAO)といった非破壊改変ツールの「下で動いている共通の土台」です。自分で直接使うものではありませんが、仕組みとメニューの場所を知っておくと、ツールを複数入れたアバターが崩れたときに原因を早く絞り込めます。この記事では、NDMF が何をしているのか、どのタイミングで動くのか、利用者が触れる主なメニューと、崩れたときの切り分け手順をまとめます。
この記事の前提
対象は VRChat のアバター改変をしている PC 版の制作環境(Unity と VRChat SDK - Avatars)です。NDMF の情報は 2026-10-29 に確認した公式ドキュメントと GitHub のソースコード(安定版 1.14.8)に基づきます。メニュー名は英語表記のままです。編集部では実機での検証をしておらず、記載は公式ドキュメントとソースコードの内容に基づきます。
NDMF とは何か
NDMF は bd_ 氏が開発する、VRChat アバター向けの非破壊プラグインを作るためのフレームワークです。ライセンスは MIT で、GitHub で公開されています。ここでいう「プラグイン」は、Modular Avatar や AAO のように、アップロードの直前にアバターを自動で加工するツールのことです。
公式ドキュメントは、NDMF が作られた理由を2つ挙げています。1つは、VRChat SDK にはビルド時に処理を差し込む仕組みはあっても、Play モードに入ったときに同じ処理を走らせる仕組みが無いこと。もう1つは、各ツールがそれを独自に作ると、複数のツールを同時に入れたときに衝突しやすいことです。NDMF はこの「いつ・どの順番で処理するか」を一か所で管理し、ツール同士が同じ手順で協調できるようにしています。
利用者が NDMF を個別に入れることは通常ありません。Modular Avatar と AAO はどちらも、パッケージの依存先として NDMF を指定しています(2026-10-29 時点の各 GitHub リポジトリの package.json で確認)。そのため VCC や ALCOM でこれらのツールを追加すると、NDMF も一緒にプロジェクトへ入ります。パッケージ一覧では「Non-Destructive Modular Framework」という名前で表示されます。
アップロードの瞬間に何が起きているか
NDMF の処理は、シーン上のアバターではなく、アップロード用に作られた複製に対して行われます。シーンのアバターに付けたコンポーネントは「こう加工してほしい」という指示書のようなもので、実際の加工は複製の上で行われ、その結果がアップロードされます。非破壊と呼ばれるのはこのためです。
処理は段階(フェーズ)に分かれていて、公式 API ドキュメントには次の7つが定義されています。
FirstChance / PlatformInit: 他のすべてより先に動く必要がある処理と、プラットフォームの初期化。
Resolving: 大きな変更を加える前の下ごしらえ。Modular Avatar はここでオブジェクト参照の解決やアニメーションコントローラーの複製を行います。EditorOnly タグが付いたオブジェクトを取り除く NDMF 内蔵の処理もこの段階で動きます。
Generating: 後の段階のツールが使うコンポーネントを生成する段階。
Transforming: 一般的な改変を行う段階。Modular Avatar の処理の大半はここで動きます。
Optimizing: 見た目や動作を変えない最適化のための段階。
PlatformFinish: 最適化の後に行うプラットフォーム固有の後片付けと検査。例として VRChat のパラメータ上限の確認が挙げられています。
同じ段階の中での順番は、各ツールが「〇〇の処理より前に」「〇〇の処理の後に」と宣言した依存関係から NDMF が決めます。段階そのものも Transforming の後に Optimizing と決まっているため、衣装の統合のような改変が済んでから最適化が行われる、という流れになります。利用者が順番を手で設定する必要はありません。
NDMF の処理が走る4つのタイミング
NDMF の処理は、アップロード時だけでなく次の場面でも動きます。どの場面でも、シーン上の元のアバターは変更されません。
Play モードに入ったとき: Unity 上部メニューの Tools > NDM Framework > Apply on Play にチェックが入っていると、Play モードのアバターに処理が適用されます。既定値はオンです。衣装の統合やメニューの生成が、アップロードせずに確認できるのはこの機能のおかげです。
アップロードするとき: Tools > NDM Framework > Apply on Build が対応する設定で、既定値はオンです。これをオフにすると、NDMF 系ツールの処理がアップロード時に行われなくなります。通常は触らない設定です。
手動で結果を確かめたいとき: Hierarchy でアバターを右クリックし、NDM Framework > Manual bake avatar を選ぶと、処理後の複製がシーンに追加されます。ソースコードでは、複製は元のアバターから Z 方向に 2 ずらした位置に置かれ、生成されたアセットは Assets/ZZZ_GeneratedAssets フォルダに保存されます。このフォルダはビルド後の自動削除の対象外なので、確認が終わったら複製と一緒に手で消してください。同じ項目は Tools > NDM Framework > Manual bake avatar にもあります。
編集中のプレビュー: Tools > NDM Framework > Enable Previews は、対応しているツールの処理結果をシーン上に仮表示する機能の切り替えです。どのツールがプレビューに対応しているかはツールごとに異なります。
エラーが出たときに見る NDMF コンソール
NDMF 系のツールが処理中に失敗すると、「アバター処理中にエラーが発生しました。詳しくはNDMFコンソールをご確認ください。」という趣旨のメッセージが出ます。NDMF コンソールは Tools > NDM Framework > Show NDMF Console で開けます。Hierarchy でアバターを右クリックし、NDM Framework > Show NDMF Console からも開けます。
コンソールには、どのプラグインがどんなエラーを出したかが表示されます。日本語の表示に対応していて、「直すには?」の欄に対処のヒントが出ることがあります。「テストビルドを実行」ボタンを押すと、アップロードせずにビルド処理だけを試せます。一部の問題には「お任せ修正」ボタンが用意されています。例として、テクスチャのミップストリーミング設定(VRChat で必須の設定)が抜けている場合の警告には、このボタンで設定を直す動線があります。
Unity 標準の Console ウィンドウには、別の原因のエラーも混ざって流れます。NDMF 系ツールの問題かどうかを見分けるには、まず NDMF コンソールを開くのが近道です。
崩れたときの切り分け手順
複数の NDMF 系ツールを入れたアバターで見た目やギミックが崩れたときは、次の順に確認します。Tools > NDM Framework > Debug Tools の中に、原因の特定に使えるウィンドウが2つあります。
1. NDMF コンソールでエラーの有無と、エラーを出したプラグインを確認する
2. Manual bake avatar で処理後の複製を作り、どこが崩れているかを目で見る
3. Debug Tools > Plugin sequence display で、入っているプラグインと実行順を確認する
4. Debug Tools > Enable-Disable Plugins で、怪しいプラグインを1つずつ無効にして再確認する
5. 原因のツールが分かったら、そのツールの作者に報告する
Enable-Disable Plugins のウィンドウには「Enable All Plugins」「Disable All Plugins」のボタンと、プラグインごとのチェックボックスがあります。ウィンドウ内の説明どおり、ここでの無効化は今のセッションだけの一時的なもので、Unity を再起動すると元に戻ります。無効にしたまま忘れてアップロードしてしまう事故は、再起動で防げます。
報告するときは、NDMF コンソールのスタックトレース(コンソール内の「スタックトレースを表示」を開いた内容)と、VCC や ALCOM のプロジェクト管理画面に出ている各パッケージのバージョンを添えます。NDMF 自体の内部エラーと表示された場合も、メッセージの指示どおりまずはプラグインの作者に報告するのが窓口です。
つまずきやすいポイント
Play モードでは正しいのに、アップロードすると崩れる
原因: Apply on Build がオフになっている、または Play モードとアップロードで別のツールが動いている。
直し方: Tools > NDM Framework を開き、Apply on Build にチェックが入っているかを確認します。そのうえで Manual bake avatar の結果を見ると、アップロードされる状態に近い形を確認できます。
Play モードに入ってもツールの効果が出ない
原因: Apply on Play がオフになっている。
直し方: Tools > NDM Framework > Apply on Play にチェックを入れます。ソースコード上、この設定は保存されない設定(NonPersistentConfig)として定義されていて、Unity を再起動すると既定のオンに戻ると読めます(編集部での実機確認はしていません)。
Assets に見覚えのないフォルダが増えている
原因: Manual bake avatar を実行した。
直し方: Assets/ZZZ_GeneratedAssets は Manual bake avatar の出力先です。シーンに残った複製を消してから、このフォルダも削除して構いません。
アバターのルートに EditorOnly タグを付けたらエラーになる
原因: NDMF は EditorOnly タグのオブジェクトを処理対象から取り除くため、ルート自体が EditorOnly だとアバターとして処理できない。
直し方: ルートのタグを Untagged に戻します。アップロードしたくない部品だけに EditorOnly を付けます。
よくある質問
NDMF は自分でインストールする必要がありますか
通常は不要です。Modular Avatar や AAO を VCC・ALCOM で追加すると、依存パッケージとして一緒に入ります。NDMF は土台なので、NDMF だけを入れてもアバターの見た目は変わりません。
NDMF を削除してもいいですか
Modular Avatar や AAO など、NDMF に依存するツールを使っている間は削除しないでください。依存しているツールが動かなくなります。
NDMF のバージョンはどこで確認できますか
VCC または ALCOM でプロジェクトの管理画面を開き、「Non-Destructive Modular Framework」の行を見ます。2026-10-29 時点の GitHub のリリース一覧では、安定版の最新は 1.14.8 で、1.15.0 はベータ版です。ツールが新しい NDMF を要求している場合は、ツールを更新するときに NDMF の更新も求められます。
Modular Avatar と AAO を一緒に使っても順番は大丈夫ですか
どちらも NDMF のプラグインとして動くため、処理の順番は NDMF が段階と依存関係にもとづいて決めます。公式の定義では、Modular Avatar の処理の大半は Transforming の段階で動き、見た目を変えない最適化は後の Optimizing の段階として定義されています。実際の順番は Debug Tools > Plugin sequence display で確認できます。
NDMF コンソールに何も表示されません
アバターを選択していないか、そのアバターをまだビルドしていない可能性があります。Hierarchy でアバターを選び、コンソールの「テストビルドを実行」を押すと、そのアバターの結果が表示されます。
関連記事
「Modular Avatarで衣装を着せる 非破壊改変のすすめ」
引用記事Modular Avatarで衣装を着せる 非破壊改変のすすめアバター
「Avatar Optimizer(AAO)入門 非破壊でアバターを軽くする」
引用記事Avatar Optimizer(AAO)入門 非破壊でアバターを軽くするアバター
「2026年のVRChat改変ツール 目的別マップと導入する順番」
引用記事2026年のVRChat改変ツール 目的別マップと導入する順番技術・制作
引用記事質問スレッドの書き方 再現手順と環境情報をそろえる技術・制作
「VRCFury と Modular Avatar の違い 使い分けと併用時の処理順」
引用記事VRCFury と Modular Avatar の違い 使い分けと併用時の処理順アバター
参考資料
NDMF 公式ドキュメント(2026-10-29 確認)
NDMF API ドキュメント BuildPhase(2026-10-29 確認)
GitHub bdunderscore/ndmf(README・メニュー定義のソースコード)(2026-10-29 確認)
NDMF リリース一覧(2026-10-29 確認)
Modular Avatar の package.json(2026-10-29 確認)
Avatar Optimizer の package.json(2026-10-29 確認)



コメント(0件)
まだコメントはありません。