メインコンテンツまでスキップ

2026 VRChat 制作エラー情報

UnityやVRChatの内部用語が分からなくても使えるように、いま起きている症状から探せます。エラー文がある場合は、そのまま検索欄へ貼り付けてください。技術的な名前が分からなくても、症状とエラー文だけで探せます。

各事例は、まず見えている症状を読み、その直下のまず試すことを確認する構成です。技術的なタイトルは補助情報として小さく表示し、原因、環境、根拠は必要なときだけ詳細を開いて確認できます。

表示対象は、VRChatが対応するUnity 2022.3.22f1 が記録内で明示された2026年の事例です。解決策が確認できていないものは推測で埋めず、調査中として発生条件と根拠を残します。

132既知事例
12現行Unity確認済み
97解決済み
20回避策あり
15調査中

困っている症状から探す

原因が分からなくても大丈夫です。いま見えている症状から選んでください。

環境や技術情報で詳しく絞り込む
132 件見つかりました
調査中Modular Avatar2026-08-16

Trace And OptimizeがMA Object Toggle管理下のMeshRendererを削除することがある

症状: 特定HierarchyでMA Object Toggleが管理するMeshRendererオブジェクトが最適化中に削除されることがある。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

レンダリング
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
該当するMA Object Toggle HierarchyへTrace And Optimizeを実行する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
Avatar Optimizer, Modular Avatar
根拠
  • github.com — Avatar Optimizer / GitHub Issue / anatawa12/AvatarOptimizer / 根拠対象: title, date, environment, symptom, trigger
解決済みVRChat SDK2026-08-10

VRCFuryがGesture ManagerのplayerId代入による新しいglobal colliderの不具合を修正

症状: Gesture Managerの旧来のplayerId代入処理が有効なとき、global colliderのplayerId動作が正しくならない場合がある。

まず試すこと

Gesture Manager側のplayerId書き込みを抑止し、SDK側に代入を任せる修正を含むVRCFuryを使用する。

シミュレーション / プレビュープレビュー
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
global colliderなど新しいVRCSDKのAvatar DynamicsコンポーネントとGesture Managerを併用する。
原因
VRCFury maintainerのコメントでは、Gesture Managerは古いVRCSDKがplayerIdを設定しなかったため独自に設定しているが、global colliderなど一部の新しいコンポーネントには設定しないため、代入経路が混在して壊れると説明されている。
解決策・回避策
  • 解決策: Gesture Manager側のplayerId書き込みを抑止し、SDK側に代入を任せる修正を含むVRCFuryを使用する。
パッケージ
VRCFury, VRC Gesture Manager, VRChat SDK - Avatars
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありVRC Gesture Manager2026-08-05

Gesture ManagerではVRCRaycastのHitがfalseだがcomponent側ではtrueになる

症状: raycast componentのHit boolはtrueなのにGesture Managerのdebug parameterではfalseとなる。同じ設定はVRChat本体では動作する。

まず試すこと

このparameterについてはGesture ManagerではなくVRChat本体で挙動を検証する。

エディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
新しいVRCRaycast componentをGesture Managerのemulationで使用する。
解決策・回避策
  • 回避策: このparameterについてはGesture ManagerではなくVRChat本体で挙動を検証する。
パッケージ
VRC Gesture Manager
根拠
  • github.com — VRC Gesture Manager / GitHub Issue / BlackStartx/VRC-Gesture-Manager / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みModular Avatar2026-08-03

Reaction Debuggerを初期化前に開くとNullReferenceExceptionが発生する場合がある

症状: Reaction Debuggerを開いた際、refresh処理でNullReferenceExceptionが発生する場合がある。

まず試すこと

RefreshUIで空のoverride dictionaryを初期化し、nullのForcePropertyOverridesも許容する修正を含むModular Avatarを使用する。

パッケージ管理エディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
NullReferenceException
発生条件
遅延されたOnEnable初期化がproperty/menu override状態を設定する前にReaction Debuggerを開く。
原因
OpenDebuggerが遅延初期化より先にUIをrefreshし、ResolveToggleInitialStates実行時にForcePropertyOverridesまたはoverride dictionaryがnullのままになる。
解決策・回避策
  • 解決策: RefreshUIで空のoverride dictionaryを初期化し、nullのForcePropertyOverridesも許容する修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-08-01

SDK 3.10.4でアバタータグ未設定のままアップロードするとtags nullエラーで失敗する

症状: テストビルドは成功するが、実際のアバターアップロードではメタデータ作成・更新時に失敗する。

まず試すこと

アップロード前にアバタータグを1つ以上設定する。リンク先のVRChat Feedbackでは将来リリースで対応予定とされている。

アップロード / 公開アップロードUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
エラー文字列
tags must be an array: null, tags must be a string: 'null'
発生条件
VRChat SDK 3.10.4でアバタータグを1つも設定せずにアップロードする。
原因
フォーラムでは、タグのアップロード処理にあるSDK 3.10.4の既知不具合として案内されている。
解決策・回避策
  • 解決策: アップロード前にアバタータグを1つ以上設定する。リンク先のVRChat Feedbackでは将来リリースで対応予定とされている。
  • 回避策: 任意のアバタータグを1つ設定してからアップロードする。
パッケージ
VRChat SDK - Avatars 3.10.4
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRCFury2026-07-31

autorigされたmeshでSPSのmaterial swapが正しく動かない

症状: 対象meshがautorigされると、SPSのmaterial swapが正しく動作しない。

まず試すこと

autorig後のSPS material binding修正を含むVRCFuryを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
autorigによりMeshRendererからSkinnedMeshRendererへ変換されるrendererにSPS bakeを行う。
原因
修正diffでは、autorig変換後のblendshape・material slot書き換えで元のMeshRenderer bindingを使い続けず、最終的なSkinnedMeshRenderer bindingを使う必要があることが示されている。
解決策・回避策
  • 解決策: autorig後のSPS material binding修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-31

synced layerでoverrideされていないmotionが残る場合がある

症状: synced Animator layerで、そのstateにoverride motionがないにもかかわらず以前のmotionが残る場合がある。

まず試すこと

nullを含むoverride結果を常に読み込み、overrideされていないmotionを除去する修正を含むVRCFuryを使用する。

プロジェクト設定ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
override motionがnullのstateを含むsynced Animator layerをVRCFuryで読み込み・書き換える。
原因
loaderはGetOverrideMotionがnon-nullのときだけwrapped stateのmotionを置き換えていたため、null overrideでは既存motionが残っていた。
解決策・回避策
  • 解決策: nullを含むoverride結果を常に読み込み、overrideされていないmotionを除去する修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありModular Avatar2026-07-28

Modular Avatar Vertex Filter By Maskでmaterial slotのdropdownが消える

症状: カスタムInspectorにmaterial slotを選ぶdropdownが表示されなくなる。

まず試すこと

InspectorをDebugへ切り替え、値を手動編集する。

パッケージ管理エディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
報告されたパッケージversionでMA Vertex Filter - By MaskをInspector表示する。
解決策・回避策
  • 回避策: InspectorをDebugへ切り替え、値を手動編集する。
パッケージ
Modular Avatar 1.17.1, NDMF 1.14.1
根拠
  • github.com — Modular Avatar / GitHub Issue / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みVRCFury2026-07-28

Hierarchy内のobject名がスラッシュで終わるとanimation target lookupが壊れる

症状: 名前末尾がスラッシュのobjectを含むHierarchyで、VRCFuryのanimation target lookupが壊れる。

まず試すこと

relative animation path resolverの修正を含むVRCFuryを使用する。

パッケージ管理ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
名前が「/」で終わるHierarchy objectを経由するanimation bindingを解決する。
原因
relative path resolverがこのHierarchy pathのedge caseを正しく扱えておらず、修正ではbase pathとrelative pathの処理を分離して正規化ロジックを変更している。
解決策・回避策
  • 解決策: relative animation path resolverの修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-28

SPS shader patchがLightMode = NeverのpassでlilToon errorを起こす場合がある

症状: 対象shader pathでVRCFuryのSPS shader patchによりlilToon errorが発生する。

まず試すこと

lilToon向けSPS shader patch修正を含むVRCFuryを使用する。

シェーダー / マテリアルビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
LightMode = Neverと指定されたpassを含むlilToon shaderをSPSでpatchする。
原因
maintainer commitでは、LightMode = NeverのpassをSPS patch対象から除外し、不足していたUnityShaderVariables includeを追加することでlilToon errorを修正している。
解決策・回避策
  • 解決策: lilToon向けSPS shader patch修正を含むVRCFuryを使用する。
パッケージ
VRCFury, lilToon
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
調査中VRChat ClientSim2026-07-27

VRChat本体では操作できるのにClientSimではStation Collider越しにInteractできない

症状: Station Colliderの奥にあるInteractableがClientSimでは無視される一方、現行VRChatクライアントでは操作できる。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

シミュレーション / プレビューテスト
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Rayの送出元とInteractableの間にStation Colliderを置く。
原因
報告では、現在のClient挙動と一致しなくなった過去仕様のCollider無視判定が残っていることが指摘されている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat ClientSim
根拠
  • github.com — VRChat ClientSim / GitHub Issue / vrchat-community/ClientSim / 根拠対象: title, date, environment, symptom, trigger, root_cause
解決済みVRCFury2026-07-27

shaderが大量にあるprojectでplatform switchingが極端に遅くなる

症状: shader数の多いUnity projectでbuild platformの切り替えが非常に遅くなる。

まず試すこと

import発生時に小さなshader property cacheを一度clearし、必要なshaderだけlazyに再生成する修正を含むVRCFuryを使用する。

プロジェクト設定ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
VRCFuryのshader property cache invalidationが有効な状態でplatformを切り替え、Unityが多数のshaderを再importする。
原因
asset postprocessorがimportされたshaderを1件ずつloadしてcache entryを削除しており、全shader再import時に非常に高コストになっていた。
解決策・回避策
  • 解決策: import発生時に小さなshader property cacheを一度clearし、必要なshaderだけlazyに再生成する修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みModular Avatar2026-07-26

旧Modular Avatarから移行するとBlendshape Syncのcurve設定が不正になる場合がある

症状: 古いModular Avatarで作成したBlendshape Syncを移行すると、remap curveが不正になる場合がある。

まず試すこと

旧bindingを0→100のlinear identity curveとして初期化するRemapCurveIsValid migration修正を含むModular Avatarを使用する。

アニメーションインポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
RemapCurveの有効フラグ導入前に作成されたBlendshape Syncデータを開く、または移行する。
原因
旧bindingにはcurveの有効性を示す明示的な状態がなく、未初期化のserialized curveを有効なremap curveとして扱う場合があった。
解決策・回避策
  • 解決策: 旧bindingを0→100のlinear identity curveとして初期化するRemapCurveIsValid migration修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-26

generic Animatorから参照されるVRCFury生成avatar rigが保存されない場合がある

症状: generic Animatorが使用するVRCFury生成avatar rigがgenerated assetへ保存されない場合がある。

まず試すこと

RendererとAudioSourceに加えてAnimator componentから参照されるunsaved assetも保存する修正を含むVRCFuryを使用する。

アバターリグビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
generic Animator componentから参照されるAvatar rig assetをVRCFuryが生成または変更するavatarをbuildする。
原因
save passはRendererとAudioSourceを走査していたがAnimator componentを走査しておらず、generic Animatorからのみ到達できるgenerated Avatar assetを取りこぼしていた。
解決策・回避策
  • 解決策: RendererとAudioSourceに加えてAnimator componentから参照されるunsaved assetも保存する修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-07-26

