Pawlygon Unity Tools

Unity Editor tools for Pawlygon's avatar face-tracking workflow.

This package helps you duplicate source avatar assets, prepare a working folder structure, swap updated meshes and the primary humanoid Animator rig from a modified FBX back onto a prefab, and generate .hdiff patch files for distribution.

• Guided Avatar Setup Wizard available from !Pawlygon/Avatar Setup Wizard
• Batch setup for one or many avatar entries in a single run
• Shared-folder or separate-folder output layouts depending on your project needs
• Automatic creation of working folders, copied FBX assets, copied prefabs, and working scenes
• Reimport detection for modified FBX files
• Review UI for matching FBX skinned meshes to prefab skinned meshes and replacing the prefab's primary humanoid Animator rig before applying replacements
• Automatic creation of FTDiffGenerator assets for patch generation
• .hdiff generation for both FBX and .meta changes using bundled hdiffz binaries
• Optional prefab helpers for Pawlygon VRCFT setup and importing the latest PatcherHub package

The current workflow is built around a five-step editor wizard:

1. Setup - choose source FBX/prefab assets, configure output folders, and create the working structure
2. Import Modified FBX - replace the copied FBX with your edited version and wait for Unity to reimport it
3. Select Replacements - review detected skinned mesh matches plus the primary humanoid Animator rig and choose which replacements to apply
4. Prefabs - optionally add Pawlygon VRCFT setup or import the latest PatcherHub unitypackage
5. Finish - review the generated paths and completed output

During setup, the wizard creates a working structure like this:

Assets/<MainFolder>/<AvatarName>/
  FBX/
  Prefabs/
  Internal/
    Scenes/

In shared-folder mode, multiple avatar entries can be placed into the same FBX/, Prefabs/, and Internal/Scenes/ structure.

The package includes FTDiffGenerator, an editor asset that compares the original FBX against the modified FBX and writes patch files into:

patcher/data/DiffFiles/

The generator creates:

• one .hdiff file for the FBX itself
• one .hdiff file for the FBX .meta

The wizard creates these generator assets for you automatically as part of the avatar setup flow.

• Unity 2022.3 or later

• Hash's EditDistributionTools — Inspiration for distribution workflows using binary patching
• hpatchz — High-performance binary diff/patch library by housisong
• tkya — Countless hours of technical support to the community
• VRChat Community — Feedback, testing, and feature requests

Thank you to everyone who helped make Pawlygon Unity Tools possible!

This project is licensed under CC BY-NC-SA 4.0.

HDiffPatch (hdiff/hpatchz/) is distributed under the MIT License.

• Website
• Discord
• YouTube
• X (Twitter)

Made with ❤ by Pawlygon Studio