Humanoid Hand Retargeter
Released
Retarget hand and arm animations to custom FPS rigs with automatic mapping, weapon AnimGraph setup.
🎮 Game
A hand and arm animation retargeting library for FPS rigs. It parses FBX and DMX files, auto-detects hand bones from a table of 20 rig profiles, solves finger curl and wrist motion with quaternion math and two-bone IK, then bakes clips and writes Source 2 assets: DMX, vmdl KV3, .skel/.anim and AnimGraph2 .ag documents. It also ships runtime components (RetargetedWeapon, RetargetedWeaponController, WeaponMagazine) that drive a viewmodel and hands from an animation graph, plus reflection-based helpers for setting AnimGraph1 and AnimGraph2 parameters.
🔧 Editor
Search for the package to get its ident, then read the flagged files.
🐞 Possible Bugs
Code/Core/Validation/HandRigValidator.cs
If a hand has twist or helper bones mapped but all of its arm slots are empty, `arm[0]` in the helper loop throws IndexOutOfRangeException, so validation crashes instead of returning an issue.
Core/Validation/HandRigValidator.cs
arm is built by filtering out null arm bones, so a hand with only twist/helper bones mapped leaves arm empty and arm[0] throws IndexOutOfRangeException before any issue is reported.