Load In Background有効化のためcloneされたVRCAnimatorPlayAudioのAudioClip参照が失われる場合がある

症状: VRCFuryがLoad In Backgroundを有効にするためcloneしたVRCAnimatorPlayAudioのAudioClip参照が失われる場合がある。

まず試すこと

VRCAnimatorPlayAudioのclip保持修正を含むVRCFuryを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
VRCFuryがLoad In Background有効化のためVRCAnimatorPlayAudioのclipをcloneするavatarをbuildする。
原因
save pathがVRCAnimatorPlayAudioから参照されるAudioClip assetをすべて保持していなかった。修正ではsub-controllerを含めてclipを列挙しsave contextへ追加している。
解決策・回避策
  • 解決策: VRCAnimatorPlayAudioのclip保持修正を含むVRCFuryを使用する。
パッケージ
VRCFury, VRChat SDK - Avatars
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-26

sub-animator controllerにVRChat Base layer向けmask処理が誤適用される場合がある

症状: sub-animator controllerのlayer maskがVRChat Base animator layerとして扱われ、意図しないdistributionを受ける場合がある。

まず試すこと

sub-animator controllerをVRChat Base typeにせずplain VFControllerとして読み込む修正を含むVRCFuryを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
build中にVRCFuryが保存済みsub-animator controllerを再読み込みする。
原因
sub-animator reload pathがVRCAvatarDescriptor.AnimLayerType.Baseを指定してVFControllerWithVrcType.Loadを使い、generic sub-controllerにVRChat layer typeの処理を適用していた。
解決策・回避策
  • 解決策: sub-animator controllerをVRChat Base typeにせずplain VFControllerとして読み込む修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-07-26

有効なAnimator Play Audioだけを持つsub-animatorがpurgeされる場合がある

症状: 有効なAnimator Play Audio actionを持っているにもかかわらずsub-animatorが削除される場合がある。

まず試すこと

sub-animator削除前にAnimator Play Audioのtargetも確認する修正を含むVRCFuryを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
有効なanimation clip bindingはないが、配下objectをtargetにするVRCAnimatorPlayAudioを持つsub-animatorを使用する。
原因
empty animator cleanupは有効なclip bindingだけを見ており、Animator Play Audio behaviourを考慮せずcontrollerをemptyと判定していた。
解決策・回避策
  • 解決策: sub-animator削除前にAnimator Play Audioのtargetも確認する修正を含むVRCFuryを使用する。
パッケージ
VRCFury, VRChat SDK - Avatars
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
調査中lilToon2026-07-24

同じBlendTreeへ多数の経路から到達できるとlilOptimizerに数分かかることがある

症状: 複雑なBlendTree graphでは同じclipを数万回処理し、最適化に数分かかることがある。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

アニメーション
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
同一BlendTree／AnimationClipへ多数の経路から到達できるgraphを使用する。
原因
報告ではVRChatModule.GetAnimationClipsFromGameObjectに重複排除がないことが原因とされている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
lilToon
根拠
  • github.com — lilToon / GitHub Issue / lilxyzw/lilToon / 根拠対象: title, date, environment, symptom, trigger, root_cause
解決済みVRCFury2026-07-24

Modular Avatar Object Replacementでhumanoid boneを置換するとarmature lookupが失敗する場合がある

症状: Modular Avatar Object Replacementがbuild中にbone objectを置換した後、VRCFuryがhumanoid armature boneを解決できない場合がある。

まず試すこと

複数のobject path・armature snapshotを保持し、build-time hierarchy replacement後もそれらを横断して解決する修正を含むVRCFuryを使用する。

パッケージ管理依存関係解決
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
後続のVRCFury featureがarmatureまたはanimation path lookupを行う前にModular Avatar Object Replacementでhumanoid boneを置換する。
原因
armatureとobject path lookupが以前のsnapshotに依存しており、build-time object replacement後のhierarchyを表せなくなっていた。
解決策・回避策
  • 解決策: 複数のobject path・armature snapshotを保持し、build-time hierarchy replacement後もそれらを横断して解決する修正を含むVRCFuryを使用する。
パッケージ
VRCFury, Modular Avatar
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みModular Avatar2026-07-23

ConsoleにerrorがないのにModular Avatar Inspector項目が消え、UserSettings再生成で復旧する事例

症状: Modular Avatar component自体は残るが、通常のInspector設定項目がすべて消える。Consoleには赤errorが表示されない。

まず試すこと

Unityを閉じ、projectのUserSettings folderをrename／backupし、Unityを再起動してUserSettingsを再生成しMA Inspectorが戻ることを確認する。

パッケージ管理エディターUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
同じpackage versionで以前は動作していたprojectにおいて、project固有のEditor state failureとして発生した。正確なtriggerは確定していない。
解決策・回避策
  • 解決策: Unityを閉じ、projectのUserSettings folderをrename／backupし、Unityを再起動してUserSettingsを再生成しMA Inspectorが戻ることを確認する。
  • 回避策: UserSettingsをbackup後に再生成する。記事ではpackage再導入やLibrary再生成では解決しなかった。
パッケージ
Modular Avatar 1.17.1, NDMF 1.14.1
根拠
  • blog.yu-suz.com — Yu Suzumi blog / 記事 / 根拠対象: title, date, environment, symptom, trigger, remedies
調査中vrc-get / ALCOM2026-07-23

パッケージ外を指すsymlinkを含むとALCOMのパッケージ導入がpanicする

症状: 外部symlinkを含むユーザーパッケージの導入でエラーとなり、ALCOMを完全停止するまで処理中表示が続く。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

パッケージ管理導入
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
thread 'tokio-rt-worker' panicked at 'unknown file type: none of file, dir, symlink'
発生条件
READMEやLICENSEのsymlinkがパッケージdirectory外を指すユーザーパッケージを登録・導入する。
原因
stack traceではcopy_recursiveがsymlink経由のfile typeでpanicしている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
ALCOM 1.1.8
根拠
  • github.com — vrc-get / ALCOM / GitHub Issue / vrc-get/vrc-get / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause
解決済みVRCFury2026-07-23

generated animation clip内だけに存在するgenerated material assetが保存されない

症状: generated animation clipからのみ参照されるVRCFury生成materialがgenerated assetとして保存されない。

まず試すこと

generated materialのasset保存修正を含むVRCFuryを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
generated clipのobject-reference keyframe valueとしてのみ存在するmaterialを生成する。
原因
clipのsave pathがgenerated object-reference keyframe valueをnew assetとして登録していなかった。修正ではobject curveを走査しVRCFuryが生成したkeyframe valueを保存する。
解決策・回避策
  • 解決策: generated materialのasset保存修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-23

SPS markerのMeshFilter meshがgenerated asset保存時に失われる場合がある

症状: generated asset保存後にSPS markerのMeshFilterが参照していたmeshが失われる場合がある。

まず試すこと

MeshFilter componentから参照されるunsaved component assetも保存する修正を含むVRCFuryを使用する。

レンダリングビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
MeshFilter経由でgenerated meshを参照するSPS markerを含むavatarをbuildする。
原因
asset-saving traversalはRenderer componentのunsaved assetを保存していたがMeshFilter componentを走査しておらず、MeshFilterからのみ到達できるmarker meshを落としていた。
解決策・回避策
  • 解決策: MeshFilter componentから参照されるunsaved component assetも保存する修正を含むVRCFuryを使用する。
パッケージ
VRCFury
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRCFury2026-07-21

GoGoLocoのcross-state-machine transitionがcontroller clone/save後に壊れる場合がある

症状: GoGoLocoで使われるstate machine間transitionがVRCFuryによるcontroller cloneまたはserialize後に失われるか誤ったdestinationへ解決される場合がある。

まず試すこと

state-machine graph全体を先にclone/saveし、完全なmapを使って別のrecursive transition passを行う修正を含むVRCFuryを使用する。

パッケージ管理依存関係解決
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
GoGoLocoのようにnested state machine間のtransitionを持つAnimatorControllerをVRCFuryで処理する。
原因
state machineを再帰的にclone/saveしている途中でtransitionをlinkしており、cross-machine destinationに必要なstate・state-machine mapが完成していなかった。
解決策・回避策
  • 解決策: state-machine graph全体を先にclone/saveし、完全なmapを使って別のrecursive transition passを行う修正を含むVRCFuryを使用する。
パッケージ
VRCFury, GoGoLoco
根拠
  • github.com — VRCFury / GitHub Commit / VRCFury/VRCFury / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat Creator Companion2026-07-19

配布ギミックに「Missing (Mono Script)」が出る

症状: unitypackageをインポートした後、PrefabのInspectorで複数のMono ScriptがMissing表示になる。

まず試すこと

VCCのManage ProjectからModular Avatarを追加し、Missing表示だったMA Menu Installer、MA Merge Animator、MA Parametersが復元されることを確認する。

パッケージ管理インポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Missing (Mono Script)
発生条件
記事の事例ではModular Avatarを前提とするギミックを、Modular Avatarが入っていないプロジェクトへインポートした。
原因
記事の事例では前提パッケージのModular Avatarがプロジェクトに入っていなかった。
解決策・回避策
  • 解決策: VCCのManage ProjectからModular Avatarを追加し、Missing表示だったMA Menu Installer、MA Merge Animator、MA Parametersが復元されることを確認する。
パッケージ
Modular Avatar
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
回避策ありVRChat SDK2026-07-19

Quest版アバターで音ギミックのAudio Sourceが除去され音が鳴らない

症状: Quest版ではメニューやアニメーションは動作しても、アバター上の音ギミックが無音になる。

まず試すこと

アバター側の音源を前提にせず、必要ならワールド側で音を出す設計にする。

実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
The following component types are found on the Avatar and will be removed by the client: VRCSpatialAudioSource, Audio Source
発生条件
Android / Quest向けアバターにAudio SourceまたはVRCSpatialAudioSourceを含める。
原因
2026年のVRChat公式Performance Ranksでは、モバイルアバターのAudio Sourcesは無効化・除去される対象として記載されている。
解決策・回避策
  • 回避策: アバター側の音源を前提にせず、必要ならワールド側で音を出す設計にする。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
  • creators.vrchat.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
調査中lilToon2026-07-18

lilToonのmaterial最適化でUV Tilingが誤ってtextureへ焼き込まれる

症状: UV Tilingが1以外のmaterialを最適化Bakeすると、tilingが誤った形でtextureへ焼き込まれる。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

プロジェクト設定ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
X=1／Y=2などのUV Tilingを使い、layer／material最適化をBakeする。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
lilToon
根拠
  • github.com — lilToon / GitHub Issue / lilxyzw/lilToon / 根拠対象: title, date, environment, symptom, trigger
調査中Modular Avatar2026-07-16

NDMF Manual BakeでCopyAsset直後のコピー先アセットを読み込めない

症状: Manual Bake中にCopyAssetはtrueを返すが、直後のLoadAssetAtPathではコピー先がnullになる。同じプラグイン処理はPlay Modeの自動ビルドでは成功する。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

ビルド / 検証ビルドUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
エラー文字列
AssetDatabase.LoadAssetAtPath<T>() returns null immediately after AssetDatabase.CopyAsset() during Manual Bake
発生条件
Manual Bake中に出力フォルダを作成し、新規アセットをCopyAssetで複製して直後に読み込むNDMF生成パスを実行する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
NDMF 1.14.0, Modular Avatar 1.17.1
根拠
  • github.com — NDMF / GitHub Issue / bdunderscore/ndmf / 根拠対象: title, date, environment, symptom, error_signature, trigger
