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——错误从"被发现"变成"出不去"。

已知限制(写在这里,免得你踩)

许可证

MIT。可以商用、可以改、可以再分发,保留版权声明即可。

相关

全部免费工具 · 网站体检(免费先看 3 项) · 独立开发避坑库

隐私政策 · 服务条款 · 关于我们 · 联系我们 · 站点地图