Frequently Asked Questions (FAQ)

Skinned mesh is corrupted after proper setup

Sometimes Unity's mesh metadata still contains incorrect data even after proper rig setup. This often happens with models downloaded from asset store and other third-party sources. In this case, full mesh reimport is needed. Navigate to the folder with the mesh fbx file and delete the corresponding metafile. I.e. if mesh is Assets/my_skinnedmesh.fbx, then Assets/my_skinnedmesh.fbx.meta file should be deleted and the whole rig setup process should be repeated.

Bone attachment visuals are looking corrupted

If your bone attachments are ordinary meshes, make sure that the shader used for their materials is not deformation compatible (it does not contain a Compute Deformation shader graph node).

GPU bone attachments disappear after assigning a special GPU attachment shader to it.

The GPU attachment shader must have access to the rig data. This is done by adding the GPUAttachmentAuthoring component to the GPU attachment GameObject in authoring mode. Without this component, GPU attachments will be placed incorrectly and can disappear completely. More info is on the Bone Attachments page.