2026 Unity / VRChat Failure KB

This page indexes canonical failure records backed by source URLs. Unknown causes or fixes remain unknown rather than being inferred.

132known cases

12current Unity verified

97resolved

20workaround available

15under investigation

Find by what is happening

You do not need to know the cause. Start from the symptom you can see.

Search an error or symptomExact error messages are fine. Package names and symptoms also work.

Filter by environment or technical details

SoftwareAllAvatar OptimizerlilToonModular AvatarNDMFotherPoiyomi Toon ShaderUnityVRC Gesture Managervrc-get / ALCOMVRCFuryVRChat ClientSimVRChat Creator CompanionVRChat SDKComponentAllanimationavatar parametersavatar rigbuild / validationeditor UIfilesystem / processimport / exportnetworking / transportpackage managementPhysBones / Contactsproject setuprenderingscene / worldshader / materialsimulation / previewUdon / scriptingupload / publishingPhaseAllbuildcompileeditorimportinstalllaunchpreviewresolveruntimesetuptestuploadvalidationFailure typeAllcompile errorcrashdata / state corruptiondependency errorexceptionhang / timeoutincorrect behaviormissing asset / referencenetwork / transport errorrendering defectUI defectunsupported configurationvalidation errorHost OSAllLinuxmacOSWindowsTarget platformAllUnityAll2022.3.22f1VRCSDKAll<3.7.1<3.9.0<3.10.43.9.0 / 3.10.13.10.13.10.23.10.2-beta.13.10.33.10.43.10.xPackageAllALCOMAvatar Optimizeravatar shadercom.vrchat.avatarsFindMissingScripts.csGoGoLocolilToonModular AvatarNDMFPoiyomi Toon ShaderTexTransToolUdonSharpUnity Android Build SupportUnity AnimatorUnity HubUnity SkinnedMeshRendererUniVRM / MToon10VRC Gesture ManagerVRCFuryVRChat avatarVRChat ClientSimVRChat Creator CompanionVRChat projectVRChat SDKVRChat SDK - AvatarsVRChat SDK - WorldsVRM Converter for VRChatXWear PackagerSource domainAllask.vrchat.comblog.yu-suz.comcreators.vrchat.comfeedback.vrchat.comgithub.comnote.comqiita.comzenn.devSource typeAllarticleforumgithub_commitgithub_issueofficial_releaseGitHub repositoryAllanatawa12/AvatarOptimizerbdunderscore/modular-avatarbdunderscore/ndmfBlackStartx/VRC-Gesture-Managerlilxyzw/lilToonpoiyomi/PoiyomiToonShaderReinaS-64892/TexTransToolvrc-get/vrc-getVRCFury/VRCFuryvrchat-community/ClientSimvrchat-community/creator-companion

132 matching cases

under investigationModular Avatar2026-08-16

Trace and Optimize can delete a MeshRenderer controlled by MA Object Toggle

Symptom: A MeshRenderer object managed by MA Object Toggle can be removed during optimization under a particular hierarchy.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

rendering

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Run Trace And Optimize on the affected MA Object Toggle hierarchy.

Fix / workaround

No verified fix or workaround recorded.

Packages

Avatar Optimizer, Modular Avatar

Evidence

• github.com — Avatar Optimizer / github_issue / anatawa12/AvatarOptimizer / supports: title, date, environment, symptom, trigger

resolvedVRChat SDK2026-08-10

VRCFury patches Gesture Manager playerId assignment that breaks newer global colliders

Symptom: Global collider playerId behavior can be incorrect under Gesture Manager when its legacy playerId assignment path is active.

Try this first

Use a VRCFury build containing the fix that suppresses Gesture Manager's playerId writes and lets the SDK manage those assignments.

simulation / previewpreview

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use Gesture Manager with newer VRCSDK avatar-dynamics components such as global colliders.

Cause

The VRCFury maintainer comment states that Gesture Manager writes its own playerId because older VRCSDK versions did not, but does not assign playerId on some newer components such as global colliders, breaking the mixed assignment path.

Fix / workaround

• fix: Use a VRCFury build containing the fix that suppresses Gesture Manager's playerId writes and lets the SDK manage those assignments.

Packages

VRCFury, VRC Gesture Manager, VRChat SDK - Avatars

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundVRC Gesture Manager2026-08-05

Gesture Manager reports VRCRaycast Hit false while the component reports true

Symptom: The raycast component Hit bool is true but Gesture Manager debug parameters report false; the same setup works in VRChat.

Try this first

Validate the behavior in VRChat rather than relying on Gesture Manager for this parameter.

editor

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use the newer VRCRaycast component with Gesture Manager emulation.

Fix / workaround

• workaround: Validate the behavior in VRChat rather than relying on Gesture Manager for this parameter.

Packages

VRC Gesture Manager

Evidence

• github.com — VRC Gesture Manager / github_issue / BlackStartx/VRC-Gesture-Manager / supports: title, date, environment, symptom, trigger, remedies

resolvedModular Avatar2026-08-03

Reaction Debugger can throw NullReferenceException when opened before override state initialization

Symptom: Opening Reaction Debugger can crash its refresh path with NullReferenceException.

Try this first

Use a Modular Avatar build containing the fix that initializes empty override dictionaries during RefreshUI and tolerates a null ForcePropertyOverrides dictionary.

package managementeditor

Cause, environment, and evidence

Unity

Unity version unverified

Error text

NullReferenceException

When it happens

Open Reaction Debugger before the delayed OnEnable initialization has populated property and menu override state.

Cause

OpenDebugger refreshes the UI before delayed initialization, leaving ForcePropertyOverrides or the override dictionaries null when ResolveToggleInitialStates runs.

Fix / workaround

• fix: Use a Modular Avatar build containing the fix that initializes empty override dictionaries during RefreshUI and tolerates a null ForcePropertyOverrides dictionary.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-08-01

Avatar upload fails on SDK 3.10.4 when no avatar tags are set

Symptom: Avatar test builds succeed, but the actual upload fails while creating/updating the avatar metadata.

Try this first

Set at least one avatar tag before uploading. The linked VRChat Feedback report marks the bug as available in a future release.

upload / publishinguploadUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

Error text

tags must be an array: null, tags must be a string: 'null'

When it happens

Upload an avatar with VRChat SDK 3.10.4 without setting any avatar tag.

Cause

The forum identifies this as a known SDK 3.10.4 bug in the tags upload path.

Fix / workaround

• fix: Set at least one avatar tag before uploading. The linked VRChat Feedback report marks the bug as available in a future release.
• workaround: Set any avatar tag before upload.

Packages

VRChat SDK - Avatars 3.10.4

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRCFury2026-07-31

SPS material swaps fail on autorigged meshes when the rewritten renderer binding is not reused

Symptom: SPS material swaps do not work properly when the target mesh is autorigged.

Try this first

Use a VRCFury build containing the autorigged SPS material-binding fix.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Run SPS baking on a renderer that is converted from MeshRenderer to SkinnedMeshRenderer by autorigging.

Cause

The fix shows that after autorig conversion the later blendshape and material-slot rewriting must use the final SkinnedMeshRenderer binding instead of continuing with the original MeshRenderer binding.

Fix / workaround

• fix: Use a VRCFury build containing the autorigged SPS material-binding fix.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-31

Synced layers can keep motions that are not overridden

Symptom: A synced Animator layer can retain a motion even when that state has no override motion.

Try this first

Use a VRCFury build that always loads the synced-layer override result, including null, so non-overridden motions are removed.

project setupbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Load and rewrite a synced Animator layer containing a state whose override motion is null.

Cause

The loader only replaced the wrapped state's motion when GetOverrideMotion returned a non-null motion, so a null override left the previous motion in place.

Fix / workaround

• fix: Use a VRCFury build that always loads the synced-layer override result, including null, so non-overridden motions are removed.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundModular Avatar2026-07-28

Modular Avatar Vertex Filter By Mask loses the material-slot dropdown

Symptom: The custom inspector no longer exposes the material-slot dropdown.

Try this first

Switch the Inspector to Debug and edit the value manually.

package managementeditor

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Inspect MA Vertex Filter - By Mask in the reported package versions.

Fix / workaround

• workaround: Switch the Inspector to Debug and edit the value manually.

Packages

Modular Avatar 1.17.1, NDMF 1.14.1

Evidence

• github.com — Modular Avatar / github_issue / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, remedies

resolvedVRCFury2026-07-28

Animation target lookup breaks when a hierarchy object name ends with a slash

Symptom: VRCFury animation target lookup is broken for a hierarchy containing an object whose name ends in a slash.

Try this first

Use a VRCFury build containing the corrected relative animation-path resolver.

package managementbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use an animation binding that resolves through a hierarchy object whose name ends with '/'.

Cause

The relative-path resolver mishandled this hierarchy path edge case; the fix separates base-path handling from relative-path traversal and rewrites the normalization logic.

Fix / workaround

• fix: Use a VRCFury build containing the corrected relative animation-path resolver.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-28

SPS shader patching can trigger a lilToon error on LightMode = Never passes

Symptom: VRCFury SPS shader patching produces a lilToon error in the affected shader path.

Try this first

Use a VRCFury build containing the lilToon SPS shader-patching fix.

shader / materialbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Patch a lilToon shader containing a pass tagged LightMode = Never.

Cause

The maintainer commit fixes the lilToon error by skipping SPS patching for LightMode = Never passes and adding a missing UnityShaderVariables include.

Fix / workaround

• fix: Use a VRCFury build containing the lilToon SPS shader-patching fix.

Packages

VRCFury, lilToon

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

under investigationVRChat ClientSim2026-07-27

ClientSim cannot interact through a station collider although VRChat can

Symptom: An interactable behind a station collider is ignored in ClientSim while the current VRChat client permits the interaction.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

simulation / previewtest

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Place a station collider between the ray caster and an interactable object.

Cause

The report points to an intentional historical collider-ignore check that no longer matches current client behavior.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat ClientSim

Evidence

• github.com — VRChat ClientSim / github_issue / vrchat-community/ClientSim / supports: title, date, environment, symptom, trigger, root_cause

resolvedVRCFury2026-07-27

