Troubleshooting - Adjerry91/VRCFaceTracking-Templates GitHub Wiki

Intro

So VRCFT templates have a lot of moving parts to make the template animations work. In this troubleshooting guide will go over common symptoms of different issues of apply the templates to avatars.

Troubleshooting

Avatar face tracking is not working

1. Is VRCFT working?
   • Do other face tracking avatars work? Public Test Avatar World
2. How many parameters are loaded in the application?
   • If showing 0 parameters VRCFT is not loading the avatar parameters. Reset the OSC configs.
3. Take a look VRCFT Debug panel
   • Are the white circles (OSC Data) moving? If yes, OSC data from VRCFT is working!
   • Are the green dots (Blend shapes) moving? If no, blend shapes are not mapping to the avatar.
     1. Are the blend shapes named correctly per the standard and correct prefab is being used on the avatar? If no, correct the blend shapes and change the prefab.
     2. Is the mesh with the face tracking named "Body"? If no, see the Additional Setup - Non-Standard Mesh Names.

Facial Expressions Disable toggle is not working

1. The facial expressions disable toggle is not automatically applied to animators from VRCFury. You will need to modify the existing animator transitions to have the FacialExpressionsDisable toggle bool to conditions.
   • See Additional Setup - Modify Animators

Eyes rotating too far

1. Check if the eye look blend shapes are moving the eye.
   • If they are moving the eye then the eye rotation are being doubled. To remove doubling of rotation unpack and remove the "VF_EyeRotation" or "MA_EyeRotation" sub prefab.
2. Eye rotations are based off of the avatar rig configuration, NOT the avatar descriptor eye rotations. Change FBX rig configuration muscle settings for bone rotation adjustments.

Blend shapes are snapping to max values

1. Make sure you are not exporting vertex mask with the blend shapes from Blender. Unity will cause the blend shapes to snap to full value when vertex masks are applied.

Some blend shapes are not activating

1. Check if all the blend shapes are present and named correctly on the model
2. Test in Unity to perform more detailed debugging of blend shapes. See Testing in Unity guide.

Face tracking is only working local. Other users cannot see my face tracking.

1. Make sure they have your avatar shown. Face tracking templates are custom animations on the avatar.
2. Go to VRCFT > Settings > Remote Testing toggle. Then go to the VRCFT debug panel.
   • Are the remote smoothing green dots are moving? If not, reinstall the VRCFT - Jerry's package in the project. Template can get corrupted from updating on old versions.
   • If partial is moving then OSC data is not being sent correctly. Reset the OSC configs.

Eye tracking is not working but face tracking is working

1. Make sure the eye bones are assigned in the FBX rig configuration

Failed to upload

1. Make sure you are on VRCSDK 3.7.0+
2. Parameters may be going over the limits
   • Reduce parameters
   • Add VRCFury parameter compressor to reduce parameters used on the avatar
3. Avatar non-humanoid FBX error
   • Make sure the FBX rig is assigned correctly.
   • Reset the FBX rig

Native eye tracking and VRCFT eye tracking are mixing together

1. In VRChat check the Avatar Debug tracking states (Not VRCFT Debug and OSC Debug). When in VRCFT tracking the eye should be in "Animation" state.
   • If it is "Tracking" state the avatar is using the VRChat native face tracking and VRCFT eye tracking combined.
   • Check if the hand facial expressions have VRChat tracking states changes. Modify the animators to make sure tracking state does get applied with FacialExpressionsDisable

Face tracking ear control only is moving

1. Is your avatar from face tracking add-on/DLC?
   • If yes, all these addons have "Patcher" that unlocks custom model with face tracking. Make sure to run the patching step.
   • Some of these patchers will replace the base model while others will place the modified FBX in new folder. Make sure to use this FBX or override the mesh on the avatar.
2. Are the blend shapes named correctly per the standard and correct prefab is being used on the avatar? If no, correct the blend shapes and change the prefab.
3. Is the mesh with the face tracking named "Body"? If no, see the Additional Setup - Non-Standard Mesh Names.

Remote users cannot see Face tracking ear control

1. Raw data from VRCFT OSC cannot be used for custom animations i.e. FT/v2/...
   • Custom animations have to used the smoothed parameters i.e. OSCm/Proxy/FT/v2/...

Mini Guides

Resetting OSC Configs

• When uploading face tracking to existing model will break the OSC config, known VRChat bug. You can reset VRChat configs through VRCFT v5.
  • Alternatively you can delete the OSC folder in AppData/LocalLow/VRChat/VRChat https://docs.vrcft.io/docs/vrcft-software/vrcft#resetting-vrchat-osc-configs

Advance Troubleshooting

Post in #template-help for advance support on Jerry's Face Tracking Discord