メインコンテンツまでスキップ
バージョン: Next

トラブルシューティング

よくある問題と対処方法をまとめています。 ここにない問題が起きた場合は、GitHub の Issues で報告してください。

見た目の問題​

変換後のアバターの明るさが PC 版と違う​

Mobile 用シェーダーはライティングの仕組みが PC 用シェーダーと異なるため、明るさの印象はワールドによって変わります。

Toon Lit で変換している場合は、マテリアル変換設定の「明るさ」で調整できます。 Toon Lit シェーダーは環境光で明るく表示されるため、初期値は 0.83 に設定されています。

透過を使った表現（頬染めなど）がおかしくなる​

Mobile 用シェーダーではテクスチャの透過が反映されません。 頬染めやメガネのレンズのような透過を前提とした表現は、そのままでは再現できません。

次のような対策があります。

非対応シェーダーの警告が表示される​

マテリアル変換は、次のシェーダーに対応しています。

  • Standard
  • Unity-Chan Toon Shader 2 (UTS2)
  • arktoon-Shaders
  • ArxCharacterShaders (AXCS)
  • Sunao Shader
  • lilToon
  • Poiyomi

これ以外のシェーダーを使用したマテリアルは、テクスチャが正しく生成されない可能性があります。 その場合は、次の方法を試してください。

  • 「Mobile用のテクスチャを生成する」をオフにして、シェーダーのみを変更する
  • Mobile 用のマテリアルを自分で用意し、「マテリアル置換」または VQT Material Swap で置き換える

スカートの裏側などが見えなくなる​

Mobile 用シェーダーではポリゴンの裏面が描画されません。 VQT Mesh Flipper でメッシュを両面化すると表示できます。

生成されたテクスチャの内容が古い、またはおかしい​

マテリアル変換で生成したテクスチャはキャッシュされています。 メニューバーの「Tools」→「VRCQuestTools」→「Clear Texture Cache」でキャッシュを削除してから、もう一度変換してください。

アップロードの問題​

プラットフォームを Android や iOS に切り替えられない​

Android への切り替えには Android Build Support、iOS への切り替えには iOS Build Support の各モジュールが必要です。 環境を準備するの手順でインストールしてください。 Unity Hub からインストールできない場合は、Unity ダウンロードアーカイブのインストーラーを使用してください。

パフォーマンスランクが Very Poor と表示される​

Mobile ではパフォーマンスランクが Very Poor でもアップロードはできます。 ただし、他のプレイヤーからはデフォルトでインポスターまたはフォールバックアバターとして表示されます。 見る側が「アバターの表示 (Show Avatar)」を個別に許可すると、本来のアバターが表示されます。

Avatar Dynamics のパフォーマンスランクが Very Poor になる​

PhysBone や Contact が多すぎる場合、アップロードしてもすべての PhysBone や Contact が VRChat 上で削除されます。 Avatar Dynamics のパフォーマンスランクが Poor に収まるように、コンポーネントを削減してください。

  • アバター変換を使う場合：VQT Avatar Converter Settings の「Avatar Dynamics 設定」で、残すコンポーネントを選択します。
  • アバター変換を使わない場合：メニューバーの「Tools」→「VRCQuestTools」→「Remove PhysBones」で削除するコンポーネントを選択します。

PhysBone の問題​

PC 版と Mobile 版で PhysBone の揺れ方が同期しない​

PhysBone を正しく同期させるには、PC 版と Mobile 版で PhysBone が同じネットワーク ID を持つ必要があります。

VQT Avatar Converter Settings の「Network ID を割り当てる」を有効にするか、VQT Network ID Assigner をアバターに追加してください。 その後、PC 用と Mobile 用の両方のアバターをアップロードし直すと同期するようになります。

Mobile 用の変換で PhysBone を削減している場合、1 つの GameObject に複数の PhysBone があると、正しく同期しないことがあります。

エラーと警告​

"Missing" 状態のコンポーネントがあると表示される​

インポートし忘れたアセットやパッケージがないかを確認してください。 Dynamic Bone のような有料アセットを含むアバターを、そのアセットのないプロジェクトで開いた場合にも発生します。

不要なコンポーネントであれば、メニューバーの「Tools」→「VRCQuestTools」→「Remove Missing Components」で削除できます。

Missing 状態のコンポーネント

Dynamic Bone に関する警告が表示される​

VRCQuestTools は Dynamic Bone を PhysBone に変換しません。 アバターを変換する前に、VRChat SDK の「VRChat SDK」→「Utilities」→「Convert DynamicBones To PhysBones」などで PhysBone へ移行してください。

Unity Constraints に関する警告が表示される​

Mobile では Unity 標準の Constraint コンポーネントを使用できず、変換時に削除されます。 VRChat Constraints へ移行すると Mobile でも使用できます。

Modular Avatar がプロジェクトにある場合は、アバターに「MA Convert Constraints」コンポーネントを追加すると、ビルド時に非破壊で VRChat Constraints へ変換されます。

Prefab モードでアバターを変換できない​

Prefab モードではアバターを変換できません。 Prefab モードを抜けて、シーンに戻ってから変換してください。

マスクテクスチャのエラーが表示される (Mesh Flipper)​

  • 「マスクテクスチャがありません」：VQT Mesh Flipper の「マスクテクスチャ」にテクスチャを設定してください。
  • 「マスクテクスチャは読み取り可能に設定されている必要があります」：テクスチャのインポート設定で「Read/Write」を有効にしてください。

非対応のテクスチャフォーマットと表示される​

Mobile で使用できないテクスチャ形式（DXT など PC 用の形式）がアバターに含まれています。 マニュアルベイクで作成したテクスチャを使用している場合は、ターゲットプラットフォームを切り替えた後で、もう一度マニュアルベイクしてください。