extends Node3D ## Verifikations-Szene der Asset-Pipeline (CR 23). ## ## Isolierter Prüfstand — bewusst OHNE Bezug zu einer Spiel-Szene: die ## Greybox-Primitiven im Hof, in der Sparringshalle und in der Aula ## bleiben unangetastet, bis diese Pipeline steht (CR 23, „explizit nicht ## Teil dieses CR"). ## ## Verifiziert wird die Rig-Kompatibilität der drei Charakter-Packs ## gegeneinander. Alle drei liefern denselben 65-Knochen-Rig im ## Unreal-Namensschema (root, pelvis, spine_01 … Head), deshalb lassen ## sich ihre Teile auf EIN Skelett legen: ## - Die Universal Animation Library stellt Skelett und AnimationPlayer ## (ihr eigenes Mannequin-Mesh wird ausgeblendet, nur der Rig zählt). ## - Der Universal-Base-Character liefert Körper, Augen und Brauen. ## - Das Fantasy-Outfit liefert die Kleidung. ## Alle Meshes werden auf das Skelett der Animation Library umgehängt. ## ## Steuerung: interact blättert durch die Animationsliste, der Rest läuft ## von allein. Ein sichtbarer Durchlauf zeigt einen bekleideten Charakter, ## der die gewählte Animation sauber abspielt. ## ## Bekannte Kosmetik der kostenlosen Pack-Variante (kein Pipeline-Fehler): ## Der Basis-Charakter ist EIN Mesh aus Kopf und Körper. Bleibt er sichtbar, ## stößt der Körper an bedeckten Stellen durch die Kleidung; blendet man ## ihn aus (is_base_body_visible = false), sitzt das Outfit sauber, aber ## das Gesicht fehlt — nur Augen und Brauen bleiben. Quaternius' eigenes ## Readme nennt den Weg: für die Kleidung wird nur der Kopf gebraucht, die ## verdeckten Körperteile gehören entfernt (spart auch Rechenzeit). Das ## ist ein Blender-Schritt und gehört in den späteren Austausch, nicht in ## diese Verifikation. const RIG_SCENE := preload("res://assets/models/characters/animations/ual1_standard.glb") const BASE_SCENE := preload("res://assets/models/characters/basis/superhero_male_full_body.gltf") const OUTFIT_SCENE := preload("res://assets/models/outfits/komplett/male_ranger.gltf") const HAIR_SCENE := preload("res://assets/models/characters/haare/hair_simple_parted.gltf") const SHOWCASE_ANIMATIONS := [ "Idle", "Walk", "Jog_Fwd", "Sprint", "Sword_Idle", "Sword_Attack", "Punch_Cross", "Roll", "Hit_Chest", "Sitting_Idle", "Dance", ] const BASE_BODY_MESH := "SuperHero_Male" @export var is_base_body_visible := true var _skeleton: Skeleton3D var _player: AnimationPlayer var _animation_index := 0 var _adopted_mesh_count := 0 @onready var _status_label: Label = $Ui/StatusLabel ## Baut die Testfigur beim Start zusammen und startet die erste Animation. func _ready() -> void: _build_figure() _play_current() ## interact blättert durch die Schau-Animationen. func _unhandled_input(event: InputEvent) -> void: if not event.is_action_pressed("interact"): return _animation_index = (_animation_index + 1) % SHOWCASE_ANIMATIONS.size() _play_current() ## Anzahl der auf den Rig umgehängten Meshes (für die Sonde). func get_adopted_mesh_count() -> int: return _adopted_mesh_count ## Das gemeinsame Skelett der Testfigur (für die Sonde). func get_skeleton() -> Skeleton3D: return _skeleton ## Der AnimationPlayer der Animation Library (für die Sonde). func get_animation_player() -> AnimationPlayer: return _player ## Setzt Rig, Körper, Haare und Outfit zu einer Figur zusammen. func _build_figure() -> void: var rig: Node3D = RIG_SCENE.instantiate() rig.name = "Figur" add_child(rig) _skeleton = rig.find_child("Skeleton3D", true, false) as Skeleton3D _player = rig.find_child("AnimationPlayer", true, false) as AnimationPlayer if _skeleton == null or _player == null: push_error("Animation Library liefert kein Skelett oder keinen AnimationPlayer.") return for child in _skeleton.get_children(): var mannequin := child as MeshInstance3D if mannequin != null: mannequin.visible = false _adopted_mesh_count += _adopt_meshes(BASE_SCENE.instantiate()) _adopted_mesh_count += _adopt_meshes(OUTFIT_SCENE.instantiate()) _adopted_mesh_count += _adopt_meshes(HAIR_SCENE.instantiate()) if not is_base_body_visible: var body := _skeleton.get_node_or_null(BASE_BODY_MESH) as MeshInstance3D if body != null: body.visible = false ## Hängt alle Meshes einer importierten Figur auf das gemeinsame Skelett ## um und liefert ihre Anzahl. Möglich, weil alle Packs denselben Rig ## teilen — die Skins binden über die Knochennamen. func _adopt_meshes(source: Node3D) -> int: add_child(source) var source_skeleton := source.find_child("Skeleton3D", true, false) as Skeleton3D if source_skeleton == null: source.queue_free() return 0 var meshes: Array[MeshInstance3D] = [] for child in source_skeleton.get_children(): var mesh := child as MeshInstance3D if mesh != null: meshes.append(mesh) for mesh in meshes: source_skeleton.remove_child(mesh) _skeleton.add_child(mesh) mesh.skeleton = NodePath("..") source.queue_free() return meshes.size() ## Startet die aktuell gewählte Animation und schreibt den Status. func _play_current() -> void: if _player == null: return var animation_name: String = SHOWCASE_ANIMATIONS[_animation_index] if not _player.has_animation(animation_name): push_error("Animation fehlt in der Library: %s" % animation_name) return _player.play(animation_name) _status_label.text = "%s (%d / %d) — E blättert weiter\n%d Meshes auf %d Knochen" % [ animation_name, _animation_index + 1, SHOWCASE_ANIMATIONS.size(), _adopted_mesh_count, _skeleton.get_bone_count(), ]