回避策ありvrc-get / ALCOM2026-07-14

ALCOMの更新後再起動でUnityや子プロセスがNTFSジャンクションをたどれなくなる

症状: アプリ内更新からの再起動後、Unity Package Managerや子のuvプロセスがユーザー作成のNTFSジャンクションをたどれなくなる。

まず試すこと

更新処理から再起動されたALCOMを完全終了し、ALCOMを通常起動してからUnityを起動し直す。

パッケージ管理依存関係解決
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
STATUS_UNTRUSTED_MOUNT_POINT / Win32 error 448
発生条件
ALCOM 1.1.7から1.1.8へアプリ内更新し、更新処理から再起動されたALCOMからUnityを起動する。
解決策・回避策
  • 回避策: 更新処理から再起動されたALCOMを完全終了し、ALCOMを通常起動してからUnityを起動し直す。
パッケージ
ALCOM 1.1.8
根拠
  • github.com — vrc-get / ALCOM / GitHub Issue / vrc-get/vrc-get / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
調査中VRChat Creator Companion2026-07-12

リモートrepositoryのtimeout後にVCCのプロジェクト作成が進まなくなる

症状: リモートVPM repository要求がtimeoutすると、Avatar／Worldどちらのプロジェクト作成も停止する。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

パッケージ管理セットアップ
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
The request was canceled due to the configured HttpClient.Timeout of 600 seconds elapsing.
発生条件
VRCFuryなど設定済みrepositoryが600秒以内に応答しない状態でプロジェクトを作成する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat Creator Companion 2.4.5
根拠
  • github.com — VRChat Creator Companion / GitHub Issue / vrchat-community/creator-companion / 根拠対象: title, date, environment, symptom, error_signature, trigger
回避策ありvrc-get / ALCOM2026-07-11

ALCOM 1.1.6〜1.1.7のinstallerはWebView2未導入環境で自動導入に失敗する

症状: WebView2が存在しない環境でinstallerがWebView2 installerを起動できない。

まず試すこと

ALCOMより先にWebView2を個別導入する。

パッケージ管理導入
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
WebView2未導入のWindowsへALCOM 1.1.6〜1.1.7を導入する。
解決策・回避策
  • 回避策: ALCOMより先にWebView2を個別導入する。
パッケージ
ALCOM 1.1.6–1.1.7
根拠
  • github.com — vrc-get / ALCOM / GitHub Issue / vrc-get/vrc-get / 根拠対象: title, date, environment, symptom, trigger, remedies
回避策ありPoiyomi Toon Shader2026-07-09

PoiyomiのLTCGIを有効にするとAndroid／Quest実行時にshader表示が壊れる

症状: Editorでは正常でも、Android／Quest実行時にLTCGIを有効にしたmaterialが壊れる、または見えなくなる。

まず試すこと

影響を受けるAndroid／Quest向けではLTCGIを無効にする。

シェーダー / マテリアル実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Android／QuestでLTCGIを有効にしたshaderを実行する。
解決策・回避策
  • 回避策: 影響を受けるAndroid／Quest向けではLTCGIを無効にする。
パッケージ
Poiyomi Toon Shader 9.3.64
根拠
  • github.com — Poiyomi Toon Shader / GitHub Issue / poiyomi/PoiyomiToonShader / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みUnity2026-07-03

VRM1.0をVRM Converter for VRChatへ入れても変換されない

症状: VRMファイルをUnity EditorのAssetsへ入れてもVRChat向けアバターへ変換できない。

まず試すこと

VRoid StudioからVRM0.0形式でエクスポートし直し、VRM Converter for VRChatで変換する。

インポート / エクスポートインポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
VRoid StudioからVRM0.0ではなくVRM1.0でエクスポートしたファイルをVRM Converter for VRChatへ渡す。
原因
記事の事例ではVRM1.0が使用中のVRM Converter for VRChatで対応していない形式だった。
解決策・回避策
  • 解決策: VRoid StudioからVRM0.0形式でエクスポートし直し、VRM Converter for VRChatで変換する。
パッケージ
VRM Converter for VRChat
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みAvatar Optimizer2026-07-03

AAO使用時にActualPerformanceWindow未有効だとAvatar uploadに失敗した事例

症状: AAO Trace And Optimize追加後、uploadを押しても成功しない事例が報告されている。

まず試すこと

記事のworkflowではActualPerformanceWindowを有効にして再試行する。事例依存の対処として扱う。

アップロード / 公開アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
anatawa12のgist packにあるActualPerformanceWindowを有効化せず、記事のworkflowを使用する。
原因
記事では環境内の相関を報告しているが、一般的な根本原因は確定していない。
解決策・回避策
  • 解決策: 記事のworkflowではActualPerformanceWindowを有効にして再試行する。事例依存の対処として扱う。
  • 回避策: ActualPerformanceWindowを有効にしてuploadを再試行する。
パッケージ
Avatar Optimizer
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みother2026-07-03

記事のworkflowではVRM Converter for VRChatでVRM 1.0を書き出しAvatarへ変換できない

症状: VRMをUnityへdragしても、記事のworkflowでは変換可能なAvatarにならない。

まず試すこと

そのworkflowではmodelをVRM 0.0としてexportする。

インポート / エクスポートインポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
対象converter version向けにVRoid modelをVRM 0.0ではなくVRM 1.0でexportする。
原因
記事では使用したconverter経路がVRM 1.0へ対応していないことを原因としている。
解決策・回避策
  • 解決策: そのworkflowではmodelをVRM 0.0としてexportする。
パッケージ
VRM Converter for VRChat
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みAvatar Optimizer2026-07-03

VRoid AvatarでPhysBone指標が高くPerformance Poorが残る事例

症状: 単純なVRoid AvatarでもAvatar Optimizer導入後にPhysBone関連warningが複数残り、Poor評価になる。

まず試すこと

記事で検証されたmaterial削減設定を試しSDK performance reportを再確認する。普遍的なPhysBone修正ではなく事例固有の対処として扱う。

PhysBones / Contacts検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
記事でmaterial数を減らす前のVRoid export設定を使用する。
原因
報告ではVRoid export時のmaterial数を2へ減らすとその事例のPhysBone関連Poor状態が消えたが、一般的な因果機構までは確定していない。
解決策・回避策
  • 解決策: 記事で検証されたmaterial削減設定を試しSDK performance reportを再確認する。普遍的なPhysBone修正ではなく事例固有の対処として扱う。
パッケージ
Avatar Optimizer
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みother2026-06-30

MToon10がないとXWear PackagerでXAvatarをimportできない

症状: model shader依存関係がない状態ではXWear Packager経由のXAvatar importに失敗する。

まず試すこと

XAvatar import前にMToon10を含むUniVRM（VRM 1.0）を導入する。

パッケージ管理依存関係解決Unity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
MToon10がプロジェクトにない状態でVRoid XAvatarをimportする。
原因
記事ではMToon10 shader依存関係の欠落を原因としている。
解決策・回避策
  • 解決策: XAvatar import前にMToon10を含むUniVRM（VRM 1.0）を導入する。
パッケージ
XWear Packager, UniVRM / MToon10
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-30

VRChat SDK - Avatarsが古いとXWear Packagerを導入できない

症状: 古いAvatar SDKを使うプロジェクトへXWear Packagerを導入できない。

まず試すこと

XWear Packager導入前にVCCでVRChat SDK - Avatarsを更新する。

パッケージ管理導入Unity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
VRChat SDK - Avatars 3.7.1未満の状態でXWear Packagerを導入する。
原因
記事ではXWear PackagerがVRChat SDK - Avatars 3.7.1以上を要求するとしている。
解決策・回避策
  • 解決策: XWear Packager導入前にVCCでVRChat SDK - Avatarsを更新する。
パッケージ
XWear Packager, VRChat SDK - Avatars <3.7.1
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みModular Avatar2026-06-28

Blendshape Syncで1つのtarget meshが欠落すると後続bindingのpreviewまで止まる

症状: 1つのBlendshape Sync bindingのtarget meshが欠落していると、それより後ろの正常なbindingもeditor previewで更新されなくなる。

まず試すこと

null TargetMeshをcontinueでskipするpreview修正を含むModular Avatarを使用する。

シミュレーション / プレビュープレビュー
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
nullまたはdestroy済みTargetMeshを、後続の正常bindingより前に含むBlendshape Syncをpreviewする。
原因
EditorUpdateがTargetMesh == nullのとき、そのbindingだけをskipせずbinding loop全体からreturnしていた。
解決策・回避策
  • 解決策: null TargetMeshをcontinueでskipするpreview修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みModular Avatar2026-06-28

反転されたconstant conditionでReactiveのIsConstantActive判定が逆になる

症状: 反転されたconstant conditionを持つReactive ruleが、本来inactiveなのにactiveと判定される場合がある。

まず試すこと

inversion済みのInitiallyActive値をそのまま使うIsConstantActive修正を含むModular Avatarを使用する。

アニメーションビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
conditionがinvertedされたconstant reaction ruleを解析する。
原因
InitiallyActive側ですでにinversionを反映しているのに、旧IsConstantActive式がInvertedを再度XORして結果をもう一度反転していた。
解決策・回避策
  • 解決策: inversion済みのInitiallyActive値をそのまま使うIsConstantActive修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みModular Avatar2026-06-28

Merge Armatureのmerge targetや途中のboneが欠落するとMapBoneでNullReferenceExceptionが起きる場合がある

症状: merge target未設定またはtarget hierarchyの途中bone欠落時、unmappableとして扱われずMapBoneがNullReferenceExceptionを投げる場合がある。

まず試すこと

merge targetまたは中間transformが見つからない場合にnullを返すMapBone修正を含むModular Avatarを使用する。

アバターリグビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
NullReferenceException
発生条件
mergeTarget未設定のMerge Armature、または対応するtarget hierarchyに中間boneがない状態でchild boneをmapする。
原因
MapBoneがmergeTarget.Get(this)をnull checkせずdereferenceし、さらにTransform.Findがnullを返した後も次のFindを呼び続けていた。
解決策・回避策
  • 解決策: merge targetまたは中間transformが見つからない場合にnullを返すMapBone修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みModular Avatar2026-06-28

Visible Head Accessoryのmesh retargetでbindpose計算が不正になる場合がある

症状: visible boneとnon-visible boneのweightが混在するmeshをretargetすると、Visible Head Accessoryのskinned mesh処理結果が不正になる場合がある。

まず試すこと

Visible Head Accessoryのmesh/bindpose処理修正を含むModular Avatarを使用する。

ファイルシステム / プロセスビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
visible/non-visible boneにweightされたvertexが同一primitive内にあり、proxy boneへのretargetが必要なVisible Head Accessory meshをbuildする。
原因
従来のmesh retarget pathでは影響boneのremap時にbindpose処理が正しくなく、maintainer修正ではvertex clone、bone remap、bindpose生成を明示的に組み直している。
解決策・回避策
  • 解決策: Visible Head Accessoryのmesh/bindpose処理修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みAvatar Optimizer2026-06-25

AAO Merge Skinned Meshで統合すると表示切替やリップシンクが壊れる

症状: AAO Merge Skinned Meshで衣装や頭部メッシュをまとめた後、衣装の表示・非表示Animationが効かなくなったり、MMDワールドでリップシンクが動かなくなった。

まず試すこと

