アバター改変でつまずいたとき、Console の赤いエラーをどう扱い、どう質問すれば良い回答をもらえるか。この記事では、エラーの読み方の基本、よく見るエラーの当たりの付け方、そのまま使える相談テンプレート、Unity が落ちたときのログの場所をまとめます。スクリーンショットだけの相談より、テキストで貼るほうが検索もでき、回答者も原因を追いやすくなります。
相談に必要な5点セット
「動きません」だけの相談は、回答者が同じことを聞き返すところから始まります。次の5点を先に書いておくと、1往復で解決に近づきます。
1. 何をしたら起きたか(操作を1文で)
2. 環境(Unity・VRChat SDK・使ったツールのバージョン)
3. 最初の赤いエラーの全文(文字で)
4. 試したこと
5. 期待した結果と実際の結果
エラー対処の基本フロー
ポイントは「最初の赤エラー1件に集中する」ことです。Unity ではひとつの原因から大量のエラーが連鎖します。Console を一度 Clear してから問題の操作を再現し、最初に出た赤をクリックして全文を確認しましょう。
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 して再現、最初の赤だけ全文コピー、直前の操作と環境を添えてテンプレートで相談。この型を身につければ、自力解決も他人への相談も一気に速くなります。
