Skip to content

Install and upgrade your Addon ​

Download the Addon from Booth, import it into Unity, then apply it to the avatar with Face Tracking Installer.

Using a legacy Addon?

If the Installer directs you to the legacy tool, follow the legacy guide. To move to 2.x, see Upgrade from 1.x.

Before you begin ​

  • Avatar compatibility. Check the supported avatar models and versions on the Booth product page before purchasing.
  • Unity project. Use a project ready to upload VRChat avatars, with the base avatar imported.
  • Internet connection. Unity downloads dependencies during import. Wait for import and compilation to finish.

A newer avatar version is missing from the product page

The listed versions have been checked. Modifications, other packages and project settings can still affect the result. If the avatar has been updated, contact Triturbo with the avatar name and version and your Addon version.

Install the Addon ​

  1. Purchase and download from Booth

    Purchase the Addon for your avatar from Triturbo on Booth. Download the latest ZIP from your Booth library and extract the .unitypackage.

  2. Import into Unity

    Drag the .unitypackage into the Project window, or use Assets › Import Package › Custom Package. Follow the package window's prompts to install dependencies and wait for downloads and compilation to finish.

  3. Place the avatar in the scene

    Place the target avatar in the scene and exit Play Mode and Prefab Mode.

  4. Open Face Tracking Installer

    In Unity's top menu, select TriturboFT › Face Tracking Installer.

    Face Tracking - Avatars - Windows, Mac, Linux - Unity 2022.3.22f1 <DX11>
  5. Select the target avatar

    In the Hierarchy, drag the avatar root with the VRC Avatar Descriptor into the drop area. You can also click the avatar's name below it.

    Hierarchy
    All
    Avatars
    Salt
    Airi
    Lime
  6. Review the installation

    The Installer detects the matching Addon and lists the changes. Before installing, check the following:

    1. Addon should show the Addon you imported. Use Change… to select it manually if needed.
    2. Mesh Patch shows the avatar's FBX version on the left and the patch version on the right.
    3. Changes lists the prefabs and mesh patches to add to the avatar.
    4. Expression Parameters shows usage after installation. Stay within 256 bits.
    5. Enable Work on a duplicate to keep the original avatar and install on a copy.
  7. Click Install and upload

    After Installation complete, check the avatar, save the scene and upload through the VRChat SDK. If you installed on a copy, upload that copy.

Update an Addon ​

For an update such as 2.0 to 2.1, download the new version from Booth and import it into the same project. Installed avatars pick up the new content automatically.

To verify, drop the avatar into the Installer. Installed means the Addon is current. If Mesh Patch reports an available patch update, follow the instructions to update the mesh. Upload the avatar again.

Upgrade from 1.x to 2.x ​

Older Addons used individual menu entries such as TriturboFT › <Avatar name> FT. Since 2.x they share Face Tracking Installer. An avatar with a legacy installation needs a one-time upgrade:

  1. Back up the project and scene.
  2. Import the 2.x package for the same Addon.
  3. Open the Installer and drop in the avatar with the legacy Addon installed.
  4. Review the changes and click Upgrade.

When it detects a legacy installation, the primary button changes to Upgrade and the list includes items to remove and install.

  1. Changes marks old prefabs with − Remove and new 2.x prefabs and patches with + Install. Check any old objects or settings you customized before removing them.
  2. Expression Parameters subtracts the usage freed by the old prefab (dashed segment) before adding 2.x usage.
  3. Enable Work on a duplicate to keep the original for comparison.

After Upgrade complete, inspect the updated avatar, save the scene and upload again.

Keep the Face Tracking prefab linked

Keep the Installer's Face Tracking prefabs under the avatar and leave their prefab links intact. Avoid Unpack Prefab so the Installer can identify the installed content during upgrades.

Installer button states ​

ButtonMeaning and next step
InstallInstall the items in the change list.
UpgradeA legacy installation was detected. Review the list and upgrade.
InstalledThe installation is current. You can still check the mesh patch status.
Review requiredResolve the issues indicated in the window.
Open Legacy InstallerUse the legacy installer indicated for this Addon.

Frequently asked questions ​

Face Tracking Installer is missing

Wait for downloads and compilation, then check the Console for errors. Open TriturboFT › Face Tracking Installer in Unity's top menu.

The drop area does not accept my avatar

Drag the root with the VRC Avatar Descriptor from the Hierarchy and exit both Play Mode and Prefab Mode.

The avatar in VRChat still looks unchanged

Upload the avatar again after updating the package. If migrating from 1.x, first upgrade the legacy installation.