Platform switching becomes extremely slow in projects with many shaders

Symptom: Switching build platform is very slow in Unity projects containing a large number of shaders.

Try this first

Use a VRCFury build that clears the small shader-property cache once when imports occur and refills it lazily instead of loading every shader.

project setupbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Switch platform so Unity reimports many shader assets while VRCFury's shader-property cache invalidation is active.

Cause

The asset postprocessor loaded every imported shader individually just to remove its cache entry; platform changes reimport every shader, making that invalidation path extremely expensive.

Fix / workaround

• fix: Use a VRCFury build that clears the small shader-property cache once when imports occur and refills it lazily instead of loading every shader.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedModular Avatar2026-07-26

Blendshape Sync curves can be set incorrectly when migrating from older Modular Avatar versions

Symptom: Blendshape Sync remap curves can become incorrect after migrating a component created by an older Modular Avatar version.

Try this first

Use a Modular Avatar build containing the RemapCurveIsValid migration fix, which initializes legacy bindings to a linear 0-to-100 curve before use.

animationimport

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Open or migrate Blendshape Sync data created before the remap-curve validity field existed.

Cause

Legacy bindings had no explicit validity marker, so migration could treat an uninitialized serialized curve as a valid remap curve instead of initializing the identity 0-to-100 mapping.

Fix / workaround

• fix: Use a Modular Avatar build containing the RemapCurveIsValid migration fix, which initializes legacy bindings to a linear 0-to-100 curve before use.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-26

VRCFury-generated avatar rigs on generic Animators can be omitted from saved assets

Symptom: A VRCFury-generated avatar rig used by a generic Animator can fail to be saved into generated assets.

Try this first

Use a VRCFury build that saves unsaved component assets from Animator components as well as Renderers and AudioSources.

avatar rigbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Build an avatar where VRCFury generates or modifies Avatar rig assets referenced by generic Animator components.

Cause

The save pass traversed Renderers and AudioSources but did not traverse Animator components, so generated Avatar assets reachable only through generic Animators could be omitted.

Fix / workaround

• fix: Use a VRCFury build that saves unsaved component assets from Animator components as well as Renderers and AudioSources.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-07-26

VRCAnimatorPlayAudio clips can be lost when VRCFury clones them to enable Load In Background

Symptom: Audio clips referenced by VRCAnimatorPlayAudio can be lost after VRCFury clones them to enable Load In Background.

Try this first

Use a VRCFury build containing the VRCAnimatorPlayAudio clip-retention fix.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Build an avatar whose VRCAnimatorPlayAudio clips must be cloned by VRCFury to enable Load In Background.

Cause

The save path did not retain all AudioClip assets referenced by VRCAnimatorPlayAudio; the fix enumerates those clips, including sub-controller usage, and adds them to the save context.

Fix / workaround

• fix: Use a VRCFury build containing the VRCAnimatorPlayAudio clip-retention fix.

Packages

VRCFury, VRChat SDK - Avatars

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-26

Sub-animator controllers can receive VRChat base-layer mask distribution incorrectly

Symptom: Layer masks in sub-animator controllers can be distributed as though the controller were a VRChat Base animator layer.

Try this first

Use a VRCFury build that reloads sub-animator controllers as plain VFController instances without assigning the VRChat Base layer type.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

VRCFury reloads a saved sub-animator controller during build.

Cause

The sub-animator reload path used VFControllerWithVrcType.Load with VRCAvatarDescriptor.AnimLayerType.Base, applying VRChat layer-type behavior to a generic sub-controller.

Fix / workaround

• fix: Use a VRCFury build that reloads sub-animator controllers as plain VFController instances without assigning the VRChat Base layer type.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-07-26

Sub-animators containing only valid Animator Play Audio actions can be purged

Symptom: A sub-animator can be removed even though it contains a valid Animator Play Audio action.

Try this first

Use a VRCFury build whose cleanup also checks Animator Play Audio targets before removing a sub-animator.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use a sub-animator with no valid animation clip bindings but with VRCAnimatorPlayAudio targeting an object under that sub-animator.

Cause

The empty-animator cleanup logic considered only valid clip bindings and treated the controller as empty, ignoring valid Animator Play Audio behaviours.

Fix / workaround

• fix: Use a VRCFury build whose cleanup also checks Animator Play Audio targets before removing a sub-animator.

Packages

VRCFury, VRChat SDK - Avatars

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

under investigationlilToon2026-07-24

lilOptimizer can take minutes when the same BlendTree is reachable by many paths

Symptom: Complex BlendTree graphs can cause the optimizer to process the same clips tens of thousands of times and take minutes.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

animation

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use a graph where the same BlendTree/AnimationClip is reachable through many paths.

Cause

The report identifies missing deduplication in VRChatModule.GetAnimationClipsFromGameObject.

Fix / workaround

No verified fix or workaround recorded.

Packages

lilToon

Evidence

• github.com — lilToon / github_issue / lilxyzw/lilToon / supports: title, date, environment, symptom, trigger, root_cause

resolvedVRCFury2026-07-24

Armature lookup fails after Modular Avatar Object Replacement replaces a humanoid bone

Symptom: VRCFury can fail to resolve humanoid armature bones after Modular Avatar Object Replacement replaces a bone object during the build.

Try this first

Use a VRCFury build that captures multiple object-path and armature snapshots and resolves across them after build-time hierarchy replacement.

package managementresolve

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use Modular Avatar Object Replacement to replace a humanoid bone before a later VRCFury feature performs armature or animation-path lookup.

Cause

Armature and object-path lookup relied on an earlier snapshot; after build-time object replacement, the cached bone object/path no longer represented the transformed hierarchy.

Fix / workaround

• fix: Use a VRCFury build that captures multiple object-path and armature snapshots and resolves across them after build-time hierarchy replacement.

Packages

VRCFury, Modular Avatar

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedModular Avatar2026-07-23

Modular Avatar Inspector fields disappear with no Console error until UserSettings is regenerated

Symptom: Modular Avatar components remain present but all normal Inspector settings disappear while the Console shows no red error.

Try this first

Close Unity, rename/backup the project UserSettings folder, reopen Unity so UserSettings is regenerated, and confirm the MA Inspector returns.

package managementeditorUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

The field report observed a project-specific editor-state failure after the same package versions had previously worked; the exact trigger was not established.

Fix / workaround

• fix: Close Unity, rename/backup the project UserSettings folder, reopen Unity so UserSettings is regenerated, and confirm the MA Inspector returns.
• workaround: Regenerate project UserSettings after backing it up; package reinstall and Library regeneration did not fix the author's case.

Packages

Modular Avatar 1.17.1, NDMF 1.14.1

Evidence

• blog.yu-suz.com — Yu Suzumi blog / article / supports: title, date, environment, symptom, trigger, remedies

under investigationvrc-get / ALCOM2026-07-23

ALCOM package install panics on symlinks pointing outside the package directory

Symptom: Installing a user package containing external symlinks errors and leaves ALCOM spinning until fully stopped.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

package managementinstall

Cause, environment, and evidence

Unity

Unity version unverified

Error text

thread 'tokio-rt-worker' panicked at 'unknown file type: none of file, dir, symlink'

When it happens

Register and install a user package whose README/LICENSE symlinks point outside the package directory.

Cause

The stack trace reaches copy_recursive and panics on the file type encountered through the symlink case.

Fix / workaround

No verified fix or workaround recorded.

Packages

ALCOM 1.1.8

Evidence

• github.com — vrc-get / ALCOM / github_issue / vrc-get/vrc-get / supports: title, date, environment, symptom, error_signature, trigger, root_cause

resolvedVRCFury2026-07-23

Generated material assets are not saved when they exist only inside generated animation clips

Symptom: A VRCFury-generated material referenced only from a generated animation clip is not saved with the generated assets.

Try this first

Use a VRCFury build containing the generated-material asset-saving fix.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Generate a material that exists only as an object-reference keyframe value in a generated clip.

Cause

The clip save path did not register generated object-reference keyframe values as new assets; the fix scans object curves and saves VRCFury-created keyframe values.

Fix / workaround

• fix: Use a VRCFury build containing the generated-material asset-saving fix.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-23

SPS markers can lose their MeshFilter mesh during generated asset saving

Symptom: An SPS marker can lose the mesh referenced by its MeshFilter after generated assets are saved.

Try this first

Use a VRCFury build that also saves unsaved component assets referenced by MeshFilter components.

renderingbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Build an avatar with an SPS marker whose generated mesh is referenced through a MeshFilter.

Cause

The asset-saving traversal saved unsaved assets referenced by Renderer components but omitted MeshFilter components, so a marker mesh reachable through MeshFilter could be dropped.

Fix / workaround

• fix: Use a VRCFury build that also saves unsaved component assets referenced by MeshFilter components.

Packages

VRCFury

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRCFury2026-07-21

GoGoLoco cross-state-machine transitions can break after controller clone or save

Symptom: Cross-state-machine transitions used by GoGoLoco can be lost or resolve incorrectly after VRCFury clones or serializes the controller.

Try this first

Use a VRCFury build that first clones or saves the full state-machine graph and then performs a separate recursive transition pass using complete maps.

package managementresolve

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Process an AnimatorController with transitions between nested state machines, as used by GoGoLoco.

Cause

Transitions were linked while state machines were still being recursively cloned or saved, before the complete state and state-machine maps existed for cross-machine destinations.

Fix / workaround

• fix: Use a VRCFury build that first clones or saves the full state-machine graph and then performs a separate recursive transition pass using complete maps.

Packages

VRCFury, GoGoLoco

Evidence

• github.com — VRCFury / github_commit / VRCFury/VRCFury / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat Creator Companion2026-07-19

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

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

Try this first

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

package managementimport

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Missing (Mono Script)

When it happens

記事の事例ではModular Avatarを前提とするギミックを、Modular Avatarが入っていないプロジェクトへインポートした。

Cause

記事の事例では前提パッケージのModular Avatarがプロジェクトに入っていなかった。

Fix / workaround

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

Packages

Modular Avatar

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

workaroundVRChat SDK2026-07-19

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

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

Try this first

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

runtime

