Troubleshooting Guide Hub

When a VRChat creator project breaks, identify the failure type before changing files. Most problems fall into setup, compile, upload, performance, or missing-reference issues, and each one needs a different first step.

If you are new and do not yet know which kind of problem you have, start with Fix Your First Broken VRChat Project. It walks through the safer first diagnosis before you choose one of the more specific pages below.

Quick recovery order

Check setup first, build/upload second, and performance last. That order keeps you from optimizing a project that is still failing because of packages, Unity versions, or broken references.

Confirm versions: check Unity, Creator Companion, and SDK package state.
Classify the error: compile, upload, performance, or missing reference.
Use the matching section: follow one section below before trying unrelated fixes.
Retest once: make one change, reopen Unity if needed, then build or upload again.

VRChat workflow note

Most creator issues are easier to fix when you separate project setup problems from world-content problems. If the SDK cannot build a clean test scene, start with Creator Companion and package state before debugging your world systems.

Start by identifying the problem class

Compile errors

Use these pages if scripts fail to compile, packages clash, or the project becomes unstable after setup changes. Compile errors usually need to be fixed before upload or performance testing means anything.

Upload failures

Use these if the world fails during build or upload, the SDK workflow is unclear, or the publish step breaks unexpectedly. Upload failures often sit between Creator Companion setup and world configuration.

Performance issues

Use these if the world runs badly, only performs well when empty, or breaks down under mirrors, media, or crowd load. Fix broken setup first, then use these pages to reduce cost.

Missing scripts and broken references

Use these if scene objects lose components, imported systems stop working, or packages appear partly installed. Missing scripts are often caused by removed packages, failed imports, or assets that were added before the right SDK dependency existed.

When to switch pages

If you are not blocked and you are trying to add a feature, use the Tutorials Guide Hub instead. If you are deciding how the whole world should be structured, keep VRChat World Creation Guide open beside this page.

What if I do not know what changed?

Start with the smallest stable proof: open Creator Companion, confirm the project packages, open Unity, check the Console, then try a clean build/upload path before changing scene content.

What if performance is the only visible problem?

Check upload and package stability anyway, then move to the world optimization pages. Mirrors, video players, realtime lights, high-poly avatars, and dense synced objects can hide the real cost until multiple users join.