Troubleshooting: Difference between revisions

From VRChat Wiki
DAG-XR (talk | contribs)
m Usr 8ee44c1a-f905-4e08-bb61-e1cd34e09fc0 moved page Troubleshooting to Community:Troubleshooting: These are Community troubleshooting tips. Community noticebox placed, and help.vrchat.com website linked to the top.
~Pausbe (talk | contribs)
Corrections from last edit and some additions on very poor on mobile / standalone devices.
 
(2 intermediate revisions by 2 users not shown)
Line 47: Line 47:
*Pixel Light Count
*Pixel Light Count


===Avatar Optimization===
=== Avatars ===
Avatars could be one of the biggest causes for performance issues. Consider changing some [[Special:MyLanguage/Settings#Avatar Optimization|settings]] on how avatars get shown to you.
Avatars could be one of the biggest causes for performance issues. On standalone VR & mobile platforms, there can be a maximum of 4 Very Poor avatars shown at once.
 
==== Avatar Optimization ====
Consider changing some [[Special:MyLanguage/Settings#Avatar Optimization|settings]] on how avatars get shown to you.
{| class="wikitable"
{| class="wikitable"
!Block Poorly Optimized Avatars
!Block Poorly Optimized Avatars
|You can set certain avatar performance ranks to be hidden by default.  
|You can set certain avatar performance ranks to be hidden by default. On standalone VR & mobile platforms, Very Poor avatars will be blocked automatically.  
'''Note:''' Setting this option too strictly could cause a lot of avatars to be hidden
'''Note:''' Setting this option too strictly could cause a lot of avatars to be hidden
|-
|-

Latest revision as of 22:17, 9 February 2026

V · EThis page is a stub.
You can help the VRChat Wiki by improving it.
[Reason: More information needed, what else does a troubleshooting page need?]

This page will help you troubleshoot any issues you may have.

Common issues and solutions

Below are some common issues users may have, check out the help.vrchat.com articles for more information!

Client[1]

How can I completely reinstall VRChat? My download speeds are slow
I'm experiencing performance issues / heavy frame drops I can't see anyone's avatars
I can't hear any sound My microphone isn't working

SDK[2]

The SDK Control Panel is blank I'm stuck on building or uploading content

SDK Listing Wrong Platform

You may run into an issue where both the VRChat SDK and the Unity interface imply that the SDK is set to a different platform than what you have currently selected (e.g. Android when it's set to Windows, Windows when it's set to Android).

This can manifest itself in ways such as the error "World download size too large for the target platform" despite building for Windows which does not have this limitation. This is due to Unity temporarily switching platforms when accessing the override panel of an asset (such as a texture or sound file).

To get back out of this state simply select any texture file within your project, click the Android icon under the settings for the asset, click the Windows tab (the screen icon) and then click back to the leftmost "Default" tab. Reverse the Windows and Android order if you're building for Android.

The SDK and Unity Settings window will now show the correct platform details as expected.

Performance optimization tips

There are a variety of ways to improve your performance in VRChat. Here are some useful ones to look at!

Graphics Settings

VRChat has a plenty of graphics settings to tweak. Consider lowering some of these performance heavy settings.

  • Anti-Aliasing
  • Shadows
  • Level of Detail
  • Particle Physics Quality
  • Particle Limiter
  • Pixel Light Count

Avatars

Avatars could be one of the biggest causes for performance issues. On standalone VR & mobile platforms, there can be a maximum of 4 Very Poor avatars shown at once.

Avatar Optimization

Consider changing some settings on how avatars get shown to you.

Block Poorly Optimized Avatars You can set certain avatar performance ranks to be hidden by default. On standalone VR & mobile platforms, Very Poor avatars will be blocked automatically.

Note: Setting this option too strictly could cause a lot of avatars to be hidden

Maximum Download Size Some avatars may be large in file size, could be problematic if you have slow internet and loading in a bunch of avatars at once!
Maximum Uncompressed Size Some avatars textures could take up a lot space in your memory, could be problematic if you have a lot of avatar shown.

Avatar Culling

Avatar Culling is a great way to dynamically adjust how many avatars are visible around you. Consider turning on some of these settings.

Hide Avatar Beyond Hides avatars past a certain range
Maximum Shown Avatars Hides avatars if there is too many in a instance

Trust and Safety System

Utilize VRChat's Trust and Safety System to hide avatar features based on trust rank. A great way to prevent bad actors from abusing performance heavy avatars.

Try selecting one of the defaults or custom to your liking.

References