Usage Guide
Install the package
Add the U-Stella VPM repository to VCC or ALCOM.
Open the U-Stella VPM repository
Then add U-Stella FaceTracking to your Unity project from the package list.
Required packages are resolved through VPM.
Add the component
- Open the target avatar prefab or scene avatar in Unity.
- Select the avatar root, or a child object where you want to keep the settings.
- Add the
U-Stella/U-Stella FaceTrackingcomponent from the Inspector. - Assign a
SkinnedMeshRendererwith face-tracking blend shapes toFace Mesh Renderer.
Select tracking devices
Use Tracking Hardware to select the face-tracking devices you want the avatar to support.
You can select more than one device.
The support status shows how each facial expression is handled by the selected devices.
| Status | Meaning |
|---|---|
| Fully Supported | The device can output that expression directly. |
| Converted | The expression can be produced through conversion, emulation, merged left/right values, or module-side processing. |
| Unknown | Public information is not enough to confirm support. |
| Unsupported | Support has not been confirmed. |
Configure features
In Feature Settings, choose how each facial feature should be used.
This includes eyes, eyelids, brows, mouth, tongue, and related face-tracking features.
| Item | Description |
|---|---|
| Feature | The facial feature being configured. |
| Device | Shows whether the selected devices support the chosen output format. |
| Output Format | Selects how the feature should be represented, such as separate left/right values or a shared value. |
| Sync Mode | Selects how the feature should be synchronized. |
Use the sync cost display at the bottom of the Inspector to check the current parameter usage.
Upload and refresh the OSC configuration
After adding, removing, renaming, or changing the type of generated face-tracking parameters, upload the avatar and refresh its OSC configuration in VRChat.
- Publish the updated avatar.
Build & Testsupports OSC, but it does not create the OSC configuration file used for normal VRCFaceTracking parameter detection. - Equip the published avatar in VRChat.
- Open the Action Menu and select
Options > OSC > Reset OSC Config. - Reload the avatar, then verify that VRCFaceTracking detects the expected parameters in Avatar Status.
Repeat these steps whenever an upload changes the avatar parameters. Otherwise, VRCFaceTracking may continue using an older parameter list or type definition.
Assign blend shapes
Use Blend Shape Assignments to map each face-tracking expression to a blend shape on your face mesh.
- Set
Face Mesh Renderer. - Select the matching blend shape for each expression.
- Adjust
Max Valuewhen needed. Values are in the0to100range. - Expressions that are not used by the current feature settings are disabled.
If a blend shape has the same name as an expression, it may be filled automatically when the face mesh is assigned. If a missing blend shape name remains in the settings, it is shown as an invalid value in the Inspector.