表示切替ギミックを持つメッシュや頭部など表情制御に関係するメッシュを統合対象から外し、再度動作確認する。

アニメーション実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Animationや表情用BlendShapeで制御されるSkinnedMeshRendererをAAO Merge Skinned Meshの統合対象へ含める。
原因
記事の事例では、統合対象にギミックや表情制御に使われるメッシュを含めたことで既存AnimationやBlendShape制御が期待通り動作しなくなった。
解決策・回避策
  • 解決策: 表示切替ギミックを持つメッシュや頭部など表情制御に関係するメッシュを統合対象から外し、再度動作確認する。
パッケージ
Avatar Optimizer
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRC Gesture Manager2026-06-25

Unityで変更した見た目がAnimatorの既存Animationに上書きされゲーム内へ反映されない

症状: Unity上でシェイプキーやマテリアルを変更しても、Gesture Managerやゲーム内では元の外見へ戻ってしまう。

まず試すこと

対象Animator Controllerをバックアップし、外見を制御しているAnimationを特定して必要な変更または無効化を行う。

アニメーション実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
既存のAnimator Controller内のAnimationが同じシェイプキー、マテリアル色、衣装状態を制御している。
原因
記事の事例では既存Animationが改変後のデフォルト値を上書きしていた。
解決策・回避策
  • 解決策: 対象Animator Controllerをバックアップし、外見を制御しているAnimationを特定して必要な変更または無効化を行う。
パッケージ
Unity Animator
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みother2026-06-25

ボーン階層をEditorOnlyにすると衣装パーツがワールド原点へ固着する

症状: PhysBoneを減らす目的でボーン階層をEditorOnlyにした結果、関連する衣装パーツがアバターへ追従せずワールド原点へ固着した。

まず試すこと

EditorOnlyにしたボーンを特定してUntaggedへ戻す。記事では復旧困難な場合にPrefabを入れ直している。

PhysBones / Contacts実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
PhysBoneコンポーネントだけでなく、それを含むボーンGameObject自体をEditorOnlyにする。
解決策・回避策
  • 解決策: EditorOnlyにしたボーンを特定してUntaggedへ戻す。記事では復旧困難な場合にPrefabを入れ直している。
  • 回避策: 破損前のPrefabへ戻し、PhysBone削減はボーン階層ではなく対象コンポーネント単位で行う。
パッケージ
VRChat avatar
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みModular Avatar2026-06-25

Modular Avatar前提のアイテムをMA未導入で使うとアップロードに失敗する

症状: Modular Avatarを前提とするアバター用アイテムを導入した状態でアップロードに失敗する。記事ではConsoleにBlueprintID関連のエラーも表示された。

まず試すこと

配布物の説明書を確認し、前提となるModular Avatarを導入してから再度アップロードする。

パッケージ管理アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Modular Avatarを使用するアイテムを、Modular Avatar未導入のプロジェクトへ配置してアップロードする。
原因
記事の事例では前提パッケージのModular Avatarが入っていなかった。
解決策・回避策
  • 解決策: 配布物の説明書を確認し、前提となるModular Avatarを導入してから再度アップロードする。
パッケージ
Modular Avatar missing
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありModular Avatar2026-06-25

Modular Avatarの不安定版へ上げた後にアップロード失敗が続く

症状: Modular Avatarを当時の不安定版へ更新した後、アバターのアップロードに失敗する状態が続いた。

まず試すこと

記事ではModular Avatarを安定版へ戻すことでアップロード可能な状態へ復旧した。

アップロード / 公開アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
記事の事例では安定版ではなくalpha/beta系のModular Avatarへ更新していた。
解決策・回避策
  • 回避策: 記事ではModular Avatarを安定版へ戻すことでアップロード可能な状態へ復旧した。
パッケージ
Modular Avatar alpha/beta in field report
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, remedies
調査中VRChat Creator Companion2026-06-24

VCCを起動しても白い画面のままになる

症状: Creator CompanionのプロジェクトUIが表示されず、真っ白な画面のままになる。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

エディターUI起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
報告環境でCreator Companionを起動する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat Creator Companion 2.4.5
根拠
  • github.com — VRChat Creator Companion / GitHub Issue / vrchat-community/creator-companion / 根拠対象: title, date, environment, symptom, trigger
解決済みVRChat SDK2026-06-23

Unity Safe ModeでVRChat SDK scriptが読み込まれずAvatarDynamicsSetupが見つからない

症状: AvatarDynamicsSetupが見つからず、プロジェクトがUnity Safe Modeになっている。

まず試すこと

競合・不要なUdonSharp scriptを削除するなどcompile errorを解消し、VRChat SDK assemblyを読み込める状態へ戻す。報告者はclean projectで復旧している。

パッケージ管理コンパイル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
compile errorを発生させるassetをimportする。確認済みfollow-upではassetに含まれるUdonSharp scriptがcompile failureを起こしていた。
原因
報告者は新規projectでimportしたUdonSharp contentがcompile errorの原因だったと報告している。旧projectの完全な原因は未解決。
解決策・回避策
  • 解決策: 競合・不要なUdonSharp scriptを削除するなどcompile errorを解消し、VRChat SDK assemblyを読み込める状態へ戻す。報告者はclean projectで復旧している。
  • 回避策: projectを作り直しassetを選択的に再importして競合packageを特定する。
パッケージ
UdonSharp, VRChat SDK - Avatars
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありModular Avatar2026-06-23

Modular Avatar Shape Changerのpreviewが更新されなくなりUnity再起動まで戻らないことがある

症状: Shape Changerのpreview、および報告上はBlendshape Sync／Object Toggle previewが変更を反映しなくなることがある。

まず試すこと

Unityを再起動する。

シミュレーション / プレビュープレビュー
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
reactive componentのpreviewを使用中に報告された壊れた状態へ入る。
解決策・回避策
  • 回避策: Unityを再起動する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Issue / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みModular Avatar2026-06-21

MAがlayerを前方挿入するとMMD worldで元の先頭FX layerが無効化される場合がある

症状: Reactive Componentやmerged layerによって元の先頭FX layerがindex 0からずれると、MMD world内でそのlayerが無効化される場合がある。

まず試すこと

元の先頭FX layerを追跡し、明示opt-inがない限り暗黙のMMD無効化対象から外す修正を含むModular Avatarを使用する。

プロジェクト設定実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
avatar本来の先頭FX layerより前にModular Avatarのlayerを挿入し、そのavatarをMMD worldで使用する。
原因
MMD relayが移動後の元先頭layerをMMD modeで無効化可能なlayerとして扱っていたが、未加工avatarの先頭FX layerは実質weight 1固定でMMD world側から無効化できず、元挙動と乖離していた。
解決策・回避策
  • 解決策: 元の先頭FX layerを追跡し、明示opt-inがない限り暗黙のMMD無効化対象から外す修正を含むModular Avatarを使用する。
パッケージ
Modular Avatar
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-19

日本語のPC名でVRChat SDKのBuild & PublishがIllegal byte sequenceで失敗する

症状: Build & Publishを押してもアップロードが完了せず、アバター名やサムネイル設定にも失敗することがある。

まず試すこと

PC名を英数字だけの名前へ変更してWindowsを再起動し、Unityを開き直してBuild & Publishを再実行する。記事の事例ではこれでアップロードに成功した。

アップロード / 公開アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Illegal byte sequence encounted in the input. Parameter name: string
発生条件
WindowsのPC名（デバイス名）が日本語の状態でVRChat SDKからアバターをアップロードする。
原因
記事の事例では、日本語のPC名が非ASCII文字を含むネットワーク情報として扱われ、ReserveAvatarId付近でIllegal byte sequenceエラーになったとしている。
解決策・回避策
  • 解決策: PC名を英数字だけの名前へ変更してWindowsを再起動し、Unityを開き直してBuild & Publishを再実行する。記事の事例ではこれでアップロードに成功した。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-19

WindowsのPC名が日本語だとBuild & Publishが「Illegal byte sequence」で失敗する事例

症状: 記事環境ではBuild & Publishが完了しない。

まず試すこと

PC／device名を英数字へ変更してWindowsを再起動し、Build & Publishを再試行する。

パッケージ管理アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Illegal byte sequence encounted in the input. Parameter name: string
発生条件
日本語のWindows PC／device名を使うと再現したと報告されている。
原因
報告者の環境では、pathや他のnameを確認しても解決せず、日本語device名の変更で解消した。
解決策・回避策
  • 解決策: PC／device名を英数字へ変更してWindowsを再起動し、Build & Publishを再試行する。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-17

Quest向けアバタービルドがAndroid Build Supportの再インストールで復旧する

症状: 同じプロジェクトはWindows向けにビルドできるがAndroid/Quest向けだけ失敗し、新規プロジェクトのVRChatサンプルアバターでもAndroidビルドが失敗する。

まず試すこと

Unity HubでUnity 2022.3.22f1用Android Build Supportを再インストールし、Androidビルドを再実行する。

パッケージ管理ビルドUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
エラー文字列
Error building Player because scripts had compiler errors
発生条件
報告された環境で、ローカルのUnity Android Build Supportが不調な状態のままAndroid向けビルドを行う。
原因
事例ではSDKサンプルアバターでもAndroidだけ失敗し、Android Build Supportの再インストールで解消したため、ローカルのAndroid Build Support導入状態まで原因を切り分けている。
解決策・回避策
  • 解決策: Unity HubでUnity 2022.3.22f1用Android Build Supportを再インストールし、Androidビルドを再実行する。
パッケージ
VRChat SDK - Avatars, Unity Android Build Support 2022.3.22f1
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-17

VRChat非対応のUnity versionでBuildできず複数エラーが出る

症状: Buildを実行できず、複数のエラーが表示される。

まず試すこと

記事ではVRChat対応版のUnity 2022.3.22f1を使用するよう案内している。

プロジェクト設定ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
VRChatが対応していないUnity versionを使用する。
原因
記事ではVRChatが使用可能なUnity versionを指定しており、それ以外では正常動作しない場合があるとしている。
解決策・回避策
  • 解決策: 記事ではVRChat対応版のUnity 2022.3.22f1を使用するよう案内している。
パッケージ
VRChat SDK
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-17

GameObjectがEditorOnlyのままだとVRChatでAvatar部品が消える

症状: Unity上では見えるAvatarやaccessoryがVRChatでは消える。

まず試すこと

Avatarビルドへ含める必要があるobjectからEditorOnly tagを外す。

ビルド / 検証ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
対象GameObjectをEditorOnly tagのままビルドする。
原因
記事ではEditorOnlyがbuilt Avatarからobjectを除外する原因の1つとして挙げられている。
解決策・回避策
  • 解決策: Avatarビルドへ含める必要があるobjectからEditorOnly tagを外す。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みlilToon2026-06-17

必要なshaderがない、または認識されないとAvatarがピンクになる

症状: Avatarやaccessory全体がピンク表示になる。

まず試すこと

必要なshader（該当する場合はlilToonなど）を導入し、materialが想定shaderを参照しているか確認する。

パッケージ管理インポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
必要shaderが未導入・削除済み、またはmaterialがUnityで解決できないshaderを参照する。
原因
記事では必要shaderの欠落または未認識を代表的原因としている。
解決策・回避策
  • 解決策: 必要なshader（該当する場合はlilToonなど）を導入し、materialが想定shaderを参照しているか確認する。
パッケージ
avatar shader
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-17

非対応Unity versionではVRChat Avatarビルドが失敗し複数errorが出ることがある

