Troubleshooting Guide

Troubleshooting Guide

Step-by-step diagnostic walkthroughs for common issues.

Errors After Installation

If you see errors after adding UVU:

1. You may have an incompatible UdonUtils version
2. Remove UdonVoiceUtils and all its TLP dependencies (UdonUtils, UdonAvlTree) from your project via VCC/ALCOM
3. Add UdonVoiceUtils again — this installs the latest compatible versions of all dependencies automatically

Something Is Not Working

1. Always test with ClientSim in Unity editor first
2. Check the console for errors
   • One AudioListener error is expected and by design — ignore it
3. TLP package errors highlight the offending GameObject in the hierarchy when clicked
4. Start with the first error at the top — cascading errors often stem from one root cause
5. Read the error message — usually says <Variable> is not set
   • Find the script mentioned, locate the variable name, set the missing reference
   • The missing reference is usually part of a prefab
   • When in doubt, start fresh with a clean prefab

Occlusion Not Working

1. Colliders must be on the Environment layer
2. Walls need a collision surface on both sides to work in both directions
   • This is the case with basic BoxColliders
   • MeshColliders also work — see FAQ

Common Issue Lookup Tables

For symptom/cause/fix lookup tables, see:

• Troubleshooting Reference — WorldAudio, Reverb, and Voice Channel issues
• How to Set Up Reverb — reverb-specific issues
• How to Set Up Occlusion — occlusion-specific issues

FAQ

• FAQ