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

Unityアバター改変のエラー相談テンプレート Consoleログの貼り方

アバター改変でつまずいたとき、Console の赤いエラーをどう扱い、どう質問すれば良い回答をもらえるか。この記事では、エラーの読み方の基本、よく見るエラーの当たりの付け方、そのまま使える相談テンプレート、Unity が落ちたときのログの場所をまとめます。スクリーンショットだけの相談より、テキストで貼るほうが検索もでき、回答者も原因を追いやすくなります。

相談に必要な5点セット

エラー相談に必要な5点セット

「動きません」だけの相談は、回答者が同じことを聞き返すところから始まります。次の5点を先に書いておくと、1往復で解決に近づきます。

1. 何をしたら起きたか(操作を1文で)
2. 環境(Unity・VRChat SDK・使ったツールのバージョン)
3. 最初の赤いエラーの全文(文字で)
4. 試したこと
5. 期待した結果と実際の結果

エラー対処の基本フロー

Unityエラー対処の基本フロー

ポイントは「最初の赤エラー1件に集中する」ことです。Unity ではひとつの原因から大量のエラーが連鎖します。Console を一度 Clear してから問題の操作を再現し、最初に出た赤をクリックして全文を確認しましょう。

Console の見方

Consoleの赤エラーを読む順番

Console は上部メニューの Window > General > Console で開けます。右上の3つのアイコンで「白(情報)・黄(警告)・赤(エラー)」の表示を切り替えられます。相談時に重要なのは赤のみで、黄色の警告は多くの場合すぐ問題にはなりません。

1. Console 左上の Clear を押す
2. 問題の操作(ビルド、Play、インポートなど)をもう一度行う
3. 一番上の赤い行を選ぶ。Collapse をオンにすると同じエラーがまとまる
4. 下部に出る全文(スタックトレース)を読む。ファイル名と行数が含まれる
5. 行をダブルクリックすると、該当のファイルやオブジェクトが開く
6. 赤い行を選択して Ctrl+C で全文をコピーし、相談に貼る

赤(Error)が1件でも残っていると、Play もビルドもアップロードも通りません。逆に言えば、赤を全部消せばスクリプト起因の問題は解決しています。

よく見るエラーと当たりの付け方

The referenced script ... is missing
 → スクリプト欠落。パッケージの未導入・インポート漏れが典型。
 Prefab に付いていた元のツールを VCC で入れる

Shader error in 'xxx' / マテリアルがピンク
 → シェーダー未導入かバージョン不一致。lilToon などを入れ直す

error CS0246: The type or namespace name ... could not be found
 → 依存パッケージ不足。VCC の Manage Project で SDK と依存を確認

NullReferenceException
 → 参照切れ。直前に消した・移動したオブジェクトが手がかり

The Avatar Descriptor is missing / Validation の赤
 → VRChat SDK のアバター設定不備。SDK コントロールパネルの指摘に従う

Mixed Write Defaults の警告(黄)
 → 表情が固まる原因になる。「Write Defaultsとは 表情バグの定番原因」
 https://virtualknowledge.jp/t/63/

英語のエラー文は、全文をそのまま検索にかけるのが最速です。エラー文は世界共通なので、同じ症状の解決例が見つかりやすくなります。エラーの先頭にある CS で始まる番号(CS0246 など)はスクリプトのコンパイルエラーで、ほぼ「必要なパッケージが入っていない」ことを意味します。

相談テンプレート(コピーして使えます)

【やりたいこと】例: ○○(衣装)を△△(アバター)に着せたい
【起きたこと】例: Play を押すと表情が動かない
【直前にした操作】例: FBX を再インポートした
【環境】Unity 2022.3.x / VCC / VRChat SDK 3.x / Modular Avatar 1.x / lilToon 1.x
【試したこと】例: 再インポート、新規プロジェクトでは再現しない
【最初の赤エラー全文】
(ここに Console からコピーした全文を貼る)

「直前にした操作」が最重要項目です。エラーの多くは直前の変更に起因します。環境のバージョンは VCC のプロジェクト画面と、Unity の Help > About Unity で確認できます。

ログファイルの場所

Unity が落ちて Console を見られないときは、Editor ログを確認します。場所は Windows なら次のパスです。

C:\Users\(ユーザー名)\AppData\Local\Unity\Editor\Editor.log

末尾数十行に直近のエラーが残っています。相談時はこの末尾を貼るだけでも十分役立ちます。VRChat 側のログ(ゲーム内で起きる不具合)は別の場所にあるので、Unity の問題か VRChat 内の問題かを先に切り分けてください。

自力で切り分けるときの順番

相談の前に次の3つを試すと、解決するか、少なくとも相談の材料が増えます。

新規プロジェクトで再現するか: VCC で新しいアバタープロジェクトを作り、アバターと問題のツールだけを入れて同じ操作をします。再現しなければ、元プロジェクトの残骸(古いパッケージや重複したアセット)が原因です。

直前の変更を戻す: バックアップから戻して1つずつ変更をやり直すと、どの操作で壊れるかが分かります(「改変プロジェクトのバックアップ術」改変プロジェクトのバックアップ術)。

引用記事改変プロジェクトのバックアップ術技術・制作

ツールのバージョンをそろえる: SDK とツールの組み合わせでエラーが出ることがあります。VCC で各パッケージを最新の安定版にそろえます。

落とし穴になりやすい点

スクリーンショットだけ貼る: 文字が小さくて読めず、検索もできません。赤い行を選んで Ctrl+C した全文を貼ってください。スクショは補助として添えるのは有効です。

黄色の警告を全部消そうとする: 警告は多くの場合そのままで動きます。まず赤だけを対象にします。

Clear せずに古いエラーを貼る: 別の作業のエラーが混ざり、回答者が誤った原因を追います。

環境を書かない: Unity や SDK のバージョン違いで解決策が変わります。バージョンは必ず添えてください。

よくある質問

Q. 赤エラーが何十件も出ます。全部貼るべき?
A. 最初の1件だけで十分です。残りは連鎖のことがほとんどです。

Q. 英語のエラーが読めません。
A. 全文をそのまま検索にかけるのが最速です。ファイルパスの部分は人によって違うので、エラー名とメッセージの部分で検索します。

Q. エラーは消えたのに動きません。
A. エラーなしの不具合は設定起因が多く、別の切り分けになります。「エラーは出ていない」ことも相談時に書き添えると回答が的確になります。表情や衣装トグルの不具合なら Write Defaults を先に疑ってください。

Q. どこで相談すればいい?
A. 当サイトの質問投稿(未解決マーク付き)でこのテンプレートを使うと回答が付きやすくなります。書き方は「質問スレッドの書き方 再現手順と環境情報をそろえる」を参照してください。

引用記事質問スレッドの書き方 再現手順と環境情報をそろえる技術・制作

まとめ

Clear して再現、最初の赤だけ全文コピー、直前の操作と環境を添えてテンプレートで相談。この型を身につければ、自力解決も他人への相談も一気に速くなります。