Skip to main content

Convert Avatar

Convert your avatar to Android compatible.

First, you should upload your avatar for PC platform. Then convert your avatar and upload it for Android platform.

info

Avatars are managed by Blueprint ID in VRChat, and you can upload avatar data for each platform with the same Blueprint ID. So PC users will see the original avatar and Android users will see the converted avatar.

caution

VRoid Studio avatars use a lot of transparent materials, and they are not supported on Android. VRCQuestTools can't help such avatars, so you need to modify them manually.

Prerequisite Knowledge​

  • Basic knowledge of Unity for VRChat
  • How to upload your avatar to VRChat

Upload PC Avatar​

Before converting your avatar, you should upload your avatar for PC platform. But before uploading your avatar for PC platform, you should do additional work.

Assign Network IDs to PhysBones​

You need to assign Network IDs to PhysBones to synchronize them correctly between PC and Android.

  1. Select VRChat SDK > Utilities > Network ID Import and Export Utility in the menu bar.
  2. Network ID Utility window appears.
  3. Select your avatar in the Target dropdown.
  4. Click Regenerate Scene IDs button.
  5. Generate New Scene IDs dialog appears and click Generate New IDs button.
  6. List of PhysBones appears.

Upload Avatar​

Upload your avatar as usual for PC.

Set up Avatar Converter Settings​

Set up settings to convert your avatar to Android compatible.

  1. Select your avatar in Hierarchy.
  2. Right-click on the avatar and select VRCQuestTools > Convert Avatar for Quest.
  3. Convert Avatar for Android window appears.
  4. Click Begin Converter Settings button of the window.
  5. VQT Avatar Converter Settings component is added to your avatar and settings appear.

Do settings for the following items.

Reduce Avatar Dynamics Components​

Android avatar has a hard cap for Avatar Dynamics (PhysBones, Colliders and Contacts). If your avatar has too many PhysBones, you should reduce them.

https://docs.vrchat.com/docs/avatar-performance-ranking-system#quest-limits

  • 8 PhysBone components
  • 64 PhysBones affected transforms
  • 16 PhysBones colliders
  • 64 PhysBones collider checks
  • 16 Avatar Dynamics Contacts

In other words, even if your avatar is ranked as "Very Poor", you must pass "Poor" performance rank in Avatar Dynamics category at least.

  1. Expand Avatar Dynamics Settings section, then click Avatar Dynamics Settings button.
  2. Avatar Dynamics Selector window appears.
  3. Select the checkbox of PhysBones and others you want to keep. Worst estimated performance rank should be within Poor.
  4. Click Apply button.

Convert Avatar​

tip

It's good time to create a prefab (or prefab variant) if you are using prefab workflow. VRCQuestTools keeps references to prefabs after conversion. And you can reuse the converter settings.

  1. Scroll down the settings and click Convert button.
  2. The converted avatar is created in the same scene.
    • Its name has the suffix (Android).
    • Generated assets are saved in Assets/VRCQuestTools/<Avatar's object name> folder.
note

The original avatar is deactivcated after conversion. You can restore it from the inspector.

info

VRCQuestTools never optimize avatar performance. So in most cases, converted avatars would have "Very Poor" performance rank in Android platform.

In Android platform, minimum displayed performance rank of safety can be "Good" or "Poor". This means "Very Poor" avatars are always blocked and replaced with your fallback avatar or imposter unless other people individually change Avatar Display setting (as known as "Show Avatar" functionality).

And smartphone users can't see Very Poor avatars.

References:

Switch Platform to Android​

To upload your avatar to Android platform, you should switch Unity's target platform to Android.

  1. Select File > Build Settings in the menu bar.
  2. Select Android in the Platform list.
  3. Click Switch Platform button.
  4. Wait for a while until the process is finished. At first time, it takes a long time.
note

Result of the switching platform is saved in the project since Unity 2019. So you don't need to wait for a long time from next time.

tip

In some situation, you can use Unity Accelerator to speed up the switching platform process. See Unity Documentation for details.

Upload Android Avatar​

Now you can upload the converted avatar to Android platform. Make sure the original avatar and the converted avatar uses the same Blueprint ID in Pipeline Manager.

After uploading, make sure the avatar thumbnail has the green Mobile icon.