Cause, environment, and evidence

Unity

Unity version unverified

Error text

The following component types are found on the Avatar and will be removed by the client: VRCSpatialAudioSource, Audio Source

When it happens

Android / Quest向けアバターにAudio SourceまたはVRCSpatialAudioSourceを含める。

Cause

2026年のVRChat公式Performance Ranksでは、モバイルアバターのAudio Sourcesは無効化・除去される対象として記載されている。

Fix / workaround

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

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies
• creators.vrchat.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

under investigationlilToon2026-07-18

lilToon material optimization bakes UV tiling incorrectly

Symptom: Baking an optimized material with non-1 UV tiling produces a texture with the tiling baked incorrectly.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

project setupbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use UV Tiling such as X=1/Y=2 and bake layers/material optimization.

Fix / workaround

No verified fix or workaround recorded.

Packages

lilToon

Evidence

• github.com — lilToon / github_issue / lilxyzw/lilToon / supports: title, date, environment, symptom, trigger

workaroundVRChat SDK2026-07-17

lilToon build-time optimization removes an AudioLink vertex mask during NDMF bake

Symptom: After NDMF Apply on Play or Manual Bake, the AudioLink vertex mask texture is removed and vertices outside the intended mask also react.

Try this first

Disable NDMF Apply on Play, or use the reported top-level UV Mode “Mask” configuration that preserves the mask texture.

shader / materialbuildUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

Use AudioLink with the reported Rim/top-level UV mode and a dedicated vertex mask, then run NDMF bake.

Fix / workaround

• workaround: Disable NDMF Apply on Play, or use the reported top-level UV Mode “Mask” configuration that preserves the mask texture.

Packages

lilToon 2.3.4, VRChat SDK 3.10.4, NDMF 1.14.0, Modular Avatar 1.18.0-beta.0, Avatar Optimizer 1.9.16, TexTransTool 1.1.0-beta.9

Evidence

• github.com — lilToon / github_issue / lilxyzw/lilToon / supports: title, date, environment, symptom, trigger, remedies

under investigationModular Avatar2026-07-16

NDMF Manual Bake cannot immediately load an asset copied with CopyAsset

Symptom: During Manual Bake, CopyAsset returns true but an immediate LoadAssetAtPath of the copied asset returns null; the same plugin code succeeds during Play-mode automatic build.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

build / validationbuildUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

Error text

AssetDatabase.LoadAssetAtPath<T>() returns null immediately after AssetDatabase.CopyAsset() during Manual Bake

When it happens

Run an NDMF generating pass that creates an output folder, copies a new asset, and immediately loads the copy during Manual Bake.

Fix / workaround

No verified fix or workaround recorded.

Packages

NDMF 1.14.0, Modular Avatar 1.17.1

Evidence

• github.com — NDMF / github_issue / bdunderscore/ndmf / supports: title, date, environment, symptom, error_signature, trigger

workaroundvrc-get / ALCOM2026-07-14

ALCOM update restart can make Unity and child tools unable to traverse junctions

Symptom: After in-app update restart, Unity Package Manager and child uv processes cannot traverse user-created NTFS junctions.

Try this first

Fully exit the updater-restarted ALCOM process and launch ALCOM normally, then start Unity again.

package managementresolve

Cause, environment, and evidence

Unity

Unity version unverified

Error text

STATUS_UNTRUSTED_MOUNT_POINT / Win32 error 448

When it happens

Update ALCOM 1.1.7 to 1.1.8 through the in-app updater and launch Unity from the updater-restarted ALCOM process.

Fix / workaround

• workaround: Fully exit the updater-restarted ALCOM process and launch ALCOM normally, then start Unity again.

Packages

ALCOM 1.1.8

Evidence

• github.com — vrc-get / ALCOM / github_issue / vrc-get/vrc-get / supports: title, date, environment, symptom, error_signature, trigger, remedies

under investigationVRChat Creator Companion2026-07-12

VCC project creation loops after remote repository timeout

Symptom: Creating either an avatar or world project stalls after a remote VPM repository request times out.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

package managementsetup

Cause, environment, and evidence

Unity

Unity version unverified

Error text

The request was canceled due to the configured HttpClient.Timeout of 600 seconds elapsing.

When it happens

Create a project while a configured repository such as the VRCFury repo does not respond within 600 seconds.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat Creator Companion 2.4.5

Evidence

• github.com — VRChat Creator Companion / github_issue / vrchat-community/creator-companion / supports: title, date, environment, symptom, error_signature, trigger

workaroundvrc-get / ALCOM2026-07-11

ALCOM 1.1.6–1.1.7 installer cannot bootstrap WebView2 in a clean environment

Symptom: The installer fails to start the WebView2 installer when WebView2 is absent.

Try this first

Install WebView2 separately before ALCOM.

package managementinstall

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Install ALCOM 1.1.6–1.1.7 in a Windows environment without WebView2.

Fix / workaround

• workaround: Install WebView2 separately before ALCOM.

Packages

ALCOM 1.1.6–1.1.7

Evidence

• github.com — vrc-get / ALCOM / github_issue / vrc-get/vrc-get / supports: title, date, environment, symptom, trigger, remedies

workaroundPoiyomi Toon Shader2026-07-09

Poiyomi LTCGI breaks the shader at Android/Quest runtime

Symptom: Enabling LTCGI causes the material to render broken or invisible at Android/Quest runtime despite appearing in the Editor.

Try this first

Disable LTCGI for the affected Android/Quest path.

shader / materialruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Enable LTCGI and run the shader on Android/Quest.

Fix / workaround

• workaround: Disable LTCGI for the affected Android/Quest path.

Packages

Poiyomi Toon Shader 9.3.64

Evidence

• github.com — Poiyomi Toon Shader / github_issue / poiyomi/PoiyomiToonShader / supports: title, date, environment, symptom, trigger, remedies

resolvedUnity2026-07-03

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

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

Try this first

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

import / exportimport

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

VRoid StudioからVRM0.0ではなくVRM1.0でエクスポートしたファイルをVRM Converter for VRChatへ渡す。

Cause

記事の事例ではVRM1.0が使用中のVRM Converter for VRChatで対応していない形式だった。

Fix / workaround

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

Packages

VRM Converter for VRChat

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedAvatar Optimizer2026-07-03

Avatar upload can fail in a field report when AAO is present without ActualPerformanceWindow enabled

Symptom: The author reports cases where pressing upload did not succeed after adding AAO Trace And Optimize.

Try this first

Enable ActualPerformanceWindow in the documented workflow and retry; treat this as a field workaround.

upload / publishingupload

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use the author's workflow without enabling ActualPerformanceWindow from anatawa12's gist pack.

Cause

The article reports a correlation in its environment but does not establish a general root cause.

Fix / workaround

• fix: Enable ActualPerformanceWindow in the documented workflow and retry; treat this as a field workaround.
• workaround: Enable ActualPerformanceWindow and retry the upload.

Packages

Avatar Optimizer

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedother2026-07-03

VRM Converter for VRChat does not convert a VRM 1.0 export in the documented workflow

Symptom: Dragging the VRM into Unity does not result in a convertible avatar in the author's workflow.

Try this first

Export the model as VRM 0.0 for that workflow.

import / exportimport

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Export the VRoid model as VRM 1.0 instead of VRM 0.0 for the documented converter version.

Cause

The article identifies VRM 1.0 as unsupported by the converter path it used.

Fix / workaround

• fix: Export the model as VRM 0.0 for that workflow.

Packages

VRM Converter for VRChat

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedAvatar Optimizer2026-07-03

VRoid avatar remains Performance Poor because PhysBone metrics stay high

Symptom: A simple VRoid avatar still reports Poor with multiple PhysBone-related warnings after adding Avatar Optimizer.

Try this first

Use the tested VRoid material-reduction setting and re-check the SDK performance report; treat this as a field-specific remedy, not a universal PhysBone fix.

PhysBones / Contactsvalidation

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use the author's VRoid export settings before reducing material count.

Cause

The author reports that reducing the VRoid export material count to 2 removed the observed PhysBone-related Poor state in that specific test; the general causal mechanism is not established.

Fix / workaround

• fix: Use the tested VRoid material-reduction setting and re-check the SDK performance report; treat this as a field-specific remedy, not a universal PhysBone fix.

Packages

Avatar Optimizer

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedother2026-06-30

XWear Packager cannot import XAvatar when MToon10 is missing

Symptom: Importing an XAvatar through XWear Packager fails when the model shader dependency is absent.

Try this first

Install UniVRM (VRM 1.0), which provides MToon10, before importing the XAvatar.

package managementresolveUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

Import a VRoid XAvatar without MToon10 available in the project.

Cause

The article identifies the missing MToon10 shader dependency in its documented workflow.

Fix / workaround

• fix: Install UniVRM (VRM 1.0), which provides MToon10, before importing the XAvatar.

Packages

XWear Packager, UniVRM / MToon10

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-30

XWear Packager cannot be installed when VRChat SDK - Avatars is too old

Symptom: XWear Packager cannot be installed into a project with an older Avatar SDK.

Try this first

Update VRChat SDK - Avatars in VCC before installing XWear Packager.

package managementinstallUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

Attempt to install XWear Packager with VRChat SDK - Avatars older than 3.7.1.

Cause

The article states that XWear Packager depends on VRChat SDK - Avatars 3.7.1 or newer.

Fix / workaround

• fix: Update VRChat SDK - Avatars in VCC before installing XWear Packager.

Packages

XWear Packager, VRChat SDK - Avatars <3.7.1

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedModular Avatar2026-06-28

Blendshape Sync preview stops processing later bindings when one target mesh is missing

Symptom: If one Blendshape Sync binding points to a missing target mesh, valid bindings after it stop updating in the editor preview.

Try this first

Use a Modular Avatar build containing the preview fix that continues past null TargetMesh bindings.

simulation / previewpreview

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Preview a Blendshape Sync component whose internal binding list contains a null or destroyed TargetMesh before later valid bindings.

Cause

EditorUpdate returned from the entire binding loop when TargetMesh was null instead of skipping only the invalid binding.

Fix / workaround