症状: VRChatが対応していないUnity versionを使うとビルドできず、複数のerrorが表示されることがある。

まず試すこと

記事で検証された2026年VRChat workflowではUnity 2022.3.22f1を使用する。

プロジェクト設定ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
記事のtroubleshooting事例でVRChat対応外のUnity versionを使用する。
原因
記事では非対応Unity versionの使用をこのfailure classの原因としている。
解決策・回避策
  • 解決策: 記事で検証された2026年VRChat workflowではUnity 2022.3.22f1を使用する。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-17

同一Sceneに複数Avatarがある場合のContact／PhysBone Allow Self・Others挙動を修正

症状: AvatarプロジェクトのPlay Modeで複数Avatarが同一Sceneにある場合、Contacts／PhysBonesのAllow SelfとAllow Othersが各Avatarを別playerとして扱うようになった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

PhysBones / Contacts実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

VRCTweenのWorlds SDK統合を修正

症状: VRCTweenとWorlds SDKの統合に問題があった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

シーン / ワールド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

特定member数のenumをUdonSharpが誤コンパイルする問題を修正

症状: 特定数のmemberを持つenumの使用をUdonSharpが誤ってコンパイルすることがあった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

Udon / スクリプトコンパイル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

SDKのcapsule表示をtip-to-tipからcenter-to-centerへ修正

症状: SDK内のcapsule表示がtip-to-tipで表現されていたが、正しいcenter-to-center表示へ修正された。

まず試すこと

VRChat SDK 3.10.4で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

Avatar指のGizmo previewをclient内の形状と一致させた

症状: SDKで表示するAvatar fingerのGizmo previewがclient内の実際の形状と一致しないことがあった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

エディターUIプレビュー
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

EditorOnly上のVRCRaycastをAvatar Performance Rankingが誤集計する問題を修正

症状: EditorOnly tagのGameObject上にあるVRCRaycastまでAvatar Performance Rankingへ含まれることがあった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

エディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

初回起動時にUDON defineがあると新規Worldのsample sceneを作れないregressionを修正

症状: 最初の起動時点でUDON scripting defineが設定されていると、新規Worldプロジェクトにsample sceneが作成されないことがあった。

まず試すこと

VRChat SDK 3.10.4で修正済み。

シーン / ワールド起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-17

VRCPickup追加時にGameObjectをPickup layerへ自動移動する挙動を復旧

症状: VRCPickup componentを追加してもGameObjectがPickup layerへ自動移動しない状態になっていた。

まず試すこと

VRChat SDK 3.10.4で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.4で修正済み。
パッケージ
VRChat SDK 3.10.4
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-06-16

古いSDKでpackageをimportしてから更新するとContact ReceiverのBox Sizeが失われる

症状: Box型VRC Contact Receiverを含むpackageを古いSDKへimportしてからSDKを更新すると、Size値が失われる。

まず試すこと

packageをimportする前にSDK 3.10.4以降へ更新する。古いSDKで既にimportした場合は更新後にpackageを再importする。

パッケージ管理インポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Box fieldを認識しないSDK versionへpackageをimportし、その後SDK 3.10.4以降へ更新する。
原因
VRChatスタッフは、導入中SDKが認識できないcomponent fieldはUnityによって保存データから落ちると説明している。Box ContactはSDK 3.10.4で利用可能になった。
解決策・回避策
  • 解決策: packageをimportする前にSDK 3.10.4以降へ更新する。古いSDKで既にimportした場合は更新後にpackageを再importする。
パッケージ
VRChat SDK - Avatars <3.10.4
根拠
  • feedback.vrchat.com — VRChat Feedback / フォーラム / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-06-11

Gesture Animatorの先頭layerに有効なmaskがないとSDK buildが中断される

症状: SDK buildがabortされ、Builderが先頭Gesture layerのmask欠落／無効を報告する。

まず試すこと

元Avatarの先頭Gesture layerへSDK sampleのvrc_HandsOnlyなど永続的で有効なmaskを設定し、temporary build copyのmaskを使わない。

アニメーション検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Gesture Layer needs valid mask on first animator layer
発生条件
先頭layerに有効なAvatar Maskがないcustom Gesture controller、またはbuild中に消えるtemporary maskを使用する。
原因
forumではmissing／temporaryなGesture layer Avatar Maskを具体的なvalidation問題としている。temporaryなVRCFury test copyを編集すると不安定さが残るとも指摘されている。
解決策・回避策
  • 解決策: 元Avatarの先頭Gesture layerへSDK sampleのvrc_HandsOnlyなど永続的で有効なmaskを設定し、temporary build copyのmaskを使わない。
パッケージ
VRChat SDK - Avatars
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
回避策ありvrc-get / ALCOM2026-06-06

後継パッケージ導入後にALCOMのUIから旧パッケージが消えるが実体は残ることがある

症状: Poiyomi ToonとProが共存してassembly重複を起こし、後継扱いされたToonがALCOMのアンインストールUIから消える。

まず試すこと

旧パッケージを手動削除し、必要なら後継パッケージを再導入してコンパイルを復旧する。

パッケージ管理導入
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Assembly with name 'Poi.Tools' already exists
発生条件
unlockedなcom.poiyomi.toonを導入後、Toonをlegacy packageとして宣言するcom.poiyomi.proを導入する。
原因
報告では、legacy package削除がunlocked packageをskipする一方、UIはファイルが残っていてもlegacy行を削除することが原因とされている。
解決策・回避策
  • 回避策: 旧パッケージを手動削除し、必要なら後継パッケージを再導入してコンパイルを復旧する。
パッケージ
ALCOM 1.1.6
根拠
  • github.com — vrc-get / ALCOM / GitHub Issue / vrc-get/vrc-get / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
回避策ありVRChat SDK2026-06-05

ローカルWorldテストで2個目以降のclientが黒画面で停止することがある

症状: local multi-client Worldテスト中、2個目以降のclientが黒画面で停止し、再join時に繰り返しcrashする場合もある。

まず試すこと

VRChatのdebug loggingをFullに設定する。関連reportのworkaroundとして、このtracked report内でも動作確認が報告されている。

シーン / ワールドテスト
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
同じWorldに対して複数のlocal Build & Test clientを起動する。
解決策・回避策
  • 回避策: VRChatのdebug loggingをFullに設定する。関連reportのworkaroundとして、このtracked report内でも動作確認が報告されている。
パッケージ
VRChat SDK - Worlds
根拠
  • feedback.vrchat.com — VRChat Feedback / フォーラム / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みVRChat SDK2026-05-30

Hierarchy変更後にAvatar buildでBody meshまたはArmature不足が報告される

症状: 必要なAvatar body／armature構造が欠落または無効になり、SDKのbuild／uploadに失敗する。

まず試すこと

有効なAvatar body／armature Hierarchyを復旧し、Avatar Descriptor／model参照を確認して再ビルドする。

アバターリグアップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Avatar is missing a Body mesh or Armature
発生条件
必要なBody／Armature参照を削除・無効化するHierarchy／model変更後にAvatarをビルドする。
原因
forumではmissing／invalidなAvatar Hierarchyが直接のvalidation failureとして示されている。どの編集が原因かは事例依存。
解決策・回避策
  • 解決策: 有効なAvatar body／armature Hierarchyを復旧し、Avatar Descriptor／model参照を確認して再ビルドする。
パッケージ
VRChat SDK - Avatars
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
調査中VRChat ClientSim2026-05-24

ClientSimと実ビルドでEditorOnlyオブジェクトの削除タイミングが異なる

症状: ClientSimではビルド処理中にEditorOnlyオブジェクトを参照できたり、実ビルドで削除されるオブジェクトが残ったりする。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

シーン / ワールドテスト
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
NullReferenceException
発生条件
EditorOnlyオブジェクトを含むビルド時Hierarchy変更を使用する。
原因
報告では、DestroyEditorOnlyの実行位置がSDKのScene処理と異なることが差異の原因とされている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat ClientSim
根拠
  • github.com — VRChat ClientSim / GitHub Issue / vrchat-community/ClientSim / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause
調査中vrc-get / ALCOM2026-05-24

Ubuntu 26.04でALCOM AppImageのGUIが白いままになる

症状: AppImageのウィンドウは作成されるが内容が永続的に白画面のままになる。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Could not create default EGL display: EGL_BAD_PARAMETER
発生条件
報告されたUbuntu 26.04環境でALCOM AppImageを起動する。
原因
報告ではlibgvfsdbus／libgvfscommonのsymbol失敗とEGL display作成失敗が観測されている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
ALCOM 1.1.5
根拠
  • github.com — vrc-get / ALCOM / GitHub Issue / vrc-get/vrc-get / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause
解決済みVRChat SDK2026-05-24

VRChat SDKのBuilderにアバターが表示されない

症状: VRChat SDKのBuilderにHierarchy上のアバターが表示されない。

まず試すこと

アバタールートのInspectorにVRC Avatar Descriptorがあるか確認し、配布物の説明書上必要なのに無い場合はAdd Componentから追加する。

エディターUIビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
記事ではVRC Avatar Descriptorが設定されていない場合を原因候補として挙げている。
解決策・回避策
  • 解決策: アバタールートのInspectorにVRC Avatar Descriptorがあるか確認し、配布物の説明書上必要なのに無い場合はAdd Componentから追加する。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みVRChat SDK2026-05-16

Particle Collision ForceがPickup／Item layerへ作用するとAvatarビルドが拒否される

症状: Particle Systemが保護対象のPickup／Item layerへcollision forceを加えられるためSDKがAvatarを拒否する。

まず試すこと

該当layerをParticle Collision対象から外すかcollider forceを0へ変更し、再ビルドする。

プロジェクト設定検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
This avatar contains one or more particle systems configured to apply collision forces to Pickups and/or Items. This is not allowed.
発生条件
保護layerをParticle Collision対象にし、collider forceを0以外へ設定する。
原因
SDK validation messageが禁止されたParticle Collision Force設定を直接示している。
解決策・回避策
  • 解決策: 該当layerをParticle Collision対象から外すかcollider forceを0へ変更し、再ビルドする。
パッケージ
VRChat SDK - Avatars
根拠
  • qiita.com — Qiita / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みNDMF2026-05-09

NDMFパッケージURL末尾の「?」によりVPM clientでHTTP 502になる

症状: 末尾に単独の「?」が付いたNDMFパッケージURLをALCOM／VPM clientがdownloadできない。

まず試すこと

パッケージURL末尾の「?」を削除する。

パッケージ管理
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
502 Bad Gateway
発生条件
VPM listingから不正なrelease URLを解決する。
原因
報告ではdownload URL末尾へ不要な「?」が追加されていることが原因とされている。
解決策・回避策
  • 解決策: パッケージURL末尾の「?」を削除する。
  • 回避策: 末尾の「?」を除いた修正済みURLを使用する。
パッケージ
NDMF 1.12.0
根拠
  • github.com — NDMF / GitHub Issue / bdunderscore/ndmf / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRC Gesture Manager2026-05-07

Gesture ManagerのPlay Mode中の再コンパイルでコンポーネント重複とPrefab上書きが起きることがある

症状: Gesture Manager経由のPlay Mode中にスクリプト再コンパイルが起きると、PhysBoneやContact Receiverが重複し、Prefabが強制的に書き換えられてRevertでも戻せなくなることがある。

まず試すこと

Issueで修正済みとされたGesture Managerのプレリリース版を使用する。

