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
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.Import into Unity
Drag the
.unitypackageinto 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.Place the avatar in the scene
Place the target avatar in the scene and exit Play Mode and Prefab Mode.
Open Face Tracking Installer
In Unity's top menu, select TriturboFT › Face Tracking Installer.
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.
Avatars
Salt
Airi
LimeEnglish
Face Tracking Framework· 1.1.0AvatarDrop your Avatar hereor pick one from the open sceneAddonDetected automatically from the Avatar.
Mesh PatchChecks the source FBX version and the blendshape patch.
ChangesA preview of everything that will be added or removed.
Review the installation
The Installer detects the matching Addon and lists the changes. Before installing, check the following:
English
Face Tracking Framework· 1.1.0
Avatar
Salt (VRC Avatar Descriptor)
1 Addonv2.0.0「ソルト」(Salt) Face Tracking Addon2 Mesh PatchFBXOriginalv1.0.1
Patchv1.1Will be appliedAdvanced3 Changes- + Install
Face Tracking SettingsSalt / Face Tracking / - + Install
Eye TrackingSalt / Face Tracking / - + Install
Mouth TrackingSalt / Face Tracking / - + Install
Mesh patch · Bodyv1.1 - + Install
Mesh patch · Kemono_Earv1.1
4 Expression ParametersCurrent usage67 bitsAdd new Prefab+14 bitsAfter installation81 / 256 bits- Addon should show the Addon you imported. Use Change… to select it manually if needed.
- Mesh Patch shows the avatar's FBX version on the left and the patch version on the right.
- Changes lists the prefabs and mesh patches to add to the avatar.
- Expression Parameters shows usage after installation. Stay within 256 bits.
- Enable Work on a duplicate to keep the original avatar and install on a copy.
- + Install
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:
- Back up the project and scene.
- Import the 2.x package for the same Addon.
- Open the Installer and drop in the avatar with the legacy Addon installed.
- 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.



Salt (VRC Avatar Descriptor)
Patchv1.1Will be applied- − Remove
Face Tracking Menu InstallerSalt / - − Remove
Eye Tracking HDSalt / - − Remove
Mouth Tracking HDSalt / - + Install
Face Tracking SettingsSalt / Face Tracking / - + Install
Eye TrackingSalt / Face Tracking / - + Install
Mouth TrackingSalt / Face Tracking / - + Install
Mesh patch · Bodyv1.1 - + Install
Mesh patch · Kemono_Earv1.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.
- Expression Parameters subtracts the usage freed by the old prefab (dashed segment) before adding 2.x usage.
- 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
| Button | Meaning and next step |
|---|---|
| Install | Install the items in the change list. |
| Upgrade | A legacy installation was detected. Review the list and upgrade. |
| Installed | The installation is current. You can still check the mesh patch status. |
| Review required | Resolve the issues indicated in the window. |
| Open Legacy Installer | Use 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.


Hierarchy

