Avatar Not Working Properly

Troubleshooting tips for download, exporter installation, export, and avatar display

This page has been machine translated and may contain inaccuracies.
In this guide, the avatar display app of VRC Avatar Viewer is referred to as the "Viewer App", and the motion capture app (Motion Capture for VRC Avatar Viewer) is referred to as the "Capture App".

Cannot launch the app

If the viewer app does not launch, first check the extraction status of the ZIP file and the Windows security display.

  • If your security software is blocking it, check that the viewer app is allowed to run
Checklist
  • Cases where the app is blocked by Trend Micro have been confirmed
  • Do not move only some files in the folder; use the entire extracted folder as-is
  • To avoid mixing with older versions, extract the latest version to a new folder and try again

Cannot install Exporter

If Exporter does not appear in the VCC package list, check that the VPM repository has been added and that the target project is open.

Related Guide

Cannot export avatar

If export fails, check that there are no errors in Unity and that you have correctly selected the avatar to export.

  • Check that there are no red errors in the Unity Console
  • Check that you have selected the top parent object of the avatar in the Hierarchy
  • Run from the right-click menu VRC Avatar Viewer → Export Avatar (.avab)
Note
  • Exporting does not modify the original avatar data
  • If you change the avatar structure, please export again

Display looks incorrect

Since avatars are displayed in a different environment than the VRChat client, some shaders, gimmicks, and effects may not look exactly the same.

If the display looks incorrect, first try with just the base model without any modifications. If it still looks incorrect in that state, the avatar is the cause, so please contact the creator.

Otherwise, gimmicks or animations in the modifications are often the cause. However, since we cannot know the details of your modifications, we ask that you investigate this yourself. We recommend preparing a base model first, then adding modified items one by one to find and remove the one causing the issue.

Also check the following list

  • Use the latest version of the viewer app and Exporter
  • Some gimmicks and special shaders may not look the same as in VRChat on the viewer app
  • If the display position or size looks incorrect, reset the camera by double-clicking

If the issue is not resolved

If the issue persists after checking the above, please contact the creator.

  • Check Contact the Creator for contact information
  • It will be easier to confirm if you include the details of the problem, the version of the app you are using, and a screenshot
  • Please specify whether the problem occurs only with a specific avatar or with other avatars as well