トラブルシューティング

GRAY OASIS の導入や改変時に発生しやすい問題と、その解決策をまとめています。

---

マテリアルがピンク色になる

原因: 必要なシェーダー（Filamented Standard または Mochies-Unity-Shaders）がインポートされていないか、シェーダーの再コンパイルが必要です。

対処: 1. 必須アセット（Mochies-Unity-Shaders 等）がプロジェクトに正常に導入されているか確認してください。 2. ピンク色になっているマテリアルを選択し、Inspector の Shader ドロップダウンから適切なシェーダーを再割り当てしてください。

---

テクスチャがぼやける・真っ白で質感が反映されない

原因: 外部クラウドストレージから取得する追加テクスチャパッケージがインポートされていません。

対処: 1. 購入データに同梱されている「追加ファイルダウンロードリンク_v1.2.0.txt」を開きます。 2. 記載されたURLから GRAY_OASIS_Tex_Others.unitypackage をダウンロードし、プロジェクトへ追加インポートしてください。

---

部屋の中が真っ暗になる・影が異常に濃い

原因: Bakery を導入していない環境で、Bakery版のシーンを開いている可能性があります。

対処: 1. Bakery をお持ちでない場合は、Assets/MGR/GrayOasis/GrayOasis_builtin.unity（ビルトインライトマッパー版シーン）を開いてください。 2. それでも暗い場合は、Window > Rendering > Lighting から「Generate Lighting」を実行してライトマップを再生成してください。

---

QvPen で文字が書けない・同期しない

原因: QvPen の設定用 Udon コンポーネントが破損しているか、同期レイヤーの設定に不整合があります。

対処: 1. Hierarchy から QvPen の Prefab を選択し、Inspector に Missing（参照外れ）のスクリプトがないか確認してください。 2. 最新の QvPen パッケージを VCC / ALCOM から再インポート（Reinstall）してください。

---

ワールドの容量制限でアップロードが失敗する

原因: テクスチャ解像度が高すぎるか、不要なベイクデータが蓄積されています。

対処: 1. Assets/MGR/GrayOasis/Textures/ 配下の高解像度テクスチャ（4Kなど）の Max Size を、Inspector から 2048 または 1024 に下げて適用（Apply）してください。 2. 不要なシーンのライトマップデータが LightingData.asset 等に残っていないか確認してください。