Troubleshooting Reference

Troubleshooting Reference

Symptom → cause → fix lookup tables for common issues.

WorldAudio Not Working

Symptom	Cause	Fix
AudioSource not playing	Missing OccludedEmitter	Add OccludedEmitter to the AudioSource GameObject
AudioSource stuck silent	Direct AudioSource.Play()/Stop() used	Use AudioSourceStateController methods instead, or don't attach OccludedEmitter
Audio not managed by WorldAudio	AVPro Video Player	AVPro bypasses Unity audio pipeline. Use Unity VideoPlayer, or add a separate AudioSource for manual control
Emitters not updating	Multiple AudioListeners	WorldAudio supports exactly one AudioListener. Remove extras from other cameras
AudioSources randomly silent	Exceeded VRChat ~32 active limit	WorldAudio manages this via MaxActiveSources. Lower the value to stay within budget
Emitter reverb not working	Missing OccludedEmitter	Add OccludedEmitter to the AudioSource GameObject (required for reverb)

See WorldAudio Limits Reference for detailed explanations of each limitation.

Reverb Issues

Symptom	Cause	Fix
No reverb on player voice	Reverb preset still Off on ActiveGlobalAudioEffects	Change preset from Off to desired reverb
Reverb not changing per zone	Optional Reverb not assigned on override	Assign AudioReverbFilter to Optional Reverb field
Reverb always on	Player never leaves zone	Check trigger collider size, verify OnPlayerTriggerExit fires

See How to Set Up Reverb for full setup guide.

Voice Channels Not Working

Symptom	Cause	Fix
Players in different channels can't hear each other	Channel ID mismatch	Ensure both zones share the same Privacy Channel Id
Microphone not heard in room	Microphone priority too low	Give microphone higher priority than room override
Channel changes feel laggy	Low PlayerUpdateRate with many players	Increase PlayerUpdateRate for faster updates at higher CPU cost
Player hears everyone despite channel	Channel ID is -1	-1 means no privacy (audible to all). Set a positive ID

See Private Voice Channels for channel behavior details and How to Set Up Voice Channels for setup guides.

See Also

• Troubleshooting Guide — diagnostic walkthroughs
• FAQ — frequently asked questions