VRChat Avatar Error Guide
Imported an avatar or outfit into Unity and got pink materials, red Console errors that won't go away, or an upload that fails? Each page explains what the error means, why it happens, and how to fix it step by step. Works whether you use VCC (VRChat Creator Companion) or ALCOM, and whether you bought your avatar on Booth, Gumroad or Jinxxy. (53 errors)
Upload failures & avatar not showing
- VRChat "Security Checks Failed" on an avatar
- VRChat "Avatar validation failed" when uploading
- VRChat avatar upload stuck on "Building Avatar" or uploading
- VRChat "Avatar Failed Upload" / "Failed to upload"
- Uploaded VRChat avatar not showing, or others see a different avatar (robot / fallback)
- "Loaded data for an avatar we do not own, clearing blueprint ID" in VRChat
- VRChat Blueprint ID problems: detach, reuse, or upload as a new avatar
- VRChat SDK "Missing Credentials" even though you're logged in
- "All pipe instances are busy" when building a VRChat avatar
- VRChat "You do not have permission to upload"
Upload-blocking settings (SDK Validations)
- VRChat "VRCExpressionsMenu uses a parameter that is not defined"
- VRChat avatar over the 256-bit synced parameter limit
- "VRCExpressionsMenu / VRCExpressionParameters object reference is missing"
- "Gesture Layer needs valid mask on first animator layer"
- "Images used for Actions & Moods are too large"
- VRChat audio clip without "Load In Background" enabled
- "mipmapped textures without 'Streaming Mip Maps' enabled"
- VRChat "meshes that were imported with Read/Write disabled"
- VRChat "Blendshape Normals set to 'Calculate'" / Legacy Blendshape Normals
- VRChat "particle systems configured to destroy themselves"
Pink materials & shaders
Red Console errors, scripts & SDK
- "All compiler errors have to be fixed before you can enter playmode" in a VRChat avatar project
- Missing Script on a VRChat avatar ("The referenced script on this Behaviour is missing")
- "The type or namespace name 'VRC' could not be found" (CS0246)
- Modular Avatar (nadena.dev) errors in VRChat
- VRCFury not installed (VRCFury Missing Script / errors)
- FaceEmo not installed (Missing Script on facial expression menu)
- Missing Prefab in Unity (red object names in the Hierarchy)
- Inspector fields showing "Missing" in Unity
- NullReferenceException in a VRChat avatar project
- "Failed to resolve packages" in a VRChat project (VCC / ALCOM)
- Unity project path errors: non-English characters or path too long (VRChat)
- Dynamic Bone left on a VRChat avatar
Quest (Android) & platforms
Performance rank & texture memory
Floating, feet, view position & fingers
Expressions, toggles & gestures
- VRChat toggles not syncing for others (only you can see the change)
- VRChat toggles not saving (reset every time you switch avatars)
- VRChat hand gestures not working (face or hands don't change)
- VRChat lip sync not working (mouth not moving when you talk)
- VRChat eyes twitching / blinking during a closed-eye expression
- VRChat "This avatar uses a mixture of Write Defaults"
- VRChat expressions or toggles not working: FX layer weight is 0
- VRChat radial menu blendshape won't go to 100 or looks steppy for others (float sync and limits)
Fix this automaticallyAvatar Setup Doctor adds a window to Unity. Press Diagnose and it lists what's wrong with your avatar project, why, and how to fix it - the paid version fixes many issues in one click. Free version available.
For this problem, it scans for all of the errors above at once and lists exactly what to fix.
Get Avatar Setup Doctor (Free version available)
For this problem, it scans for all of the errors above at once and lists exactly what to fix.
Get Avatar Setup Doctor (Free version available)