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に届いたリギングは、1回ごとに今月のリギング回数を1回分使います。afk.ai/rigやほかのAFK AIプラグインと同じです。Cancelは待機を止めるだけで、リギングは止まらず、回数にもカウントされます。失敗したリギングはカウントされません。回数を使い切ると、ドックにその旨とSee plansが表示され、afk.aiのプランを開けます。