• fix: Use a Modular Avatar build containing the preview fix that continues past null TargetMesh bindings.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedModular Avatar2026-06-28

Reactive IsConstantActive analysis is wrong for inverted constant conditions

Symptom: A constant Reactive rule with an inverted condition can be classified as active when it should be inactive.

Try this first

Use a Modular Avatar build containing the corrected IsConstantActive calculation that uses the already-inverted InitiallyActive value directly.

animationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Analyze a constant reaction rule whose condition is inverted.

Cause

InitiallyActive already includes inversion, but IsConstantActive XORed Inverted a second time because of the old expression, reversing the result again.

Fix / workaround

• fix: Use a Modular Avatar build containing the corrected IsConstantActive calculation that uses the already-inverted InitiallyActive value directly.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedModular Avatar2026-06-28

Merge Armature MapBone can throw when merge targets or intermediate bones are missing

Symptom: Merge Armature bone mapping can throw NullReferenceException instead of reporting an unmappable bone when the merge target is unset or a target path segment is missing.

Try this first

Use a Modular Avatar build containing the MapBone null checks, which returns null when the merge target or an intermediate target transform cannot be found.

avatar rigbuild

Cause, environment, and evidence

Unity

Unity version unverified

Error text

NullReferenceException

When it happens

Map a child bone through a Merge Armature whose mergeTarget is unset or whose corresponding target hierarchy lacks an intermediate bone.

Cause

MapBone dereferenced mergeTarget.Get(this) and continued calling Transform.Find after a prior Find had returned null.

Fix / workaround

• fix: Use a Modular Avatar build containing the MapBone null checks, which returns null when the merge target or an intermediate target transform cannot be found.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedModular Avatar2026-06-28

Visible Head Accessory mesh retargeting can calculate bindposes incorrectly

Symptom: Visible Head Accessory can produce incorrectly processed skinned mesh data when retargeting mixed visible and non-visible bone weights.

Try this first

Use a Modular Avatar build containing the Visible Head Accessory mesh/bindpose processing fix.

filesystem / processbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Process a Visible Head Accessory mesh whose primitives mix vertices weighted to visible and non-visible bones and therefore require proxy-bone retargeting.

Cause

The previous mesh-retarget path used incorrect bindpose handling while remapping affected bone weights; the maintainer fix replaces that path with explicit vertex cloning, bone remapping, and corrected bindpose generation.

Fix / workaround

• fix: Use a Modular Avatar build containing the Visible Head Accessory mesh/bindpose processing fix.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedAvatar Optimizer2026-06-25

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

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

Try this first

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

animationruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Animationや表情用BlendShapeで制御されるSkinnedMeshRendererをAAO Merge Skinned Meshの統合対象へ含める。

Cause

記事の事例では、統合対象にギミックや表情制御に使われるメッシュを含めたことで既存AnimationやBlendShape制御が期待通り動作しなくなった。

Fix / workaround

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

Packages

Avatar Optimizer

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRC Gesture Manager2026-06-25

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

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

Try this first

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

animationruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

既存のAnimator Controller内のAnimationが同じシェイプキー、マテリアル色、衣装状態を制御している。

Cause

記事の事例では既存Animationが改変後のデフォルト値を上書きしていた。

Fix / workaround

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

Packages

Unity Animator

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedother2026-06-25

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

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

Try this first

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

PhysBones / Contactsruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

PhysBoneコンポーネントだけでなく、それを含むボーンGameObject自体をEditorOnlyにする。

Fix / workaround

• fix: EditorOnlyにしたボーンを特定してUntaggedへ戻す。記事では復旧困難な場合にPrefabを入れ直している。
• workaround: 破損前のPrefabへ戻し、PhysBone削減はボーン階層ではなく対象コンポーネント単位で行う。

Packages

VRChat avatar

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, remedies

resolvedModular Avatar2026-06-25

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

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

Try this first

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

package managementupload

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Modular Avatarを使用するアイテムを、Modular Avatar未導入のプロジェクトへ配置してアップロードする。

Cause

記事の事例では前提パッケージのModular Avatarが入っていなかった。

Fix / workaround

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

Packages

Modular Avatar missing

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundModular Avatar2026-06-25

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

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

Try this first

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

upload / publishingupload

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

記事の事例では安定版ではなくalpha/beta系のModular Avatarへ更新していた。

Fix / workaround

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

Packages

Modular Avatar alpha/beta in field report

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, remedies

under investigationVRChat Creator Companion2026-06-24

VCC opens to a persistent white screen

Symptom: Creator Companion opens as a blank white screen instead of the project UI.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

editor UIlaunch

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Launch Creator Companion in the reported environment.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat Creator Companion 2.4.5

Evidence

• github.com — VRChat Creator Companion / github_issue / vrchat-community/creator-companion / supports: title, date, environment, symptom, trigger

resolvedVRChat SDK2026-06-23

AvatarDynamicsSetup appears missing because Safe Mode prevented VRChat SDK scripts from loading

Symptom: AvatarDynamicsSetup cannot be found and the project is in Unity Safe Mode.

Try this first

Remove the conflicting/unwanted UdonSharp scripts or otherwise clear the compilation errors so the VRChat SDK assemblies can load; a clean project worked for the OP.

package managementcompile

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Import assets that introduce compilation errors; in the confirmed follow-up, an asset brought UdonSharp scripts that caused compilation failures.

Cause

The OP later reports that imported UdonSharp content caused compilation errors in the new-project reproduction; the old project remained unresolved.

Fix / workaround

• fix: Remove the conflicting/unwanted UdonSharp scripts or otherwise clear the compilation errors so the VRChat SDK assemblies can load; a clean project worked for the OP.
• workaround: Recreate the project and re-import assets selectively to isolate the conflicting package.

Packages

UdonSharp, VRChat SDK - Avatars

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundModular Avatar2026-06-23

Modular Avatar Shape Changer preview can stop updating until Unity restarts

Symptom: Shape Changer preview, and reportedly Blendshape Sync/Object Toggle preview, can stop reflecting changes.

Try this first

Restart Unity.

simulation / previewpreview

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Preview reactive components until the preview enters the reported broken state.

Fix / workaround

• workaround: Restart Unity.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_issue / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, remedies

resolvedModular Avatar2026-06-21

The avatar's original first FX layer can be disabled in MMD worlds after Modular Avatar inserts layers before it

Symptom: In MMD worlds, the avatar's original first FX layer can be disabled after Reactive Components or merged layers displace it from layer index zero.

Try this first

Use a Modular Avatar build containing the MMD relay fix that tracks the original first FX layer and excludes it from implicit MMD disabling unless explicitly opted in.

project setupruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Insert one or more Modular Avatar layers before the avatar's original first FX layer, then use the avatar in an MMD world.

Cause

MMD relay logic treated the displaced original first layer as one of the layers MMD mode could disable, even though an unprocessed avatar's first FX layer is effectively pinned on and cannot be disabled by the MMD world.

Fix / workaround

• fix: Use a Modular Avatar build containing the MMD relay fix that tracks the original first FX layer and excludes it from implicit MMD disabling unless explicitly opted in.

Packages

Modular Avatar

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-19

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

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

Try this first

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

upload / publishingupload

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Illegal byte sequence encounted in the input. Parameter name: string

When it happens

WindowsのPC名（デバイス名）が日本語の状態でVRChat SDKからアバターをアップロードする。

Cause

記事の事例では、日本語のPC名が非ASCII文字を含むネットワーク情報として扱われ、ReserveAvatarId付近でIllegal byte sequenceエラーになったとしている。

Fix / workaround

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

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-19

Build & Publish fails with Illegal byte sequence when the Windows device name is Japanese

Symptom: Build & Publish does not complete in the author's environment.

Try this first

Rename the PC/device to an alphanumeric name, reboot Windows, and retry Build & Publish.

package managementupload

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Illegal byte sequence encounted in the input. Parameter name: string

When it happens

The field report reproduces the problem with a Japanese Windows PC/device name.

Cause

The author reports that the Japanese device name was the cause in their environment after other path/name checks did not resolve it.

Fix / workaround

• fix: Rename the PC/device to an alphanumeric name, reboot Windows, and retry Build & Publish.

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-17

Quest avatar build fails until Android Build Support is reinstalled

Symptom: The same project can build for Windows but Android/Quest builds fail, including VRChat's example avatar in a new project.

Try this first

Reinstall Android Build Support for Unity 2022.3.22f1 in Unity Hub, then retry the Android build.

package managementbuildUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

Error text

Error building Player because scripts had compiler errors

When it happens

Build the avatar for Android while the local Unity Android Build Support installation is in the failing state documented by the thread.

Cause

The field report isolates the Android Build Support installation state: Android builds failed even for the SDK example avatar, and reinstalling the module resolved the failure.

Fix / workaround

• fix: Reinstall Android Build Support for Unity 2022.3.22f1 in Unity Hub, then retry the Android build.

Packages

VRChat SDK - Avatars, Unity Android Build Support 2022.3.22f1

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-17

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

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

Try this first

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

project setupbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

VRChatが対応していないUnity versionを使用する。

Cause

記事ではVRChatが使用可能なUnity versionを指定しており、それ以外では正常動作しない場合があるとしている。

Fix / workaround

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

Packages

VRChat SDK

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-17

Avatar parts disappear in VRChat when objects remain tagged EditorOnly

Symptom: An avatar or accessory is visible in Unity but disappears in VRChat.

Try this first

Remove the EditorOnly tag from objects that must be included in the avatar build.

build / validationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

The affected GameObject is left tagged EditorOnly before build.

Cause

The article lists EditorOnly as one cause of objects being excluded from the built avatar.

Fix / workaround

• fix: Remove the EditorOnly tag from objects that must be included in the avatar build.

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedlilToon2026-06-17

Avatar renders pink when its shader is missing or not recognized

Symptom: The avatar or accessory appears entirely pink.

Try this first

Install the shader required by the avatar or asset, such as lilToon when appropriate, and verify the material's expected shader.

package managementimport

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

The required shader was not installed, was removed, or the material points to a shader Unity cannot resolve.

Cause

The article identifies a missing/unrecognized shader as the common cause for its documented symptom.

