如何 5 分钟上手 Ready Player Me Animation Library:从 Git LFS 克隆仓库到 Unity 播放动画完整教程
如何 5 分钟上手 Ready Player Me Animation Library:从 Git LFS 克隆仓库到 Unity 播放动画完整教程
Ready Player Me Animation Library 是 Ready Player Me 官方开源的游戏级动捕动画库,收录 200 多套已重定向到 RPM 角色骨骼的高质量动捕动画(FBX 格式),可免费用于个人和商业项目。本教程带你完成从零到跑通的全流程:用 Git LFS 克隆动画库仓库,在 Unity 中导入 FBX、配置 Humanoid 骨骼绑定,最终让角色播放出走路、跳舞等动画。全程约 5 分钟,零基础也能跟着做。
📦 动画库内容概览:200+ 套动捕动画分类说明
仓库按角色体型(Feminine / Masculine)和动画类别组织,每个类别都包含对应性别演员采集的动作,并统一重定向到 RPM 骨架:
| 类别 | 说明 | 目录 |
|---|---|---|
| Locomotion 移动 | 走、跑、蹲行、跳跃等玩家/AI 常用位移动作 | feminine/fbx/locomotion/、masculine/fbx/locomotion/ |
| Dance 舞蹈 | 街舞等舞蹈动作 | feminine/fbx/dance/ |
| Idle 待机 | 站立呼吸、重心移动等待机循环 | feminine/fbx/idle/ |
| Expression 表情 | 说话、站立表情变化 | feminine/fbx/expression/ |
💡 文件名前缀代表采集演员的性别:
M_来自男演员,F_来自女演员,但都已重定向到两种 RPM 体型,可按需选用。
⚙️ 第 1 步:安装 Git LFS 并克隆动画库仓库
本仓库的 FBX 文件体积较大,官方使用 Git LFS(Git Large File Storage) 管理大文件,克隆前必须先安装 Git LFS,否则拉到的只是指针文本而非真正的动画文件。
在终端中依次执行:
# 1. 安装并初始化 Git LFS(只需执行一次)
git lfs install
# 2. 克隆 Ready Player Me Animation Library 仓库
git clone https://gitcode.com/gh_mirrors/an/animation-library
克隆完成后,你会得到 feminine/fbx/ 与 masculine/fbx/ 两棵完整的动画目录树。
🦴 第 2 步:导入 TPose 并创建 Humanoid 骨骼
打开你的 Unity 项目(2020 或更高版本),这是 Unity 中让动画"跨角色通用"的关键一步:
- 将 masculine/fbx/Masculine_TPose.fbx 拖入 Unity 项目;
- 在 Inspector 的 Rig 选项卡中设置:
- Animation Type = Humanoid
- Avatar Definition = Create from this model
这样 Unity 会基于该 TPose 生成一个 Humanoid Avatar,后续所有动画都可以挂到它身上。
🎬 第 3 步:导入动画 FBX 并绑定到 Avatar
以舞蹈动画 feminine/fbx/dance/F_Dances_001.fbx 为例:
- 将
F_Dances_001.fbx拖入 Unity; - 在 Rig 选项卡中设置:
- Animation Type = Humanoid
- Avatar Definition = 第 2 步创建的 Avatar(例如 Masculine_TPose)
其余动画(走路、跑动、待机、表情等)按相同方式批量导入即可,各分类目录里都配有预览图,方便挑选。
🔁 第 4 步:配置动画循环与 Bake 设置
选中刚导入的动画,切换到 Animation 选项卡,推荐勾选以下三项:
- Loop Time = True:仅对循环动画(走路、待机、跳舞)开启;
- Root Transform Rotation: Bake Into Pose = True
- Root Transform Position: Bake Into Pose = True
这两项 Bake 设置能避免角色播放动画时位置漂移,是 RPM 动画库在 Unity 中表现自然的重要细节。
🎮 第 5 步:创建 Animator Controller 并播放动画
- 在 Project 面板右键选择 Create > Animator Controller 新建动画控制器;
- 双击打开 Animator 编辑器,将导入的动画片段(Animation Clip)拖入作为起始状态。
将 Animator 组件挂到 Ready Player Me 角色身上即可播放动画。若需要在运行时动态加载 RPM 数字人并切换动画,guides/Unity-Guide.md 中提供了基于 AvatarLoader 的完整示例脚本,核心思路是:在 avatarLoader.OnCompleted 回调中,根据角色服装性别(OutfitGender)为其分配对应的 Animator Controller。
🛠️ 附:Unreal Engine 用户快速通道
如果你使用 Unreal(4.27+),流程类似:导入 TPose 生成 Skeleton → 动画导入时指定同一 Skeleton → 右键骨骼创建 Animation Blueprint 并编排状态机。详细步骤见 guides/Unreal-Guide.md。
❓ 常见问题 FAQ
这些动画真的免费吗? 是的。可免费用于个人和商业项目,但仅限配合 Ready Player Me 头像使用,且不可再分发或售卖,完整条款见 LICENSE.md。
为什么克隆下来是空文件 / 文本?
说明未安装 Git LFS。执行 git lfs install 后重新 git clone 即可。
这些动画能用在非 RPM 角色上吗? 官方明确说明动画专为 Ready Player Me 角色骨架设计,不建议用于其他角色。
🎉 完成以上 5 步,你就已经拥有了一套可直接上手的 Ready Player Me 动捕动画库:从 Git LFS 克隆仓库、导入 TPose 建立 Humanoid 骨骼,到循环配置与 Animator 播放,全部打通。更多分类动画可在 feminine/fbx/ 和 masculine/fbx/ 目录下自由取用!