PhysBones / Contacts実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
Gesture ManagerからPlay Modeへ入り、C#スクリプトを変更・保存して再コンパイルを発生させた後、Play Modeを終了する。
解決策・回避策
  • 解決策: Issueで修正済みとされたGesture Managerのプレリリース版を使用する。
  • 回避策: この検証経路ではUnity標準Play ModeまたはAvatars 3.0 Emulatorを使用する。報告者はそれらでは再現していない。
パッケージ
VRC Gesture Manager
根拠
  • github.com — VRC Gesture Manager / GitHub Issue / BlackStartx/VRC-Gesture-Manager / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みVRChat SDK2026-05-05

VRChat World projectへModular Avatarをimportするとcompile errorになる場合がある

症状: VRChat World projectへModular Avatarをimportした後、projectがcompileできなくなる場合がある。

まず試すこと

harmony-patches asmdefのversionDefinesをcom.vrchat.avatars基準に直したModular Avatarを使用する。

パッケージ管理コンパイル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
VRChat base/world packageはあるがavatars packageはないWorld projectへModular Avatarをimportする。
原因
harmony-patches assemblyのMA_VRCSDK3_AVATARS version defineがcom.vrchat.baseを条件にしており、World projectでもavatar用symbolが有効化されていた。修正ではcom.vrchat.avatarsを条件に変更している。
解決策・回避策
  • 解決策: harmony-patches asmdefのversionDefinesをcom.vrchat.avatars基準に直したModular Avatarを使用する。
パッケージ
Modular Avatar, VRChat SDK - Worlds
根拠
  • github.com — Modular Avatar / GitHub Commit / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありAvatar Optimizer2026-05-04

Trace And OptimizeでU Shop武器ギミックの挙動が変わる

症状: Trace And Optimizeがあると、武器magazine追従やworld-fixedギミックの挙動が不正になる。

まず試すこと

Avatar Optimizerを外す。報告者は両方の症状が消えるとしている。

シーン / ワールド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
報告されたU Shop武器ギミックとTrace And Optimizeを併用する。
解決策・回避策
  • 回避策: Avatar Optimizerを外す。報告者は両方の症状が消えるとしている。
パッケージ
Avatar Optimizer
根拠
  • github.com — Avatar Optimizer / GitHub Issue / anatawa12/AvatarOptimizer / 根拠対象: title, date, environment, symptom, trigger, remedies
回避策ありVRChat SDK2026-04-28

VRChat SDKからログアウト中にClientSim設定を開くとAPIエラーが大量出力される

症状: ログアウト状態でClientSim設定を開くとUnity Consoleへエラーが連続出力される。

まず試すこと

設定を開く前にVRChat SDKへログインする。

エディターUIテスト
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Api Web Request send before online mode is initialized.
発生条件
VRChat SDKからログアウトした状態で設定ウィンドウを開く。
解決策・回避策
  • 回避策: 設定を開く前にVRChat SDKへログインする。
パッケージ
VRChat ClientSim
根拠
  • github.com — VRChat ClientSim / GitHub Issue / vrchat-community/ClientSim / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
回避策ありAvatar Optimizer2026-04-26

Avatar Optimizer 1.9.11が重複Hierarchyを対象にするVRCPhysBoneを削除する

症状: 意図的に重複Hierarchyを対象にしたVRCPhysBoneが1.9.11では削除され、1.9.10では保持される。

まず試すこと

regression修正まで1.9.10を使用する。

PhysBones / Contacts
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
報告された重複PhysBone HierarchyをAvatar Optimizer 1.9.11でビルドする。
解決策・回避策
  • 回避策: regression修正まで1.9.10を使用する。
パッケージ
Avatar Optimizer 1.9.11
根拠
  • github.com — Avatar Optimizer / GitHub Issue / anatawa12/AvatarOptimizer / 根拠対象: title, date, environment, symptom, trigger, remedies
解決済みVRChat SDK2026-04-25

Unity Standard shaderはQuest非対応のためAvatar uploadが拒否される

症状: materialが非対応shaderを使用しているためAndroid／Quest向けAvatar buildをuploadできない。

まず試すこと

非対応materialをVRChat Mobile対応shaderへ置換し、Android buildを再validationする。

シェーダー / マテリアル検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Standard shader is not supported on Quest
発生条件
materialにUnity Standard shaderが残ったQuest Avatar variantをビルドする。
原因
platform validationがQuest／Android非対応shaderを検出している。
解決策・回避策
  • 解決策: 非対応materialをVRChat Mobile対応shaderへ置換し、Android buildを再validationする。
パッケージ
VRChat SDK - Avatars
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みModular Avatar2026-04-25

Skinned MeshのBoundsが小さいと視点や姿勢によって髪や衣装が消える

症状: 相手を視野の端から見たり姿勢が変わった時に、髪や衣装の一部が消えたままになる。

まず試すこと

通常の動作範囲を覆うようBoundsを広げる。記事ではModular AvatarのMA Mesh Settingsも修正手段として挙げている。

レンダリング実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
変形後の髪や衣装がSkinned Mesh RendererのBounds外へ移動し、見る側の視野からBoundsが外れる。
原因
記事ではBoundsが実際の変形範囲を十分に覆っていないためカリングされることを原因としている。
解決策・回避策
  • 解決策: 通常の動作範囲を覆うようBoundsを広げる。記事ではModular AvatarのMA Mesh Settingsも修正手段として挙げている。
パッケージ
VRChat avatar
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みUnity2026-04-25

EditorOnlyタグの衣装はUnity上で見えてもVRChat build後に消える

症状: Unity Editor上では衣装が見えているが、buildしてVRChatへ入ると衣装が存在しない。

まず試すこと

対象GameObjectのタグをEditorOnlyから通常のタグへ戻し、Play ModeとVRChat上で確認する。

シミュレーション / プレビュービルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
衣装などのGameObjectにEditorOnlyタグを付けたままbuildする。
原因
記事では対象GameObjectがEditorOnlyタグのままになっていることを原因としている。
解決策・回避策
  • 解決策: 対象GameObjectのタグをEditorOnlyから通常のタグへ戻し、Play ModeとVRChat上で確認する。
パッケージ
VRChat avatar
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みother2026-04-25

SkinnedMeshRenderer Boundsが変形後meshを覆わないとposeや視点によって服・髪が消える

症状: Avatarがしゃがんだ時やcamera frustum端付近で、髪や服が突然消える。

まず試すこと

想定pose／視点で変形後meshがBounds内へ収まるようBoundsを調整し確認する。

レンダリング実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
変形したmeshが元pose付近に残るBounds boxの外へ移動する。
原因
記事ではrenderer Boundsが変形後meshを覆わずcullingされることを原因としている。
解決策・回避策
  • 解決策: 想定pose／視点で変形後meshがBounds内へ収まるようBoundsを調整し確認する。
パッケージ
Unity SkinnedMeshRenderer
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-04-25

服をEditorOnlyのままにするとUnityでは見えてもVRChatビルドから除外される

症状: Unityでは服が見えるが、ビルド後のVRChatでは消える。

まず試すこと

衣装がビルドへ含まれるtagへ変更し、Play Mode／private VRChatで確認する。

シミュレーション / プレビュービルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
衣装objectをEditorOnly tagのままにする。
原因
記事では衣装objectのEditorOnly tagをこのfailure modeの原因としている。
解決策・回避策
  • 解決策: 衣装がビルドへ含まれるtagへ変更し、Play Mode／private VRChatで確認する。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-04-25

PC版では服があるのにmobile版で消える場合はplatform別buildの差異が原因になり得る

症状: PC向けAvatarは正常に服を着ている一方、mobile userからは服が欠けて見える。

まず試すこと

target platform側のHierarchy／tag／parameterを個別確認し、公開前にmobile buildをtestする。

ビルド / 検証ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
mobile／platform別Avatar buildで衣装を省く、EditorOnlyを残すなどPC版との設定差がある。
原因
記事ではPC版ではなく別platform build側の設定ミスとしてこの症状を整理している。
解決策・回避策
  • 解決策: target platform側のHierarchy／tag／parameterを個別確認し、公開前にmobile buildをtestする。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありNDMF2026-04-16

TexTransTool TextureBlenderがNDMF Previewの反復更新でVRAMをリークする

症状: NDMF Preview中にTextureBlender設定を変更するとVRAM使用量が蓄積し、最終的にEditor再起動が必要になる。

まず試すこと

Unity Editorを再起動して蓄積したVRAMを解放する。予防的な回避策はIssue本文には記載されていない。

レンダリングプレビュー
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
NDMF PreviewでTextureBlenderを繰り返し更新し、プレビュー更新ごとに新しいRenderTextureを割り当てる。
原因
IssueではaddTexがdisposeされず、プールされたRenderTextureが使用中のままとなって再利用できないことが指摘されている。
解決策・回避策
  • 回避策: Unity Editorを再起動して蓄積したVRAMを解放する。予防的な回避策はIssue本文には記載されていない。
パッケージ
TexTransTool, NDMF
根拠
  • github.com — TexTransTool / GitHub Issue / ReinaS-64892/TexTransTool / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-04-16

VRCRaycastでray miss時にresult transformの向きが逆になる問題を修正

症状: snap on miss設定時、rayが何にも当たらないとresult transformが誤った方向を向くことがあった。

まず試すこと

VRChat SDK 3.10.3で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.3で修正済み。
パッケージ
VRChat SDK 3.10.3
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-04-16

Domain Reload無効のSDKプロジェクトでVRCRaycastが正しく動作しない問題を修正

症状: Domain Reloadを無効にしたSDKプロジェクトでVRCRaycastの挙動が正しくないことがあった。

まず試すこと

VRChat SDK 3.10.3で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.3で修正済み。
パッケージ
VRChat SDK 3.10.3
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-04-16

VRCRaycastのDisable On Missを削除

症状: Avatar Animator Parameterで代替できるようになったため、VRCRaycastのDisable On Miss設定は不要となり削除された。

まず試すこと

VRChat SDK 3.10.3で仕様を整理済み。

アニメーション
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.3で仕様を整理済み。
パッケージ
VRChat SDK 3.10.3
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-04-16

Mirror描画timingを2026.1.3 clientと一致させた

症状: Mirror描画をOnWillRenderObjectではなくCamera.onPreCullで行うよう変更し、VRChat 2026.1.3 clientの挙動と一致させた。

まず試すこと

VRChat SDK 3.10.3で修正済み。

レンダリング
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.3で修正済み。
パッケージ
VRChat SDK 3.10.3
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-04-16

ClientSim 3.10.2以降でString／Image URL loadingが動かない問題を修正

症状: ClientSimでString URLおよびImage URLのloading機能が3.10.2以降動作しなくなっていた。

まず試すこと

VRChat SDK 3.10.3で修正済み。

シミュレーション / プレビューテスト
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.3で修正済み。
パッケージ
VRChat SDK 3.10.3
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
調査中NDMF2026-04-14

パッケージ更新後にPlay Modeへ入るとNDMF ConsoleでNullReferenceExceptionが発生する

症状: プロジェクトのパッケージ更新後にPlay Modeへ入ると、NDMF内部pluginのNullReferenceExceptionが報告される。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

パッケージ管理ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
System.NullReferenceException: Object reference not set to an instance of an object
発生条件
報告されたプロジェクト状態でパッケージを更新しPlay Modeへ入る。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
NDMF
根拠
  • github.com — NDMF / GitHub Issue / bdunderscore/ndmf / 根拠対象: title, date, environment, symptom, error_signature, trigger
調査中Modular Avatar2026-04-04

