Skip to main content
Version: 2.5.0

Avatar Converter Settings

Avatar Converter Settings component holds settings for converting VRChat avatars to Android.

This component should be attached to the root object of the avatar.

Basic Settings

Folder to Save

Show the folder where the generated assets are saved when converting.

  • The folder is Assets/VRCQuestToolsOutput/<Avatar object name>.
  • Assets are overwritten when converting.

Material Conversion Settings

Default Material Conversion Settings

Default material conversion settings used during conversion. If you need to convert each material individually, use Additional Material Conversion Settings.

The following shaders are supported for material conversion. For unsupported shaders, the conversion process of the Standard shader is applied.

  • Standard
  • Standard (Specular setup)
  • Unlit/ shaders
  • Unity-Chan Toon Shader 2.0 (UTS2)
  • Arktoon-Shaders
  • ArxCharacterShaders (AXCS)
  • Sunao Shader
  • lilToon
  • Poiyomi Toon Shader
Material Conversion SettingsDescription
Toon LitUse the VRChat/Mobile/Toon Lit shader for the converted material.
MatCap LitUse the VRChat/Mobile/MatCap Lit shader for the converted material. After applying the same conversion process as Toon Lit, use the MatCap texture specified in the conversion settings.
Material ReplacementReplace with the specified material in the conversion settings.
ParameterDescriptionConversion Mode
Generate Textures for AndroidGenerate Android textures when converting avatar. If off, the original main texture is used.Toon Lit, MatCap Lit
Textures Size LimitSelect the maximum size of the generated texture.Toon Lit, MatCap Lit
Main Texture BrightnessSelect the brightness of the generated main texture.Toon Lit, MatCap Lit
Generate shadows from normal mapGenerate pseudo shadows from normal maps and reflect them in textures.Toon Lit, MatCap Lit
MatCap TextureSet the MatCap texture used by the MatCap Lit shader.MatCap Lit
Replaced MaterialSet the material used in Material Replacement mode.Material Replacement

Additional Material Conversion Settings

Use this when you want to set conversion settings for each material.

ParameterDescription
Target MaterialSet the material to which the conversion settings are applied.
Material Conversion SettingsSet the material conversion settings to apply to the target material.

Update Converted Android Textures

Update the converted Android textures with the current settings.

Avatar Dynamics Settings

Set the Avatar Dynamics (PhysBone, Collider, Contact) for the avatar. Android avatars have a maximum of Poor for Avatar Dynamics, so specify the components to keep after conversion and delete the rest during conversion.

Avatar Dynamics Settings

Select checkboxes for the components to keep after conversion in the window that opens when you click the Avatar Dynamics Settings button. After selecting, click the Apply button.

PhysBones, PhysBone Colliders, Contact Senders & Receivers

Lists of PhysBones, Colliders, and Contacts to keep after conversion.

Estimated Performance Rank

Estimated performance rank of Avatar Dynamics. Set all items to Poor or better.

Advanced Converter Settings

Animation Override

Use the animation clips specified in Animator Override Controller to create a new Animator Controller during conversion.

Remove Vertex Color from Meshes

Add the Vertex Color Remover component to the converted avatar to remove vertex colors.

You don't usually need to turn this option off. Turn it off if you are using a special shader for PC avatars that uses vertex colors in order to prevent unintended behavior.

NDMF Phase to Convert

Select a NDMF phase to convert the avatar.

Convert

Execute the conversion of the avatar. Typically, the avatar is converted in the following steps.

  1. Generate textures and materials for Android.
  2. Convert the animation clip to use the material created in step 1.
  3. Convert the Animator Controller to use the converted animation clip and resolve the Animator Override Controller.
  4. Duplicate the original avatar and set the converted assets.
  5. Delete unsupported components such as Constraints.
  6. Add Platform Target Settings and set the build target to Android.
  7. Execute special conversion process (described below).
  8. Deactivate the original avatar in the scene.

Special conversion process

Depending on the assets you are using, a special conversion process is executed.

VirtualLens2

Set Remote Only Mode of VirtualLensSettings component to Force Enable.

If you are using VirtualLens2 with the destructive setup, set EditorOnly tag to _VirtualLens_Root and VirtualLensOrigin objects.

NDMF

The VRCQuestTools plugin performs the following processes in the project which have Non-Destructive Modular Framework (NDMF). To avoid VRChat SDK validation, use the Avatar Builder window to build the avatar when building for Android.

Resolving Phase

Change VirtualLens2 settings for Android.

Transforming Phase

Remove vertex colors from the meshes. This process is performed after NDMF Mantis LOD Editor.

Convert the avatar for Android when the NDMF conversion phase is Transforming. This process is performed after TexTransTool and Modular Avatar.

Optimizing Phase

Convert the avatar for Android when the NDMF conversion phase is Optimizing. This process is performed after TexTransTool and before AAO: Avatar Optimizer.