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.glb 옆에 hero_rigged.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 플러그인에서와 똑같이 이번 달 리깅 횟수를 1회 차감해요. Cancel은 대기를 멈출 뿐 리깅을 멈추지는 않으니 횟수는 그대로 차감돼요. 실패한 리깅은 차감되지 않아요. 리깅 횟수를 다 쓰면 독에 그렇게 표시되고 See plans가 나타나요. 누르면 afk.ai 요금제가 열려요.