在 Godot 4 里绑定 3D 角色并配上动画: AFK AI 插件、AnimationPlayer 和 AnimationTree

1. 从 Godot 插件页面下载插件。
2. 把其中的 addons/afk_ai 文件夹复制到项目的 addons 文件夹里。项目里没有 addons 文件夹就新建一个。
3. 打开 Project > Project Settings > Plugins，勾选 AFK AI 旁边的 Enable。

右侧 Inspector 旁边会出现 AFK AI 面板。

1. 登录。 在 AFK AI 面板里点 Sign in。浏览器会打开 afk.ai，在那里用 Google 账号登录。面板会显示你的邮箱和本月剩余的绑定次数。如果浏览器回不到 Godot，它会改为显示一个登录码：粘贴到 I have a sign-in code 下面，点 Use。
2. 选模型。 在 FileSystem 面板里点选模型文件。
3. 选选项。 Body type：人物和所有两条腿走路的角色选 Human，动物或生物就选对应的类型。Animations：选 All animations，或者只要骨骼就选 Rig only。Facing：保持 Auto。
4. 点 Rig。 面板会显示当前进度：上传、等待、绑定、下载。这期间可以继续干活。

完成后，hero_rigged.glb 会保存在 hero.glb 旁边，已导入并选中。原模型不做任何改动。同一个模型再绑定一次会得到 hero_rigged_2.glb，不会覆盖任何东西。

最简单的玩家角色：一个 CharacterBody3D，带一个 CollisionShape3D（胶囊体），把绑定好的模型拖到它下面，重命名为 Hero。给 CharacterBody3D 挂上这个脚本：

extends CharacterBody3D

const SPEED := 4.0
var gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")

@onready var hero: Node3D = $Hero
@onready var anim: AnimationPlayer = $Hero/AnimationPlayer

func _physics_process(delta: float) -> void:
	var input := Input.get_vector("ui_left", "ui_right", "ui_up", "ui_down")
	var direction := Vector3(input.x, 0.0, input.y)
	velocity.x = direction.x * SPEED
	velocity.z = direction.z * SPEED
	if not is_on_floor():
		velocity.y -= gravity * delta
	move_and_slide()

	if direction.length() > 0.1:
		# the model faces +Z: turn that toward where it's going
		hero.rotation.y = lerp_angle(hero.rotation.y, atan2(direction.x, direction.z), 10.0 * delta)
		anim.play("Jog", 0.2)   # 0.2 s blend from whatever was playing
	else:
		anim.play("Idle_A", 0.2)

运行后，用方向键就能让角色四处慢跑，松开按键后会平滑地回到待机。对正在播放的动画再调用 play，它会接着播放，所以每帧都调用也没问题。

想让角色手里拿东西，就选中它的 Skeleton3D，在下面添加一个 BoneAttachment3D，把 Bone Name 设为 hand_r，再把剑放到这个挂点下面。剑会在所有动画里跟着手走。

想修改哪些动画循环，就在 FileSystem 面板里双击 hero_rigged.glb，打开 Advanced Import Settings。在左侧 AnimationPlayer 下选中动画，修改 Loop Mode，再点 Reimport。

每次请求到达 AFK AI 的绑定，都会消耗本月的一次绑定次数，和在 afk.ai/rig 及其他 AFK AI 插件里一样。Cancel 只是停止等待，绑定本身不会停，照样计次。绑定失败不计次数。次数用完后，面板会提示你，并显示 See plans，点击打开 afk.ai 的套餐。