Fix / workaround

• fix: Install the shader required by the avatar or asset, such as lilToon when appropriate, and verify the material's expected shader.

Packages

avatar shader

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-17

Unsupported Unity version can prevent VRChat avatar builds and produce multiple errors

Symptom: Build may not run and multiple errors may appear when using a non-supported Unity version.

Try this first

Use Unity 2022.3.22f1 for the documented 2026 VRChat workflow.

project setupbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use a Unity version outside the VRChat-supported version in the article's troubleshooting scenario.

Cause

The article attributes this class of failure to using an unsupported Unity version.

Fix / workaround

• fix: Use Unity 2022.3.22f1 for the documented 2026 VRChat workflow.

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-17

In avatar projects, when you have multiple avatars in the same scene, the Allow Self and Allow Others properties on Contacts and PhysBones now behave as if each avatar is its ow...

Symptom: In avatar projects, when you have multiple avatars in the same scene, the Allow Self and Allow Others properties on Contacts and PhysBones now behave as if each avatar is its own player while the project is in play mode.

Try this first

Fixed in VRChat SDK 3.10.4.

PhysBones / Contactsruntime

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Fixed VRCTween's integration into the Worlds SDK.

Symptom: Fixed VRCTween's integration into the Worlds SDK.

Try this first

Fixed in VRChat SDK 3.10.4.

scene / world

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Fixed an issue where UdonSharp could miscompile enum usage with a specific amount of members.

Symptom: Fixed an issue where UdonSharp could miscompile enum usage with a specific amount of members.

Try this first

Fixed in VRChat SDK 3.10.4.

Udon / scriptingcompile

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Previously, the capsules shown in the SDK were from tip-to-tip. They're now correctly shown as center-to-center.

Symptom: Previously, the capsules shown in the SDK were from tip-to-tip. They're now correctly shown as center-to-center.

Try this first

Fixed in VRChat SDK 3.10.4.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Gizmo previews for avatar fingers in the SDK should now exactly match the shapes in the client.

Symptom: Gizmo previews for avatar fingers in the SDK should now exactly match the shapes in the client.

Try this first

Fixed in VRChat SDK 3.10.4.

editor UIpreview

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Avatar performance rankings now correctly ignore VRCRaycast components on game objects tagged as EditorOnly.

Symptom: Avatar performance rankings now correctly ignore VRCRaycast components on game objects tagged as EditorOnly.

Try this first

Fixed in VRChat SDK 3.10.4.

editor

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

Fixed a regression preventing the sample scene from being created in new world projects if the UDON scripting define was set at first launch.

Symptom: Fixed a regression preventing the sample scene from being created in new world projects if the UDON scripting define was set at first launch.

Try this first

Fixed in VRChat SDK 3.10.4.

scene / worldlaunch

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-17

GameObjects are now automatically moved to the Pickup layer again when adding a VRCPickup component to them.

Symptom: GameObjects are now automatically moved to the Pickup layer again when adding a VRCPickup component to them.

Try this first

Fixed in VRChat SDK 3.10.4.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.4.

Packages

VRChat SDK 3.10.4

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-06-16

Contact Receiver Box Size is dropped when a package is imported before SDK 3.10.4

Symptom: A Box-shaped VRC Contact Receiver loses its Size value after a package is imported into an older SDK project and that project is later upgraded.

Try this first

Upgrade to SDK 3.10.4 or later before importing the package. If it was already imported into an older SDK, re-import it after upgrading.

package managementimport

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Import a package containing Box Contact Receiver data into an SDK version that does not recognize the Box fields, then upgrade to SDK 3.10.4 or later.

Cause

VRChat staff explains that Unity drops serialized component data that the installed SDK version does not recognize; Box contacts became available in SDK 3.10.4.

Fix / workaround

• fix: Upgrade to SDK 3.10.4 or later before importing the package. If it was already imported into an older SDK, re-import it after upgrading.

Packages

VRChat SDK - Avatars <3.10.4

Evidence

• feedback.vrchat.com — VRChat Feedback / forum / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-06-11

SDK build aborts when the first Gesture animator layer has no valid mask

Symptom: The SDK build is aborted and the Builder reports an invalid/missing mask on the first Gesture layer.

Try this first

Use a persistent valid mask such as the SDK sample vrc_HandsOnly on the original avatar's first Gesture layer and avoid temporary build-copy masks.

animationvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Gesture Layer needs valid mask on first animator layer

When it happens

Use a custom Gesture controller whose first layer has no valid Avatar Mask, or references a temporary mask that disappears during build.

Cause

The forum diagnosis identifies the missing/temporary Gesture-layer Avatar Mask as a concrete validation problem; the thread also warns that editing a temporary VRCFury test copy can keep the build unreliable.

Fix / workaround

• fix: Use a persistent valid mask such as the SDK sample vrc_HandsOnly on the original avatar's first Gesture layer and avoid temporary build-copy masks.

Packages

VRChat SDK - Avatars

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

workaroundvrc-get / ALCOM2026-06-06

ALCOM hides an installed legacy package after installing its superseding package

Symptom: Poiyomi Toon and Pro can coexist, collide with duplicate assemblies, and the superseded Toon package disappears from ALCOM's uninstall UI.

Try this first

Remove the legacy package manually and reinstall the superseding package if required to restore compilation.

package managementinstall

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Assembly with name 'Poi.Tools' already exists

When it happens

Install unlocked com.poiyomi.toon then install com.poiyomi.pro, which declares Toon as a legacy package.

Cause

The report identifies legacy package removal skipping unlocked packages and the UI deleting legacy rows even when files remain.

Fix / workaround

• workaround: Remove the legacy package manually and reinstall the superseding package if required to restore compilation.

Packages

ALCOM 1.1.6

Evidence

• github.com — vrc-get / ALCOM / github_issue / vrc-get/vrc-get / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

workaroundVRChat SDK2026-06-05

Second and later local world test clients can freeze on a black screen

Symptom: During local multi-client world testing, the second and subsequent clients can freeze on a black screen; some rejoin attempts can also crash repeatedly.

Try this first

Set VRChat debug logging to Full; a related report's workaround is confirmed by a commenter on this tracked report.

scene / worldtest

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Launch multiple local Build & Test clients for the same world.

Fix / workaround

• workaround: Set VRChat debug logging to Full; a related report's workaround is confirmed by a commenter on this tracked report.

Packages

VRChat SDK - Worlds

Evidence

• feedback.vrchat.com — VRChat Feedback / forum / supports: title, date, environment, symptom, trigger, remedies

resolvedVRChat SDK2026-05-30

Avatar build reports missing Body mesh or Armature after hierarchy changes

Symptom: The SDK build/upload path fails because expected avatar body/armature structure is missing or no longer valid.

Try this first

Restore a valid avatar body/armature hierarchy and verify the Avatar Descriptor/model references before rebuilding.

avatar rigupload

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Avatar is missing a Body mesh or Armature

When it happens

Build an avatar after hierarchy/model changes that remove or invalidate required Body/Armature references.

Cause

The forum report surfaces missing/invalid avatar hierarchy as the immediate validation failure; exact edit causing it is case-specific.

Fix / workaround

• fix: Restore a valid avatar body/armature hierarchy and verify the Avatar Descriptor/model references before rebuilding.

Packages

VRChat SDK - Avatars

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

under investigationVRChat ClientSim2026-05-24

ClientSim processes EditorOnly destruction at a different time than the real build

Symptom: ClientSim can reference EditorOnly objects during build processing or fail to delete objects that the real build removes.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

scene / worldtest

Cause, environment, and evidence

Unity

Unity version unverified

Error text

NullReferenceException

When it happens

Use build-time hierarchy changes involving EditorOnly objects.

Cause

The report attributes the mismatch to DestroyEditorOnly running at a different point from SDK scene processing.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat ClientSim

Evidence

• github.com — VRChat ClientSim / github_issue / vrchat-community/ClientSim / supports: title, date, environment, symptom, error_signature, trigger, root_cause

under investigationvrc-get / ALCOM2026-05-24

ALCOM AppImage shows a permanent white GUI on Ubuntu 26.04

Symptom: The AppImage creates a window but the content remains permanently white.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

launch

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Could not create default EGL display: EGL_BAD_PARAMETER

When it happens

Launch ALCOM AppImage on the reported Ubuntu 26.04 environment.

Cause

The report observes libgvfsdbus/libgvfscommon symbol failures and EGL display creation failure.

Fix / workaround

No verified fix or workaround recorded.

Packages

ALCOM 1.1.5

Evidence

• github.com — vrc-get / ALCOM / github_issue / vrc-get/vrc-get / supports: title, date, environment, symptom, error_signature, trigger, root_cause

resolvedVRChat SDK2026-05-24

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

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

Try this first

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

editor UIbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

記事ではVRC Avatar Descriptorが設定されていない場合を原因候補として挙げている。

Fix / workaround

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

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, remedies

resolvedVRChat SDK2026-05-16

Avatar build blocked because particle collision forces target Pickup/Item layers

Symptom: The SDK rejects the avatar because a particle system can apply collision forces to protected pickup/item layers.

Try this first

Remove those layers from particle collision or set collider force to zero, then rebuild.

project setupvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

This avatar contains one or more particle systems configured to apply collision forces to Pickups and/or Items. This is not allowed.

When it happens

Configure particle collision against the protected layers with non-zero collider force.

Cause

The SDK validation message directly identifies the disallowed particle collision-force configuration.

Fix / workaround

• fix: Remove those layers from particle collision or set collider force to zero, then rebuild.

Packages

VRChat SDK - Avatars

Evidence

• qiita.com — Qiita / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedNDMF2026-05-09

Trailing question mark in NDMF package URL causes HTTP 502 in VPM clients

Symptom: ALCOM/VPM clients cannot download an NDMF package URL ending with a bare question mark.

Try this first

Remove the trailing question mark from the package URL.

package management

Cause, environment, and evidence

Unity

Unity version unverified

Error text

502 Bad Gateway

When it happens

Resolve the malformed release URL from the VPM listing.

Cause

The report identifies a trailing ? appended to the package download URL.

