如何 5 分钟上手 Ready Player Me Animation Library:从 Git LFS 克隆仓库到 Unity 播放动画完整教程

原创2026-11-16 23:56:331,902 阅读

如何 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 体型,可按需选用。

Ready Player Me 动画库 Unity 导入 TPose 骨骼 Rig 设置 Humanoid 选项

⚙️ 第 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 中让动画"跨角色通用"的关键一步:

  1. 将 masculine/fbx/Masculine_TPose.fbx 拖入 Unity 项目;
  2. 在 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 为例:

  1. 将 F_Dances_001.fbx 拖入 Unity;
  2. 在 Rig 选项卡中设置:
    • Animation Type = Humanoid
    • Avatar Definition = 第 2 步创建的 Avatar(例如 Masculine_TPose)

Ready Player Me 动画库 Unity FBX 动画导入 Rig 绑定 Avatar 设置界面

其余动画(走路、跑动、待机、表情等)按相同方式批量导入即可,各分类目录里都配有预览图,方便挑选。

🔁 第 4 步:配置动画循环与 Bake 设置

选中刚导入的动画,切换到 Animation 选项卡,推荐勾选以下三项:

  • Loop Time = True:仅对循环动画(走路、待机、跳舞)开启;
  • Root Transform Rotation: Bake Into Pose = True
  • Root Transform Position: Bake Into Pose = True

这两项 Bake 设置能避免角色播放动画时位置漂移,是 RPM 动画库在 Unity 中表现自然的重要细节。

Ready Player Me 动画库 Unity Animation 选项卡 Loop Time 与 Bake Into Pose 设置

🎮 第 5 步:创建 Animator Controller 并播放动画

  1. 在 Project 面板右键选择 Create > Animator Controller 新建动画控制器;
  2. 双击打开 Animator 编辑器,将导入的动画片段(Animation Clip)拖入作为起始状态。

Ready Player Me 动画库 Unity 创建 Animator Controller 动画控制器菜单

将 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。

Ready Player Me 动画库 Unreal Engine 骨骼创建 Animation Blueprint 菜单

❓ 常见问题 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/ 目录下自由取用!

登录后查看全文
animation-library