Blenderと3ds MaxのFBX規約差でMerge ArmatureがHips回転へ追従しない

症状: 3ds Maxから書き出した衣装FBXをBlender由来アバターへMergeすると、衣装がアバターのHips回転へ追従しない。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

アバターリグインポートUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
exporter間でHipsのrest rotationが90度異なる報告構成のarmatureをMergeする。
原因
報告ではBlenderと3ds MaxのFBX bone rotation規約差が原因候補として示されている。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
Modular Avatar 1.16.2, NDMF 1.11.0
根拠
  • github.com — Modular Avatar / GitHub Issue / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, trigger, root_cause
解決済みModular Avatar2026-03-26

Modular Avatarで「アバター内に配置する必要があります」と表示される

症状: Modular Avatarコンポーネントに、アバター内へ配置する必要があるという警告が表示される。

まず試すこと

対象の小道具をHierarchy上でアバターの子になる位置へ移動し、警告が消えることを確認する。

ビルド / 検証検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
このコンポーネントを正しく動作させるにはアバター内に配置する必要があります
発生条件
記事の事例では小道具がアバターのHierarchy配下に入っていなかった。
原因
記事の事例では対象オブジェクトがアバター階層の外に配置されていた。
解決策・回避策
  • 解決策: 対象の小道具をHierarchy上でアバターの子になる位置へ移動し、警告が消えることを確認する。
パッケージ
Modular Avatar
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-03-18

Pipeline Managerが複数あるとVRChat Worldをアップロードできない

症状: VRChat Worldのbuild/uploadがSDKに拒否される。

まず試すこと

SDKのSelect all PipelineManagersで対象を選択し、重複しているPipeline Managerの片方を削除する。記事ではこれでアップロード可能になった。

シーン / ワールドアップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
You can only have a single...
発生条件
既存のPipeline Managerに加えて、読み込んだAsset内のサンプルPipeline ManagerもHierarchyに存在する。
原因
記事では同一SceneにPipeline Managerが2つ存在することを原因としている。
解決策・回避策
  • 解決策: SDKのSelect all PipelineManagersで対象を選択し、重複しているPipeline Managerの片方を削除する。記事ではこれでアップロード可能になった。
パッケージ
VRChat SDK - Worlds
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
同一・類似エラー
解決済みVRChat SDK2026-03-18

Pipeline Managerが複数あるとWorld uploadがブロックされる

症状: Scene内に複数のPipeline ManagerがあるためSDKがWorldのbuild／uploadを拒否する。

まず試すこと

SDKのselection actionで全Pipeline Managerを探し、意図しない重複を削除する。

シーン / ワールド検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
You can only have a single...
発生条件
既にPipeline ManagerがあるSceneへ、sample Pipeline Managerを含むWorld assetをimportする。
原因
記事ではScene内のPipeline Manager重複を原因としている。
解決策・回避策
  • 解決策: SDKのselection actionで全Pipeline Managerを探し、意図しない重複を削除する。
パッケージ
VRChat SDK - Worlds
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
同一・類似エラー
回避策ありVRChat SDK2026-03-11

Avatar Optimizerが既定値trueのAnimator Booleanの挙動を変えることがある

症状: Trace And Optimize後、既定値trueのAnimator Booleanがfalseとして扱われたように振る舞い、想定したギミック状態が変わる。

まず試すこと

Trace And Optimizeのデバッグ設定「Skip Entry Exit To Blend Tree」を有効にする。

アニメーションUnity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
既定値trueのBooleanに依存し、Entry Exit to Blend Tree変換の対象になるAnimatorレイヤーを最適化する。
原因
Entry Exit to Blend Tree最適化が、報告されたBoolean既定値trueの挙動を保持していない。
解決策・回避策
  • 回避策: Trace And Optimizeのデバッグ設定「Skip Entry Exit To Blend Tree」を有効にする。
パッケージ
Avatar Optimizer 1.9.7, VRChat SDK 3.10.2
根拠
  • github.com — Avatar Optimizer / GitHub Issue / anatawa12/AvatarOptimizer / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-03-08

Avatar upload validationで「Chest bone is not specified」と表示される

症状: HumanoidのChest mappingがないためSDKがAvatar uploadをblockまたはwarning表示する。

まず試すこと

modelのRig設定を開いてHumanoid AvatarをConfigureし、Chest boneを正しいskeleton transformへmapする。

アバターリグ検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Chest bone is not specified
発生条件
Rig／Avatar設定でChest boneがmapされていないHumanoid Avatarを使用する。
原因
forumではAvatar RigのHumanoid Chest mapping不足を原因としている。
解決策・回避策
  • 解決策: modelのRig設定を開いてHumanoid AvatarをConfigureし、Chest boneを正しいskeleton transformへmapする。
パッケージ
VRChat SDK - Avatars
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat Creator Companion2026-02-28

lilToonのincludeファイルを開けずプロジェクト全体がマゼンタになる

症状: lilToonのHLSL includeを開けないエラーが繰り返され、プロジェクト内の描画オブジェクトがマゼンタのエラー表示になる。

まず試すこと

記事ではVCCのManage ProjectからlilToonを削除して再追加し、マテリアルにlilToonを再指定して復旧している。

パッケージ管理コンパイル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Couldn't open include file 'lil_vert_encryption.hlsl'
発生条件
記事ではpackageインポート後にlilToon内のファイル参照が壊れた状態で発生した。
解決策・回避策
  • 解決策: 記事ではVCCのManage ProjectからlilToonを削除して再追加し、マテリアルにlilToonを再指定して復旧している。
パッケージ
lilToon
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
調査中Modular Avatar2026-02-26

Modular Avatarビルドで「Destination array was not long enough」が発生する

症状: ReactiveObjectPass.GenerateNaNimatedBonesでSystem.ArgumentExceptionが発生し、アバタービルドに失敗する。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

ビルド / 検証ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
System.ArgumentException: Destination array was not long enough. Check destIndex and length, and the array's lower bounds
発生条件
報告されたLapwing環境でトグルを作成し、MA Object Toggleで衣装を対象にした後、MA Shape Changerで選択したHairPonyシェイプを削除する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
Modular Avatar, NDMF
根拠
  • github.com — Modular Avatar / GitHub Issue / bdunderscore/modular-avatar / 根拠対象: title, date, environment, symptom, error_signature, trigger
解決済みother2026-02-12

FatalError後にVRChat Unityプロジェクトを何度開いても起動できない

症状: 通常の復旧を繰り返してもUnityプロジェクトが起動できない状態が続く。

まず試すこと

最終手段としてcleanなVRChatプロジェクトを作成し、旧Sceneが開けることを確認してSceneをコピーし、asset／toolを段階的に戻して壊れた依存関係を特定する。

パッケージ管理起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
FatalError
発生条件
一般的な復旧を試しても解消しないプロジェクト固有のfatal startup状態。
解決策・回避策
  • 解決策: 最終手段としてcleanなVRChatプロジェクトを作成し、旧Sceneが開けることを確認してSceneをコピーし、asset／toolを段階的に戻して壊れた依存関係を特定する。
  • 回避策: 正常なScene／assetを保持しながらclean projectから段階的に再構築する。
パッケージ
VRChat project
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
回避策ありVRChat SDK2026-02-11

監視対象PhysBoneを削除するとVRC Constraintに参照が残りMissingReferenceExceptionが出る

症状: missing PhysBone参照が残ったVRCConstraintBaseから、objectの有効化、prefab override、undo/redoなどのEditor操作でMissingReferenceExceptionが繰り返し発生する。

まず試すこと

ConstraintをDebug表示してMonitored Phys Bonesのmissing参照を確認する。報告されたworkflowでは対象Constraintを作り直すことで古い参照を除去できる。

パッケージ管理エディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
MissingReferenceException: The object of type 'VRCPhysBone' has been destroyed but you are still trying to access it.
発生条件
VRC Constraintが監視していたPhysBoneを後から削除し、Monitored PhysBones dataにmissing参照が残る。
解決策・回避策
  • 回避策: ConstraintをDebug表示してMonitored Phys Bonesのmissing参照を確認する。報告されたworkflowでは対象Constraintを作り直すことで古い参照を除去できる。
パッケージ
VRChat SDK - Avatars 3.10.2-beta.1
根拠
  • feedback.vrchat.com — VRChat Feedback / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
解決済みVRChat SDK2026-02-05

新規World付属のUdonSharp utility scriptを削除しても勝手に再生成されないようになった

症状: 以前は新規Worldプロジェクト付属のUdonSharp utility scriptを削除すると再作成されることがあったが、隣接するdata locatorを残していれば再生成されなくなった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

シーン / ワールド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

Vector3Intなど構造体をkeyにしたDataDictionaryで値取得が失敗することがある問題を修正

症状: Vector3Intのようなデータ構造をkeyにしたDataDictionaryで、値の取得が失敗することがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

Prefab Override表示時にVRChat ConstraintsがInspectorへ正しく出ないことがある問題を修正

症状: Prefab Overrideとして表示したVRChat ConstraintsがInspectorへ正しく表示されないことがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

エディターUIエディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

VRCJson.TryDeserializeFromJson()が不正入力で例外を投げずfalseを返すようになった

症状: deserializeできない入力に対してVRCJson.TryDeserializeFromJson()が例外を投げる可能性があったが、常にfalseを返すようになった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

PhysBone Collider上で静止するboneが震えるregressionを修正

症状: PhysBone Collider上で静止しているboneが細かくjitterするregressionがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

PhysBones / Contacts
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

platform別overrideがあると別platform向けvalidation messageが出る問題を修正

症状: Avatar／Worldプロジェクトでplatform固有overrideを持つassetがあると、誤ったplatform向けのvalidation messageが生成されることがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

シーン / ワールド検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

VRCPickupの「Use Text」がInspectorへ安定して表示されない問題を修正

症状: VRCPickupの「Use Text」Inspector fieldが表示されたり消えたりすることがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

エディターUIエディター
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

WorldのLibrary削除でdefault sceneやUdonSharp utility scriptの変更が巻き戻る問題を修正

症状: WorldプロジェクトのLibrary folderを削除すると、default world sceneやUdonSharp utility scriptへの変更がSDKによって元へ戻されることがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

シーン / ワールド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

Authentication画面でEnter／Returnキーからログインできるようになった

症状: usernameとpassword入力後にEnter／Returnキーを押してもログイン操作にならなかったが、キー入力でログインできるようになった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

VRCMirrorReflectionが元materialを直接変更しないようになった

症状: VRCMirrorReflectionが元materialを直接変更していたため、Unity primitiveへ追加した際にUnity内蔵default materialまで変更することがあった。現在は編集不可のmaterial instanceを生成する。

まず試すこと

VRChat SDK 3.10.2で修正済み。

シェーダー / マテリアル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

community package使用後にmaterialのVRCFallback tagが誤設定される問題を修正

症状: 一部community package使用後にVRCFallback tagが誤って設定され、VRChat内でmaterialが正しく表示されないことがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

パッケージ管理
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

Contact Sender／Receiver proxyに対するUtilities.IsValid()判定を修正

症状: VRChat Contact Sender／Receiverのproxy objectをUtilities.IsValid()へ渡した際、proxyが実際に有効かどうかと一致しない結果になることがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

PhysBones / Contacts
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

Constraintの親になっているPhysBone破棄時の内部例外を修正

症状: 1つ以上のVRChat Constraintの親であるPhysBoneを破棄すると内部例外が発生することがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

PhysBones / Contacts
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
解決済みVRChat SDK2026-02-05