Fix / workaround

• fix: Remove the trailing question mark from the package URL.
• workaround: Use the corrected URL without the trailing question mark.

Packages

NDMF 1.12.0

Evidence

• github.com — NDMF / github_issue / bdunderscore/ndmf / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRC Gesture Manager2026-05-07

Gesture Manager Play Mode recompilation can duplicate components and overwrite the Prefab

Symptom: A script recompilation during Gesture Manager Play Mode can duplicate PhysBone and Contact Receiver components and force-write the Prefab so Revert cannot undo the damage.

Try this first

Use a Gesture Manager pre-release containing the fix reported by the issue label.

PhysBones / Contactsruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Enter Play Mode through Gesture Manager, modify and save a C# script to trigger recompilation, then exit Play Mode.

Fix / workaround

• fix: Use a Gesture Manager pre-release containing the fix reported by the issue label.
• workaround: Use Unity native Play Mode or Avatars 3.0 Emulator for this test path; the reporter did not reproduce the issue there.

Packages

VRC Gesture Manager

Evidence

• github.com — VRC Gesture Manager / github_issue / BlackStartx/VRC-Gesture-Manager / supports: title, date, environment, symptom, trigger, remedies

resolvedVRChat SDK2026-05-05

Importing Modular Avatar into a VRChat World project can cause compilation errors

Symptom: A VRChat World project can fail to compile after Modular Avatar is imported.

Try this first

Use a Modular Avatar build containing the corrected harmony-patches asmdef versionDefines entry for com.vrchat.avatars.

package managementcompile

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Import Modular Avatar into a project that has the VRChat base/world packages but not the avatars package.

Cause

The harmony-patches assembly defined MA_VRCSDK3_AVATARS based on com.vrchat.base, which is also present in World projects; the fix keys the version define to com.vrchat.avatars instead.

Fix / workaround

• fix: Use a Modular Avatar build containing the corrected harmony-patches asmdef versionDefines entry for com.vrchat.avatars.

Packages

Modular Avatar, VRChat SDK - Worlds

Evidence

• github.com — Modular Avatar / github_commit / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundAvatar Optimizer2026-05-04

Trace and Optimize changes behavior of U Shop weapon gimmicks

Symptom: Weapon magazine follow and world-fixed gimmick behavior become incorrect when Trace and Optimize is present.

Try this first

Remove Avatar Optimizer; the reporter states both symptoms disappear.

scene / world

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use the reported U Shop weapon gimmicks together with Trace And Optimize.

Fix / workaround

• workaround: Remove Avatar Optimizer; the reporter states both symptoms disappear.

Packages

Avatar Optimizer

Evidence

• github.com — Avatar Optimizer / github_issue / anatawa12/AvatarOptimizer / supports: title, date, environment, symptom, trigger, remedies

workaroundVRChat SDK2026-04-28

ClientSim settings spam API errors while VRChat SDK is logged out

Symptom: Opening ClientSim settings while logged out continuously spams the Unity Console.

Try this first

Log in to the VRChat SDK before opening the settings path.

editor UItest

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Api Web Request send before online mode is initialized.

When it happens

Open the settings window with the VRChat SDK logged out.

Fix / workaround

• workaround: Log in to the VRChat SDK before opening the settings path.

Packages

VRChat ClientSim

Evidence

• github.com — VRChat ClientSim / github_issue / vrchat-community/ClientSim / supports: title, date, environment, symptom, error_signature, trigger, remedies

workaroundAvatar Optimizer2026-04-26

Avatar Optimizer 1.9.11 removes overlapping VRCPhysBone components

Symptom: VRCPhysBone components intentionally targeting overlapping hierarchies are removed in 1.9.11 but preserved in 1.9.10.

Try this first

Use 1.9.10 until the regression is fixed.

PhysBones / Contacts

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Build the provided overlapping PhysBone hierarchy with Avatar Optimizer 1.9.11.

Fix / workaround

• workaround: Use 1.9.10 until the regression is fixed.

Packages

Avatar Optimizer 1.9.11

Evidence

• github.com — Avatar Optimizer / github_issue / anatawa12/AvatarOptimizer / supports: title, date, environment, symptom, trigger, remedies

resolvedVRChat SDK2026-04-25

Quest avatar upload blocked because Unity Standard shader is unsupported

Symptom: The Android/Quest avatar build cannot be uploaded because materials use an unsupported shader.

Try this first

Replace unsupported materials with VRChat Mobile-supported shaders and revalidate the Android build.

shader / materialvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Standard shader is not supported on Quest

When it happens

Build a Quest avatar variant whose materials still use Unity's Standard shader.

Cause

The platform validation identifies an unsupported shader for Quest/Android.

Fix / workaround

• fix: Replace unsupported materials with VRChat Mobile-supported shaders and revalidate the Android build.

Packages

VRChat SDK - Avatars

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedModular Avatar2026-04-25

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

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

Try this first

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

renderingruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

変形後の髪や衣装がSkinned Mesh RendererのBounds外へ移動し、見る側の視野からBoundsが外れる。

Cause

記事ではBoundsが実際の変形範囲を十分に覆っていないためカリングされることを原因としている。

Fix / workaround

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

Packages

VRChat avatar

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedUnity2026-04-25

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

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

Try this first

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

simulation / previewbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

衣装などのGameObjectにEditorOnlyタグを付けたままbuildする。

Cause

記事では対象GameObjectがEditorOnlyタグのままになっていることを原因としている。

Fix / workaround

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

Packages

VRChat avatar

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedother2026-04-25

Clothes or hair disappear at some poses/view angles because skinned mesh bounds no longer cover the deformed mesh

Symptom: Hair or clothing vanishes when the avatar crouches or is viewed near the edge of the camera frustum.

Try this first

Adjust bounds so the expected deformed mesh remains inside the culling bounds and verify in relevant poses/views.

renderingruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

The deformed mesh moves outside a bounds box that remains around the original pose.

Cause

The article attributes the visual disappearance to renderer bounds no longer enclosing the deformed mesh, causing culling.

Fix / workaround

• fix: Adjust bounds so the expected deformed mesh remains inside the culling bounds and verify in relevant poses/views.

Packages

Unity SkinnedMeshRenderer

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-04-25

Clothing present in Unity is omitted from the VRChat build when left EditorOnly

Symptom: Clothes are visible in Unity but absent after building and entering VRChat.

Try this first

Change the tag so the clothing is included in the build and verify in Play Mode/private VRChat.

simulation / previewbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

The clothing object remains tagged EditorOnly.

Cause

The article identifies EditorOnly on the clothing object as the cause in this failure mode.

Fix / workaround

• fix: Change the tag so the clothing is included in the build and verify in Play Mode/private VRChat.

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-04-25

Avatar clothing can be correct on PC but missing on mobile because the platform build diverged

Symptom: The PC avatar is dressed correctly while mobile users see missing clothing.

Try this first

Verify the target-platform hierarchy/tags/parameters separately and test the mobile build before publication.

build / validationbuild

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

The mobile/platform-specific avatar build omits clothing, retains EditorOnly, or has other configuration divergence.

Cause

The article groups this symptom under mistakes in the separate platform build rather than the PC build.

Fix / workaround

• fix: Verify the target-platform hierarchy/tags/parameters separately and test the mobile build before publication.

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundNDMF2026-04-16

TexTransTool TextureBlender leaks VRAM during repeated NDMF Preview updates

Symptom: Changing TextureBlender settings while using NDMF Preview accumulates VRAM until restarting the Editor becomes necessary.

Try this first

Restart the Unity Editor to reclaim the accumulated VRAM; no preventive workaround is documented in the issue body.

renderingpreview

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Repeatedly update TextureBlender in NDMF Preview so new render textures are allocated across preview refreshes.

Cause

The issue report identifies addTex as not being disposed, leaving pooled render textures marked in use and preventing reuse.

Fix / workaround

• workaround: Restart the Unity Editor to reclaim the accumulated VRAM; no preventive workaround is documented in the issue body.

Packages

TexTransTool, NDMF

Evidence

• github.com — TexTransTool / github_issue / ReinaS-64892/TexTransTool / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-04-16

Fixed the result transform facing the wrong way when the ray misses when configured to snap on miss.

Symptom: Fixed the result transform facing the wrong way when the ray misses when configured to snap on miss.

Try this first

Fixed in VRChat SDK 3.10.3.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.3.

Packages

VRChat SDK 3.10.3

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-04-16

VRCRaycast now behaves correctly in SDK projects where domain reloading is disabled.

Symptom: VRCRaycast now behaves correctly in SDK projects where domain reloading is disabled.

Try this first

Fixed in VRChat SDK 3.10.3.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.3.

Packages

VRChat SDK 3.10.3

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-04-16

Removed Disable On Miss from VRCRaycast, since it's redundant now that avatar animator parameters are available instead.

Symptom: Removed Disable On Miss from VRCRaycast, since it's redundant now that avatar animator parameters are available instead.

Try this first

Fixed in VRChat SDK 3.10.3.

animation

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.3.

Packages

VRChat SDK 3.10.3

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-04-16

Mirrors now render in Camera.onPreCull instead of OnWillRenderObject to match the 2026.1.3 client.

Symptom: Mirrors now render in Camera.onPreCull instead of OnWillRenderObject to match the 2026.1.3 client.

Try this first

Fixed in VRChat SDK 3.10.3.

rendering

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.3.

Packages

VRChat SDK 3.10.3

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-04-16

Fix String and Image URL loading features not working in ClientSim since 3.10.2.

Symptom: Fix String and Image URL loading features not working in ClientSim since 3.10.2.

Try this first

Fixed in VRChat SDK 3.10.3.

simulation / previewtest

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.3.

Packages

VRChat SDK 3.10.3

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

under investigationNDMF2026-04-14

NDMF Console throws NullReferenceException after package updates and Play Mode

Symptom: NDMF reports an internal plugin NullReferenceException after project package updates and entering Play Mode.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

package managementbuild

Cause, environment, and evidence

Unity

Unity version unverified

Error text

System.NullReferenceException: Object reference not set to an instance of an object

When it happens

Update project packages and enter Play Mode in the reported project state.

