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.

Main features

• 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
• Built-in FX Check wizard step that runs the gesture and eye-blink analysis on each generated avatar and applies guards in place
• FX Gesture Checker available from !Pawlygon/Tools/FX Gesture Checker — scans an avatar's FX AnimatorController for gesture-driven facial expression transitions (GestureLeft/GestureRight) and applies a FacialExpressionsDisabled guard so they do not fire when face tracking is active, and detects eye-blink layers to apply an EyeTrackingActive guard so blinking stops while eye tracking is active. Supports per-transition and per-layer guards, blink-layer confidence detection, work-on-copy mode, and full undo
• Patch Config Package Rules available from !Pawlygon/Tools/Patch Config Package Rules — adds per-config package requirements to existing PatcherHub FTPatchConfig assets. Auto-lists every config in the project for multi-select, auto-fills a rule from your installed packages (common avatar packages listed first) with pre-written missing/outdated messages, and supports full add/edit/reorder/remove plus batch-applying a rule to many configs at once
• Eye Muscle Settings available from !Pawlygon/Tools/Eye Muscle Settings — reads and adjusts the humanoid eye muscle limit settings (In, Out, Up, Down) on an avatar's ModelImporter for face tracking compatibility. Provides synced or split left/right sliders, live scene preview with bone rotation and blendshape activation, and writes changes back to the ModelImporter with a single click

Wizard workflow

The current workflow is built around a six-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. FX Check - analyze each avatar's FX controller for gesture-driven facial expressions and eye-blink layers, then apply FacialExpressionsDisabled and EyeTrackingActive guards
6. 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.

Diff generation

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.

Requirements

• Unity 2022.3 or later

Credits

• 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!

License

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

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

Links

• Website
• Discord
• YouTube
• X (Twitter)

---

Made with ❤ by Pawlygon Studio