Troubleshooting Avatar Display
What to check when you run into trouble downloading, installing the Exporter, exporting, or displaying your avatar
The App Won't Start
If the viewer app won't start, first check that the ZIP file was fully extracted and whether Windows is showing any security warnings.
- If security software is blocking it, make sure the viewer app is allowed to run
- There have been confirmed cases of the app being blocked by Trend Micro (Virus Buster)
- Don't move only some of the files out of the folder; use the entire extracted folder as-is
- To avoid mixing files with an older version, extract the latest version into a new folder and try again
Can't Install the Exporter
If Exporter doesn't appear in the VCC package list, check that the VPM repository has been added and that you have the target project open.
- For installation steps, see Install the Exporter
Can't Export the Avatar
If the export fails, check whether Unity is showing any errors and whether you have selected the correct avatar to export.
- Check that there are no red errors in the Unity Console
- Make sure you have selected the avatar's top-level parent object in the Hierarchy
- Run the export from the right-click menu:
VRC Avatar Viewer→Export Avatar (.avab)
- Exporting does not change the original avatar's data
- If you change the avatar's setup, export it again
The Avatar Looks Wrong
Avatars are displayed in a different environment from VRChat itself, so some shaders, gimmicks, and effects may not look exactly the same.
If something doesn't look right, first try the base avatar on its own, without any modifications. If it still looks wrong, the cause lies with the avatar itself, so please contact the author.
Otherwise, the problem is usually caused by gimmicks or animations included in your modifications. However, since we have no way of knowing what modifications you've made, we ask that you investigate this yourself. We recommend starting with the base avatar, then adding your modification items one at a time to find the one causing the problem and removing it.
Also check the following:
- Use the latest versions of the viewer app and Exporter
- Some gimmicks and special shaders may not look the same in the viewer app as they do in VRChat
- If the avatar's position or size looks wrong, double-click to reset the camera
If the Problem Persists
If the problem persists after checking the above, please contact the author.
- For contact details, see Contact the Author
- Including a description of the problem, the version of the app you're using, and screenshots makes it easier for us to look into
- Please mention whether the problem occurs only with a specific avatar or with other avatars as well