Fix / workaround

No verified fix or workaround recorded.

Packages

NDMF

Evidence

• github.com — NDMF / github_issue / bdunderscore/ndmf / supports: title, date, environment, symptom, error_signature, trigger

under investigationModular Avatar2026-04-04

Merge Armature does not follow Hips rotation across Blender/3ds Max FBX conventions

Symptom: An outfit FBX exported from 3ds Max fails to follow avatar Hips rotation when merged into a Blender-origin avatar.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

avatar rigimportUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

Merge armatures with the reported 90-degree Hips rest-rotation mismatch between exporters.

Cause

The report identifies differing Blender and 3ds Max FBX bone rotation conventions as the apparent cause.

Fix / workaround

No verified fix or workaround recorded.

Packages

Modular Avatar 1.16.2, NDMF 1.11.0

Evidence

• github.com — Modular Avatar / github_issue / bdunderscore/modular-avatar / supports: title, date, environment, symptom, trigger, root_cause

resolvedModular Avatar2026-03-26

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

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

Try this first

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

build / validationvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

このコンポーネントを正しく動作させるにはアバター内に配置する必要があります

When it happens

記事の事例では小道具がアバターのHierarchy配下に入っていなかった。

Cause

記事の事例では対象オブジェクトがアバター階層の外に配置されていた。

Fix / workaround

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

Packages

Modular Avatar

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-03-18

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

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

Try this first

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

scene / worldupload

Cause, environment, and evidence

Unity

Unity version unverified

Error text

You can only have a single...

When it happens

既存のPipeline Managerに加えて、読み込んだAsset内のサンプルPipeline ManagerもHierarchyに存在する。

Cause

記事では同一SceneにPipeline Managerが2つ存在することを原因としている。

Fix / workaround

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

Packages

VRChat SDK - Worlds

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

Same / similar error

• World upload blocked by multiple Pipeline Manager componentsexact

resolvedVRChat SDK2026-03-18

World upload blocked by multiple Pipeline Manager components

Symptom: The SDK refuses to build/upload a world because more than one Pipeline Manager is present.

Try this first

Use the SDK selection action to find all Pipeline Managers and remove the unintended duplicate.

scene / worldvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

You can only have a single...

When it happens

Import a world asset that includes a sample Pipeline Manager into a scene that already has one.

Cause

The field guide identifies duplicate Pipeline Manager components in the scene.

Fix / workaround

• fix: Use the SDK selection action to find all Pipeline Managers and remove the unintended duplicate.

Packages

VRChat SDK - Worlds

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

Same / similar error

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

workaroundVRChat SDK2026-03-11

Avatar Optimizer can change behavior of an Animator Boolean whose default is true

Symptom: After Trace And Optimize, an Animator Boolean parameter configured with default true behaves as though the default were false, changing the intended gimmick state.

Try this first

Enable Trace And Optimize debug option “Skip Entry Exit To Blend Tree”.

animationUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

Optimize an Animator layer whose behavior depends on a Boolean defaulting to true and which is transformed by Entry Exit to Blend Tree.

Cause

Entry Exit to Blend Tree optimization does not preserve the reported Boolean default-true behavior.

Fix / workaround

• workaround: Enable Trace And Optimize debug option “Skip Entry Exit To Blend Tree”.

Packages

Avatar Optimizer 1.9.7, VRChat SDK 3.10.2

Evidence

• github.com — Avatar Optimizer / github_issue / anatawa12/AvatarOptimizer / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-03-08

Avatar upload validation reports “Chest bone is not specified”

Symptom: The SDK blocks or warns during avatar upload because the humanoid Chest mapping is missing.

Try this first

Open the model Rig configuration, configure the Humanoid avatar, and map the Chest bone to the correct skeleton transform.

avatar rigvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Chest bone is not specified

When it happens

Use a Humanoid avatar whose rig/avatar configuration does not map a Chest bone.

Cause

The forum diagnosis points to the missing Humanoid Chest mapping in the avatar rig.

Fix / workaround

• fix: Open the model Rig configuration, configure the Humanoid avatar, and map the Chest bone to the correct skeleton transform.

Packages

VRChat SDK - Avatars

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat Creator Companion2026-02-28

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

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

Try this first

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

package managementcompile

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Couldn't open include file 'lil_vert_encryption.hlsl'

When it happens

記事ではpackageインポート後にlilToon内のファイル参照が壊れた状態で発生した。

Fix / workaround

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

Packages

lilToon

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, remedies

under investigationModular Avatar2026-02-26

Modular Avatar build throws Destination array was not long enough

Symptom: The avatar build fails in ReactiveObjectPass.GenerateNaNimatedBones with System.ArgumentException.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

build / validationbuild

Cause, environment, and evidence

Unity

Unity version unverified

Error text

System.ArgumentException: Destination array was not long enough. Check destIndex and length, and the array's lower bounds

When it happens

Create a toggle, target an outfit with MA Object Toggle, then use MA Shape Changer to delete the selected HairPony shape in the reported Lapwing setup.

Fix / workaround

No verified fix or workaround recorded.

Packages

Modular Avatar, NDMF

Evidence

• github.com — Modular Avatar / github_issue / bdunderscore/modular-avatar / supports: title, date, environment, symptom, error_signature, trigger

resolvedother2026-02-12

VRChat Unity project repeatedly fails to open after FatalError

Symptom: The Unity project remains unable to start after repeated launch attempts.

Try this first

As a last-resort recovery, create a clean VRChat project, verify the old scene can open, copy the scene, and reintroduce assets/tooling incrementally to isolate the failing dependency.

package managementlaunch

Cause, environment, and evidence

Unity

Unity version unverified

Error text

FatalError

When it happens

The article covers a project-specific fatal startup state after normal recovery attempts have failed.

Fix / workaround

• fix: As a last-resort recovery, create a clean VRChat project, verify the old scene can open, copy the scene, and reintroduce assets/tooling incrementally to isolate the failing dependency.
• workaround: Rebuild the project incrementally from a clean project while preserving known-good scene/assets.

Packages

VRChat project

Evidence

• note.com — note / article / supports: title, date, environment, symptom, error_signature, trigger, remedies

workaroundVRChat SDK2026-02-11

VRC Constraint can throw MissingReferenceException after a monitored PhysBone is removed

Symptom: Enabling objects, prefab override operations, undo/redo, or related editor actions can repeatedly throw MissingReferenceException from VRCConstraintBase when stale PhysBone references remain.

Try this first

Inspect the constraint in Debug mode for missing monitored PhysBone references; recreating the affected constraint clears the stale reference in the reported workflow.

package managementeditor

Cause, environment, and evidence

Unity

Unity version unverified

Error text

MissingReferenceException: The object of type 'VRCPhysBone' has been destroyed but you are still trying to access it.

When it happens

A VRC Constraint has monitored a PhysBone that is later removed, leaving missing references in its monitored PhysBones data.

Fix / workaround

• workaround: Inspect the constraint in Debug mode for missing monitored PhysBone references; recreating the affected constraint clears the stale reference in the reported workflow.

Packages

VRChat SDK - Avatars 3.10.2-beta.1

Evidence

• feedback.vrchat.com — VRChat Feedback / forum / supports: title, date, environment, symptom, error_signature, trigger, remedies

resolvedVRChat SDK2026-02-05

Additionally, UdonSharp utility scripts that come with new world projects will no longer be recreated if you delete them, provided you don't also delete the data locator next to...

Symptom: Additionally, UdonSharp utility scripts that come with new world projects will no longer be recreated if you delete them, provided you don't also delete the data locator next to them.

Try this first

Fixed in VRChat SDK 3.10.2.

scene / world

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed DataDictionary sometimes failing to get a value if the key is a data structure like Vector3Int.

Symptom: Fixed DataDictionary sometimes failing to get a value if the key is a data structure like Vector3Int.

Try this first

Fixed in VRChat SDK 3.10.2.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed VRChat Constraints sometimes failing to appear properly in the inspector when viewed as prefab overrides.

Symptom: Fixed VRChat Constraints sometimes failing to appear properly in the inspector when viewed as prefab overrides.

Try this first

Fixed in VRChat SDK 3.10.2.

editor UIeditor

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

VRCJson.TryDeserializeFromJson() now always returns false instead of potentially throwing an exception if the input cannot be deserialized.

Symptom: VRCJson.TryDeserializeFromJson() now always returns false instead of potentially throwing an exception if the input cannot be deserialized.

Try this first

Fixed in VRChat SDK 3.10.2.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed PhysBones regression which caused bones resting on PhysBone colliders to jitter.

Symptom: Fixed PhysBones regression which caused bones resting on PhysBone colliders to jitter.

Try this first

Fixed in VRChat SDK 3.10.2.

PhysBones / Contacts

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed validation messages being generated against the wrong platform in avatar and world projects if any assets have platform-specific overrides.

Symptom: Fixed validation messages being generated against the wrong platform in avatar and world projects if any assets have platform-specific overrides.

Try this first

Fixed in VRChat SDK 3.10.2.

scene / worldvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed VRCPickup's "Use Text" inspector field not appearing consistently.

Symptom: Fixed VRCPickup's "Use Text" inspector field not appearing consistently.

Try this first

Fixed in VRChat SDK 3.10.2.

editor UIeditor

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

The SDK no longer reverts changes made to the default world scene and UdonSharp utility scripts when you delete your world project's Library folder.

Symptom: The SDK no longer reverts changes made to the default world scene and UdonSharp utility scripts when you delete your world project's Library folder.

Try this first

Fixed in VRChat SDK 3.10.2.

scene / world

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

In the "Authentication" tab, pressing the "Enter"/"Return" key after entering your username and password now logs you in.

Symptom: In the "Authentication" tab, pressing the "Enter"/"Return" key after entering your username and password now logs you in.

Try this first

Fixed in VRChat SDK 3.10.2.

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

The VRCMirrorReflection component now instantiates non-editable materials instead of changing the original material directly. This means the component no longer modifies the def...

Symptom: The VRCMirrorReflection component now instantiates non-editable materials instead of changing the original material directly. This means the component no longer modifies the default material built into Unity when it is added to a Unity primitive.

