Rig e animazioni per un personaggio 3D in Godot 4: L’add-on AFK AI, AnimationPlayer e AnimationTree

1. Scarica l’add-on dalla pagina del plugin per Godot.
2. Copia la sua cartella addons/afk_ai nella cartella addons del progetto. Crea la cartella addons se il progetto non ce l’ha.
3. Apri Project > Project Settings > Plugins e spunta Enable accanto ad AFK AI.

A destra, accanto all’Inspector, compare un dock AFK AI.

1. Accedi. Fai clic su Sign in nel dock AFK AI. Il browser apre afk.ai; accedi con Google. Il dock mostra la tua email e quanti rig ti restano questo mese. Se il browser non riesce a tornare a Godot, mostra invece un codice di accesso: incollalo in I have a sign-in code e fai clic su Use.
2. Scegli il modello. Nel dock FileSystem, fai clic sul file del modello.
3. Scegli le opzioni. Body type: Human per le persone e tutto ciò che sta su due gambe, oppure l’animale o la creatura che è. Animations: All animations, o Rig only per il solo scheletro. Facing: lascialo su Auto.
4. Fai clic su Rig. Il dock mostra cosa sta succedendo: caricamento, attesa, rigging, download. Nel frattempo continua pure a lavorare.

Quando ha finito, hero_rigged.glb viene salvato accanto a hero.glb, importato e selezionato. L’originale resta intatto. Se rifai il rig dello stesso modello ottieni hero_rigged_2.glb, quindi niente viene sovrascritto.

Il personaggio giocante più semplice: un CharacterBody3D con una CollisionShape3D (una capsula), e sotto di esso il modello con rig trascinato dentro e rinominato Hero. Collega questo script al 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)

Avvialo: con i tasti freccia il personaggio corre in giro e, quando li lasci, torna dolcemente in idle. Chiamare play con l’animazione già in corso la lascia proseguire, quindi chiamarlo a ogni frame va bene.

Per mettere qualcosa in mano al personaggio, seleziona il suo Skeleton3D, aggiungici sotto un BoneAttachment3D, imposta Bone Name su hand_r e metti la spada sotto l’attachment. Seguirà la mano in ogni animazione.

Per cambiare quali animazioni vanno in loop, fai doppio clic su hero_rigged.glb nel dock FileSystem per aprire Advanced Import Settings. Scegli l’animazione sotto l’AnimationPlayer a sinistra, cambia Loop Mode e fai clic su Reimport.

Ogni rig che arriva ad AFK AI consuma uno dei rig di questo mese, come su afk.ai/rig e negli altri plugin AFK AI. Cancel interrompe l’attesa, non il rig, che viene comunque conteggiato. Un rig non riuscito non viene conteggiato. Quando hai finito i rig, il dock te lo dice e mostra See plans, che apre i piani di afk.ai.