Open source · MIT
rootmotion-check:出包前拦住"根节点与 hip 错位"
换皮或换体型之后动作"脚在飘",八成是 root motion 里 Root 与 Hips 的水平位移不一致。 肉眼对曲线不现实,这个脚本逐关键帧比一遍。
下载 zip(7 KB) 全部免费工具它能抓到什么
✗ bad.anim: 首帧不对齐 首帧 Δx=0.1200;全曲线最大 Δx=0.1200 ✗ drift.anim: 中途(t≈0.5) 首帧 Δx=0.0000;全曲线最大 Δx=0.0800 ← 只有全曲线检查能抓到 ✓ good.anim: 一致 首帧 0.0000;全曲线最大 0.0000
第二行是重点:首帧完全对齐、0.5 秒后偏 8 厘米。只比第一帧的检查会放它过去。
怎么用
unzip rootmotion-check.zip && cd rootmotion-check # 1) 检查(不需要你的工程,自带 selftest) python unity_rootmotion_check.py selftest python unity_rootmotion_check.py check --dir <含 .anim 的目录> # 2) 存档 / 校验 / 回滚(sha256 清单) python unity_rootmotion_check.py archive --params p.json --clips a.anim,b.anim --id gen-001 python unity_rootmotion_check.py verify --id gen-001 python unity_rootmotion_check.py rollback --id gen-001 --to <目标目录> # 3) 出包闸门:断言不过,物理上不产生 zip python gen_package.py --clips-dir <目录> --params p.json --id gen-002 --zip
为什么做成"闸门"而不是"报告"
检查脚本单独跑,看见了错还是可以打包。闸门的区别是: 不对齐时退出码非 0,且不会生成 zip——错误从"被发现"变成"出不去"。
已知限制(写在这里,免得你踩)
- 只认
Root/Hips命名,其他骨架要改parse_keyframes的匹配 - 按关键帧顺序配对,要求两条曲线关键帧数一致
- 文本级 YAML 解析,不做 Unity 序列化规范校验
许可证
MIT。可以商用、可以改、可以再分发,保留版权声明即可。