VRCJSON Minify出力に不要なspaceが入る問題を修正

症状: VRCJSONでData List／Data DictionaryをMinify形式へserializeしても不要なspaceが含まれることがあった。

まず試すこと

VRChat SDK 3.10.2で修正済み。

インポート / エクスポートインポート
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
解決策・回避策
  • 解決策: VRChat SDK 3.10.2で修正済み。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, remedies
回避策ありVRChat SDK2026-02-05

VRChat SDKビルドが「All pipe instances are busy」で失敗することがある

症状: まれにVRChat SDKのビルドが「All pipe instances are busy」エラーで失敗する。

まず試すこと

Unity Editorを再起動してビルドを再試行する。

ネットワーク / 通信ビルド
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
All pipe instances are busy
発生条件
まれなビルド時条件で発生する。リリースノートには確定的な再現条件は記載されていない。
原因
Unity側の問題。VRChatのリリースノートでは根本原因は特定されていない。
解決策・回避策
  • 回避策: Unity Editorを再起動してビルドを再試行する。
パッケージ
VRChat SDK 3.10.2
根拠
  • creators.vrchat.com — VRChat / 公式リリース / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
調査中VRChat Creator Companion2026-01-31

VCCから開いたUnityプロジェクトがアセット内容に関係なくクラッシュする

症状: 新規・既存を問わず、Creator Companion経由で開いたUnityプロジェクトがクラッシュする。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
報告されたVCC環境で空のプロジェクトまたは既存プロジェクトを開く。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat Creator Companion 2.4.5
根拠
  • github.com — VRChat Creator Companion / GitHub Issue / vrchat-community/creator-companion / 根拠対象: title, date, environment, symptom, trigger
解決済みVRChat SDK2026-01-27

PhysBoneのボーン構造が不足していると揺れても掴めない

症状: PhysBoneは揺れるがVRChat上で掴んで伸ばすことができない。

まず試すこと

Blenderなどで対象ボーンの子ボーンを追加し、追加ボーンへウェイトを設定してFBXをUnityへ戻す。記事では再アップロード後に掴んで伸ばせることを確認している。

PhysBones / Contacts実行時Unity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
掴ませたいPhysBoneのボーンチェーンに、掴んで伸びる先として使える追加ボーンがない。
原因
記事の事例では掴む動作に必要なボーン構造が不足していた。
解決策・回避策
  • 解決策: Blenderなどで対象ボーンの子ボーンを追加し、追加ボーンへウェイトを設定してFBXをUnityへ戻す。記事では再アップロード後に掴んで伸ばせることを確認している。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みVRChat SDK2026-01-27

末端ボーンもEndpoint PositionもないPhysBoneがVRChatで揺れない

症状: VRC PhysBoneを設定してアップロードしても対象ボーンが全く揺れず、VRChatのPhysBones overlayでも期待した反映を確認できない。

まず試すこと

VRC PhysBoneのEndpoint Positionを設定するか、モデル側に末端ボーンを追加してFBXを再出力する。記事ではどちらの方法でもVRChat上でPhysBoneの反映を確認している。

PhysBones / Contacts実行時Unity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
発生条件
単一の末端側ボーンへPhysBoneを設定したが、その先に末端ボーンがなくEndpoint Positionも設定されていない。
原因
記事の事例ではPhysBoneが動作するための末端位置を定義するボーンまたはEndpoint Positionが不足していた。
解決策・回避策
  • 解決策: VRC PhysBoneのEndpoint Positionを設定するか、モデル側に末端ボーンを追加してFBXを再出力する。記事ではどちらの方法でもVRChat上でPhysBoneの反映を確認している。
パッケージ
VRChat SDK - Avatars
根拠
  • note.com — note / 記事 / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
回避策ありVRChat Creator Companion2026-01-23

トルコ語localeでUdon GraphのInteractイベントbindingが壊れる

症状: 他イベントは動作するのにInteractが発火せず、Interaction Textも表示されない。

まず試すこと

同じ処理をUdonSharpで実装するか、トルコ語以外のlocaleを使用する。

Udon / スクリプト実行時
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
tr-TRのトルコ語locale環境でUdon Graph Event Interactを使用する。
原因
報告では、culture依存の小文字化によりイベントsymbolへdotless ıが入ることが原因とされている。
解決策・回避策
  • 回避策: 同じ処理をUdonSharpで実装するか、トルコ語以外のlocaleを使用する。
パッケージ
VRChat Creator Companion 2.4.5
根拠
  • github.com — VRChat Creator Companion / GitHub Issue / vrchat-community/creator-companion / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
解決済みUnity2026-01-21

FindMissingScripts.csのCS0246はEditor folderへ移動すると解消した事例

症状: custom FindMissingScripts editor utilityでCS0246コンパイルerrorが繰り返し発生する。

まず試すこと

FindMissingScripts.csをEditor folderへ移動し、editor専用codeとしてcompileさせる。

パッケージ管理コンパイル
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
CS0246
発生条件
editor専用utilityをEditor assembly／folder外へ置き、Editor APIが誤ったcontextでcompileされる。
原因
forumではeditor utilityの配置場所が誤っていたことを原因として解決している。
解決策・回避策
  • 解決策: FindMissingScripts.csをEditor folderへ移動し、editor専用codeとしてcompileさせる。
パッケージ
FindMissingScripts.cs
根拠
  • ask.vrchat.com — VRChat Ask Forum / フォーラム / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みUnity2026-01-19

Unityの「License error」でプロジェクトを開けない

症状: Unityのライセンスエラーによりプロジェクトを開けない。

まず試すこと

Unity HubのLicense設定からPersonalライセンスを再取得し、Unity_lic.ulfが生成されたことを確認する。記事では生成されない場合にUnity Editorをアンインストールしてから再取得・再インストールした事例も記録している。

起動
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
License error
発生条件
記事の事例ではUnity_lic.ulfライセンスファイルが存在しない状態。
原因
記事ではUnity_lic.ulfが存在しないことを原因としている。
解決策・回避策
  • 解決策: Unity HubのLicense設定からPersonalライセンスを再取得し、Unity_lic.ulfが生成されたことを確認する。記事では生成されない場合にUnity Editorをアンインストールしてから再取得・再インストールした事例も記録している。
パッケージ
Unity Hub
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
回避策ありVRChat SDK2026-01-19

VRChat SDKで「Missing Credentials」が出る

症状: VRChat SDKで認証情報不足を示すエラーが表示される。

まず試すこと

VRChat SDKのAuthenticationタブでLogoutし、VRChatアカウントへ再ログインする。記事では必要に応じてプロジェクトのキャッシュ類を削除する手順も記録している。

セットアップ
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Missing Credentials
発生条件
記事では、Authenticationタブ上ではログイン済みに見える状態で発生している。
解決策・回避策
  • 回避策: VRChat SDKのAuthenticationタブでLogoutし、VRChatアカウントへ再ログインする。記事では必要に応じてプロジェクトのキャッシュ類を削除する手順も記録している。
パッケージ
VRChat SDK
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, remedies
解決済みVRChat SDK2026-01-19

Expression Parametersが上限を超えるとAvatar validationに失敗する

症状: 記事の事例ではAvatarがvalidationを通過できない。

まず試すこと

parameterを減らすか、不要なparameterを消費するModular Avatar itemを削除または無効化する。

アバターパラメーター検証
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Avatar validation failed
発生条件
記事例で利用可能なExpression Parametersの容量を超過する。
原因
記事ではExpression Parametersの使用量超過を原因としている。ただし同じ一般的なmessageには他原因もあり得ると明記している。
解決策・回避策
  • 解決策: parameterを減らすか、不要なparameterを消費するModular Avatar itemを削除または無効化する。
パッケージ
VRChat SDK - Avatars
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-01-15

失敗した未完了アバターの状態が残ると後続アップロードも完了しないことがある

症状: Avatar UploadingとSignature Uploadingの後でアップロードが完了せず、失敗したアバターがWeb上には存在してもVRChatではUnavailableになることがある。

まず試すこと

失敗して残った未完了アバターを削除し、アップロードをやり直す。

アップロード / 公開アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
発生条件
以前のアバターアップロードが未完了・不整合な状態で残ったまま再アップロードする。
原因
報告者の最終的な解決では、完了しなかったアバターに紐づく不整合が原因だったとされている。
解決策・回避策
  • 解決策: 失敗して残った未完了アバターを削除し、アップロードをやり直す。
パッケージ
VRChat SDK - Avatars 3.9.0 / 3.10.1
根拠
  • feedback.vrchat.com — VRChat Feedback / フォーラム / 根拠対象: title, date, environment, symptom, trigger, root_cause, remedies
調査中VRChat Creator Companion2026-01-05

VCCでcom.vrchat.avatars ~3.10.xを解決できずアバタープロジェクトを作成できない

症状: Unity 2022 Avatar Projectの作成直後に失敗し、VCCがVRChat Avatarsパッケージを解決できないと表示する。

調査中

確認済みの解決策はまだありません。分かっている発生条件と根拠を確認してください。

パッケージ管理依存関係解決
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
Could not resolve package com.vrchat.avatars ~3.10.x
発生条件
VCC 2.4.5で新しいUnity 2022 Avatar Projectを作成する。
解決策・回避策
確認済みの解決策・回避策はありません。
パッケージ
VRChat Creator Companion 2.4.5, com.vrchat.avatars ~3.10.x
根拠
  • github.com — VRChat Creator Companion / GitHub Issue / vrchat-community/creator-companion / 根拠対象: title, date, environment, symptom, error_signature, trigger
解決済みVRChat SDK2026-01-04

古いSDKで新規Avatarをuploadすると「id is not allowed to be used」で拒否される

症状: 新しく作成したAvatarをuploadできない。

まず試すこと

VCCでVRChat SDK - BaseとVRChat SDK - Avatarsを3.9.0以上へ更新する。

アップロード / 公開アップロード
原因・環境・根拠を詳しく見る
Unity
Unity version未確認
エラー文字列
id is not allowed to be used. Make sure you're using SDK 3.9.0 or newer.
発生条件
記事環境でVRChat SDK 3.9.0未満を使って新規Avatarをuploadする。
原因
記事では、新規Avatar uploadに必要なVRChat SDK versionを満たしていないことが原因とされている。
解決策・回避策
  • 解決策: VCCでVRChat SDK - BaseとVRChat SDK - Avatarsを3.9.0以上へ更新する。
パッケージ
VRChat SDK - Avatars <3.9.0
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
解決済みVRChat SDK2026-01-02

LayersとCollision Matrix設定が完了するまでWorldのBuild & Testができない

症状: Build & TestおよびオンラインWorld uploadがブロックされる。

まず試すこと

SDKのLayers／Collision Matrix設定actionを実行してから再ビルドする。

プロジェクト設定検証Unity 2022.3.22f1
原因・環境・根拠を詳しく見る
Unity
現行Unity確認済み / 2022.3.22f1
エラー文字列
You must address Layers and Collision Matrix issues before you can build.
発生条件
VRChat必須のLayers／Collision Matrix設定を適用していない新規Worldプロジェクトを使用する。
原因
SDK validationが必須Layers／Collision Matrix設定の不足を検出している。
解決策・回避策
  • 解決策: SDKのLayers／Collision Matrix設定actionを実行してから再ビルドする。
パッケージ
VRChat SDK - Worlds 3.10.1
根拠
  • zenn.dev — Zenn / 記事 / 根拠対象: title, date, environment, symptom, error_signature, trigger, root_cause, remedies