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, copies its FX controller into the avatar's VRChat/ folder, applies the guards to that copy and assigns it to the avatar
• 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 and work-on-copy mode. Guarded layers return to their default state once face or eye tracking stops
• 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
• Face Tracking Extras available from !Pawlygon/Tools/Face Tracking Extras — generates extra face tracking driven animations (ears, tail and pupils) from a handful of poses. Detects the ear and tail bone chains (skipping constraint helper bones), lets you pose Look Right/Up/Down, Sad, Happy, Happy Flick, Tail Right and Tail Happy on the avatar in the scene with live ear mirroring (Look Left and Tail Left are mirrored automatically), and previews how they blend, including the happy ear flick and tail wag loops. Generates baked clips, a 4-layer FX controller (each ear follows its own eye, mood from the average smile, a "Tail follows Jaw" toggle, and an improved fake pupil dilation that steps aside when real dilation is available), and a !Pawlygon - Face Tracking Extras VRCFury prefab in Prefabs/FaceTrackingExtras

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 (Packages/net.pawlygon.unitytools/hdiff/hdiffz/) is distributed under the MIT License.

Links

• Website
• Discord
• YouTube
• X (Twitter)

---

Made with ❤ by Pawlygon Studio