Try this first

Fixed in VRChat SDK 3.10.2.

shader / material

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed an issue that could result in the VRCFallback tag being set incorrectly on materials after using certain community packages, which could then result in the materials not a...

Symptom: Fixed an issue that could result in the VRCFallback tag being set incorrectly on materials after using certain community packages, which could then result in the materials not appearing correctly inside VRChat.

Try this first

Fixed in VRChat SDK 3.10.2.

package management

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Passing VRChat Contact Sender or Receiver proxy objects to Utilities.IsValid() now gives accurate results based on whether or not the proxy is still valid.

Symptom: Passing VRChat Contact Sender or Receiver proxy objects to Utilities.IsValid() now gives accurate results based on whether or not the proxy is still valid.

Try this first

Fixed in VRChat SDK 3.10.2.

PhysBones / Contacts

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Fixed internal exceptions caused by destroying a PhysBone that is the parent of one or more VRChat Constraints.

Symptom: Fixed internal exceptions caused by destroying a PhysBone that is the parent of one or more VRChat Constraints.

Try this first

Fixed in VRChat SDK 3.10.2.

PhysBones / Contacts

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

resolvedVRChat SDK2026-02-05

Removed redundant spaces that were included when serializing a data list or data dictionary to JSON with the Minify export type using VRCJSON.

Symptom: Removed redundant spaces that were included when serializing a data list or data dictionary to JSON with the Minify export type using VRCJSON.

Try this first

Fixed in VRChat SDK 3.10.2.

import / exportimport

Cause, environment, and evidence

Unity

Unity version unverified

Fix / workaround

• fix: Fixed in VRChat SDK 3.10.2.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, remedies

workaroundVRChat SDK2026-02-05

VRChat SDK build can fail with “All pipe instances are busy”

Symptom: A VRChat SDK build can fail with an “All pipe instances are busy” error in rare cases.

Try this first

Restart the Unity Editor and retry the build.

networking / transportbuild

Cause, environment, and evidence

Unity

Unity version unverified

Error text

All pipe instances are busy

When it happens

Rare build-time condition; the release note does not provide a deterministic trigger.

Cause

Unity issue; the VRChat release note does not identify the underlying Unity defect.

Fix / workaround

• workaround: Restart the Unity Editor and retry the build.

Packages

VRChat SDK 3.10.2

Evidence

• creators.vrchat.com — VRChat / official_release / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

under investigationVRChat Creator Companion2026-01-31

Unity projects opened from VCC crash regardless of assets

Symptom: New and existing Unity projects crash when opened through the Creator Companion workflow.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

launch

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Open a bare or existing project in the reported VCC environment.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat Creator Companion 2.4.5

Evidence

• github.com — VRChat Creator Companion / github_issue / vrchat-community/creator-companion / supports: title, date, environment, symptom, trigger

resolvedVRChat SDK2026-01-27

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

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

Try this first

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

PhysBones / ContactsruntimeUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

掴ませたいPhysBoneのボーンチェーンに、掴んで伸びる先として使える追加ボーンがない。

Cause

記事の事例では掴む動作に必要なボーン構造が不足していた。

Fix / workaround

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

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedVRChat SDK2026-01-27

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

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

Try this first

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

PhysBones / ContactsruntimeUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

When it happens

単一の末端側ボーンへPhysBoneを設定したが、その先に末端ボーンがなくEndpoint Positionも設定されていない。

Cause

記事の事例ではPhysBoneが動作するための末端位置を定義するボーンまたはEndpoint Positionが不足していた。

Fix / workaround

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

Packages

VRChat SDK - Avatars

Evidence

• note.com — note / article / supports: title, date, environment, symptom, trigger, root_cause, remedies

workaroundVRChat Creator Companion2026-01-23

Turkish locale breaks Udon Graph Interact event binding

Symptom: Interact never fires and Interaction Text is absent while other events work.

Try this first

Use UdonSharp for the same logic or a non-Turkish locale.

Udon / scriptingruntime

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Use Udon Graph Event Interact on a system with Turkish tr-TR locale.

Cause

The report identifies culture-sensitive lowercasing producing dotless ı in the assembled event symbol.

Fix / workaround

• workaround: Use UdonSharp for the same logic or a non-Turkish locale.

Packages

VRChat Creator Companion 2.4.5

Evidence

• github.com — VRChat Creator Companion / github_issue / vrchat-community/creator-companion / supports: title, date, environment, symptom, trigger, root_cause, remedies

resolvedUnity2026-01-21

CS0246 from FindMissingScripts.cs resolved by moving the editor utility into an Editor folder

Symptom: A custom FindMissingScripts editor utility keeps producing CS0246 compilation errors.

Try this first

Move FindMissingScripts.cs into an Editor folder so it compiles as editor-only code.

package managementcompile

Cause, environment, and evidence

Unity

Unity version unverified

Error text

CS0246

When it happens

Place the editor-only utility outside an Editor assembly/folder so editor APIs compile in the wrong context.

Cause

The forum resolution identifies incorrect placement of the editor utility as the cause for the reported case.

Fix / workaround

• fix: Move FindMissingScripts.cs into an Editor folder so it compiles as editor-only code.

Packages

FindMissingScripts.cs

Evidence

• ask.vrchat.com — VRChat Ask Forum / forum / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedUnity2026-01-19

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

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

Try this first

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

launch

Cause, environment, and evidence

Unity

Unity version unverified

Error text

License error

When it happens

記事の事例ではUnity_lic.ulfライセンスファイルが存在しない状態。

Cause

記事ではUnity_lic.ulfが存在しないことを原因としている。

Fix / workaround

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

Packages

Unity Hub

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

workaroundVRChat SDK2026-01-19

VRChat SDKで「Missing Credentials」が出る

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

Try this first

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

setup

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Missing Credentials

When it happens

記事では、Authenticationタブ上ではログイン済みに見える状態で発生している。

Fix / workaround

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

Packages

VRChat SDK

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, error_signature, trigger, remedies

resolvedVRChat SDK2026-01-19

Avatar validation failed when Expression Parameters exceed the limit

Symptom: The avatar cannot pass validation in the documented case.

Try this first

Reduce parameters or remove/disable Modular Avatar items that consume unnecessary parameters.

avatar parametersvalidation

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Avatar validation failed

When it happens

The article's example exceeds the available Expression Parameters budget.

Cause

The article identifies Expression Parameters usage over the limit for its documented case and explicitly warns that the same generic message can have other causes.

Fix / workaround

• fix: Reduce parameters or remove/disable Modular Avatar items that consume unnecessary parameters.

Packages

VRChat SDK - Avatars

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-01-15

Incomplete failed avatar state can keep later avatar uploads from completing

Symptom: Avatar upload does not complete after Avatar Uploading and Signature Uploading; a failed avatar may remain visible on the website but unavailable in VRChat.

Try this first

Delete the failed/incomplete avatar entry and retry the upload.

upload / publishingupload

Cause, environment, and evidence

Unity

Unity version unverified

When it happens

Retry uploads while an earlier avatar upload remains in an incomplete/inconsistent server-side state.

Cause

The reporter's final resolution identifies an inconsistency associated with an avatar that had not finished uploading.

Fix / workaround

• fix: Delete the failed/incomplete avatar entry and retry the upload.

Packages

VRChat SDK - Avatars 3.9.0 / 3.10.1

Evidence

• feedback.vrchat.com — VRChat Feedback / forum / supports: title, date, environment, symptom, trigger, root_cause, remedies

under investigationVRChat Creator Companion2026-01-05

VCC cannot create an avatar project when com.vrchat.avatars ~3.10.x cannot resolve

Symptom: Creating a Unity 2022 Avatar Project fails immediately and VCC reports that the VRChat Avatars package cannot be resolved.

under investigation

No verified fix is recorded yet. Check the known conditions and evidence below.

package managementresolve

Cause, environment, and evidence

Unity

Unity version unverified

Error text

Could not resolve package com.vrchat.avatars ~3.10.x

When it happens

Create a new Unity 2022 Avatar Project in VCC 2.4.5.

Fix / workaround

No verified fix or workaround recorded.

Packages

VRChat Creator Companion 2.4.5, com.vrchat.avatars ~3.10.x

Evidence

• github.com — VRChat Creator Companion / github_issue / vrchat-community/creator-companion / supports: title, date, environment, symptom, error_signature, trigger

resolvedVRChat SDK2026-01-04

New avatar upload rejected with “id is not allowed to be used” on an older SDK

Symptom: A newly created avatar cannot be uploaded.

Try this first

Update VRChat SDK - Base and VRChat SDK - Avatars in VCC to 3.9.0 or newer.

upload / publishingupload

Cause, environment, and evidence

Unity

Unity version unverified

Error text

id is not allowed to be used. Make sure you're using SDK 3.9.0 or newer.

When it happens

Attempt to upload a new avatar with a VRChat SDK older than 3.9.0 in the documented environment.

Cause

The article attributes the rejection to the outdated VRChat SDK requirement for new avatar uploads.

Fix / workaround

• fix: Update VRChat SDK - Base and VRChat SDK - Avatars in VCC to 3.9.0 or newer.

Packages

VRChat SDK - Avatars <3.9.0

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies

resolvedVRChat SDK2026-01-02

World Build & Test blocked until Layers and Collision Matrix are configured

Symptom: Build & Test and online world upload are blocked.

Try this first

Use the SDK setup actions for Layers and Collision Matrix, then build again.

project setupvalidationUnity 2022.3.22f1

Cause, environment, and evidence

Unity

current Unity verified / 2022.3.22f1

Error text

You must address Layers and Collision Matrix issues before you can build.

When it happens

Use a newly created world project whose VRChat-required Layers and Collision Matrix setup has not been applied.

Cause

The SDK validation reports missing required Layers/Collision Matrix setup.

Fix / workaround

• fix: Use the SDK setup actions for Layers and Collision Matrix, then build again.

Packages

VRChat SDK - Worlds 3.10.1

Evidence

• zenn.dev — Zenn / article / supports: title, date, environment, symptom, error_signature, trigger, root_cause, remedies