Риг и анимация 3D-персонажа в Godot 4: Аддон AFK AI, AnimationPlayer и AnimationTree

1. Скачайте аддон со страницы плагина для Godot.
2. Скопируйте его папку addons/afk_ai в папку addons вашего проекта. Если папки addons в проекте нет, создайте её.
3. Откройте Project > Project Settings > Plugins и отметьте Enable рядом с AFK AI.

Справа, рядом с Inspector, появится панель AFK AI.

1. Войдите. Нажмите Sign in в панели AFK AI. В браузере откроется afk.ai; войдите там через Google. Панель покажет ваш email и сколько ригов осталось в этом месяце. Если браузер не может вернуться в 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)

Запустите — и персонаж будет бегать трусцой по стрелкам, плавно возвращаясь к idle, когда вы их отпустите. Вызов play с уже играющей анимацией просто продолжает её, так что вызывать его каждый кадр можно.

Чтобы вложить что-нибудь персонажу в руку, выделите его Skeleton3D, добавьте внутрь BoneAttachment3D, установите Bone Name в hand_r и поместите меч внутрь этого узла. Он будет следовать за рукой во всех анимациях.

Чтобы изменить, какие анимации зациклены, дважды щёлкните hero_rigged.glb в панели FileSystem — откроется Advanced Import Settings. Выберите анимацию под AnimationPlayer слева, измените Loop Mode и нажмите Reimport.

Каждый риг, дошедший до AFK AI, расходует один риг из лимита этого месяца — так же, как на afk.ai/rig и в других плагинах AFK AI. Cancel прекращает ожидание, но не риг — он всё равно засчитывается. Неудачный риг не засчитывается. Когда риги закончатся, панель сообщит об этом и покажет See plans — кнопка открывает тарифы afk.ai.