ばーちゃるなれっじ Unityのエラー、アバター改変、イベントを検索 アプリで開く
‹ 戻る#アバター

NDMF とは 非破壊改変ツールが一緒に動く仕組みと確認メニュー

目次15項目
  1. この記事の前提
  2. NDMF とは何か
  3. アップロードの瞬間に何が起きているか
  4. NDMF の処理が走る4つのタイミング
  5. エラーが出たときに見る NDMF コンソール
  6. 崩れたときの切り分け手順
  7. つまずきやすいポイント
  8. よくある質問
  9. NDMF は自分でインストールする必要がありますか
  10. NDMF を削除してもいいですか
  11. NDMF のバージョンはどこで確認できますか
  12. Modular Avatar と AAO を一緒に使っても順番は大丈夫ですか
  13. NDMF コンソールに何も表示されません
  14. 関連記事
  15. 参考資料

NDMF(Non-Destructive Modular Framework)は、Modular Avatar や Avatar Optimizer(AAO)といった非破壊改変ツールの「下で動いている共通の土台」です。自分で直接使うものではありませんが、仕組みとメニューの場所を知っておくと、ツールを複数入れたアバターが崩れたときに原因を早く絞り込めます。この記事では、NDMF が何をしているのか、どのタイミングで動くのか、利用者が触れる主なメニューと、崩れたときの切り分け手順をまとめます。

NDMF の処理順 準備・Resolving・Generating・Transforming・Optimizing・PlatformFinish

この記事の前提

対象は 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 モード・アップロード・Manual bake・プレビュー

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 系ツールで崩れたときの切り分け手順 5段階

複数の 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件)

まだコメントはありません。