在 Unreal Engine 5 里自动绑定角色: 从静态网格体到带动画的骨骼网格体

1. 从 Unreal Engine 插件页面下载插件并解压，得到一个名为 AFKAI 的文件夹。
2. 把它放进项目的 Plugins 文件夹，和 .uproject 文件在同一级：MyGame/Plugins/AFKAI/AFKAI.uplugin。没有 Plugins 文件夹就新建一个。
3. 打开项目，或者重启项目。插件会启用 Unreal 自带的两个插件：Python Editor Script Plugin 和 Editor Scripting Utilities。如果 Unreal 要求重启，点同意。

编辑器的菜单栏里会出现 AFK AI 菜单。想在所有项目里都能用，就把文件夹放进 Unreal 安装目录下的 Engine/Plugins/Marketplace/AFKAI，然后在每个项目的 Edit > Plugins 里分别启用。

1. 选择 AFK AI > Sign in...。浏览器会打开 afk.ai，用 Google 账号登录，再回到 Unreal。AFK AI 菜单会显示你的邮箱和本月剩余的绑定次数。
2. 在 Content Browser 里右键点击网格体，选 Rig with AFK AI。（也可以选中它，再选 AFK AI > Rig the selected mesh...。）
3. 一个小窗口会让你选 Body type（Human，或者对应的动物、生物类型）、Animations（All animations，或者只要骨骼就选 Rig only）和 Facing（保持 Auto）。窗口标题会提示这次会消耗一次绑定次数。点 OK。
4. 继续干活就行。AFK AI 菜单会显示进度，Output Log 里以“AFK AI”开头的行也会显示。

如果浏览器回不到 Unreal（防火墙拦住了，或者 Unreal 在另一台电脑上），afk.ai 页面会显示一个登录码。选择 AFK AI > I have a sign-in code...，粘贴登录码，点 OK。

把 Hero_rigged 拖进关卡。在它的 Details 面板里，找到 Animation，把 Animation Mode 设为 Use Animation Asset，在 Anim to Play 里选一个动画（比如 Walk），保持 Looping 开启。点 Play，或者直接在视口里看。

想快速检查每个动画，就双击任意一个 Animation Sequence：动画编辑器会打开，并在角色上播放它。

有些动画会自带位移，让角色向前移动：名字以 _RM 结尾，比如 Roll_RM、Dodge_left_RM 或 Sword_Dash_RM。其余动画原地播放。Unreal 需要逐个动画开启根运动，而插件已经启用了 Unreal 的 Python，所以几行代码就能一次全部开启。把 Output Log 的命令行从 Cmd 切换到 Python，粘贴下面的代码：

import unreal

folder = "/Game/Characters"  # the folder Hero_rigged is in
for path in unreal.EditorAssetLibrary.list_assets(folder, recursive=False):
    anim = unreal.EditorAssetLibrary.load_asset(path)
    if isinstance(anim, unreal.AnimSequence) and anim.get_name().endswith("_RM"):
        anim.set_editor_property("enable_root_motion", True)
        unreal.EditorAssetLibrary.save_loaded_asset(anim)
        unreal.log("Root motion on: " + anim.get_name())

然后，如果要在状态机里播放这些动画，就在 ABP_Hero 的 Class Defaults 里把 Root Motion Mode 设为 Root Motion from Everything；或者把它们作为蒙太奇播放。

骨骼按 Mannequin 的骨骼命名，所以 Unreal 的重定向器几乎不用手动调整就能对应上。两个方向都行：把第三人称模板的动画用到你的角色上，或者把 afk.ai 的动画用到 Manny 和 Quinn 身上。

在 Unreal 5.4 及以上版本中：

1. 右键点击一个动画（比如模板里的某个动画），选 Retarget Animations（最新版本里叫 Retarget Animation Assets）。
2. 把 Target Preview Mesh 设为 Hero_rigged。源就是这个动画原本配套的网格体。
3. 保持 Auto Generate Retargeter 开启：Unreal 会自动生成 IK Rig 和 IK Retargeter。
4. 勾选想要的动画，点 Export Animations，选一个文件夹，再点 Export。

把源和目标对调，就能把 Hero_rigged 的动画用到 Mannequin 上。在 5.1 到 5.3 版本中，要为每套骨骼各建一个 IK Rig，再在它们之间建一个 IK Retargeter，然后用重定向器的 Export Selected Animations。不管哪种方式，正式使用前都先把几个结果完整播一遍，尤其注意手部。

每次请求到达 AFK AI 的绑定，都会消耗本月的一次绑定次数，和在 afk.ai/rig 及其他 AFK AI 插件里一样。Stop waiting 只是让 Unreal 不再等待：绑定不会停，照样计次。绑定失败不计次数，提示信息会说明原因。AFK AI 菜单会显示剩余的绑定次数；用完后，See plans 会打开 afk.ai 的套餐。