windgeschworen/scripts/test/asset_pipeline_test.gd
danny b911f243be CR 23: Asset-Grundausstattung importiert und Pipeline verifiziert
Fuenf CC0-Packs von Quaternius entpackt, sortiert und in Godot importiert.
Alle fuenf License_Standard.txt bestaetigen CC0 1.0 — CREDITS.md fuehrt sie
mit Quelle, Lizenz und Zielordner.

296 Modelle als glTF unter assets/models/: characters/basis (2) und
characters/haare (8), characters/animations (2 glb mit 43 Animationen, mit
und ohne Root Motion), outfits/komplett (4) und outfits/teile (20), props
(94, thematisch sortiert), environment (166, nach Bauteil-Art). Zehn
redundante Dach-Groessenvarianten blieben draussen; 4x4, 6x6 und 8x8 stehen
stellvertretend.

tools/import_quaternius.py macht den Vorgang reproduzierbar: es entpackt
selektiv die glTF-Zweige, bringt Dateinamen auf snake_case und schreibt
dabei die relativen URIs in den .gltf-Dateien mit — ohne das waeren Buffer-
und Texturverweise nach dem Umbenennen tot. Texturen liegen einmal pro Pack
unter <pack>/textures/. Zwei kaputte Verweise im Quell-Pack korrigiert:
T_Hair_1_Normal_png.png und T_Eye_Normal_png.png existieren bei Quaternius
nicht, dort fehlt das _png.

Der eigentliche Punkt ist die Rig-Kompatibilitaet: Basis-Charaktere, Outfits
und Animationsbibliothek liefern dasselbe 65-Knochen-Skelett im
Unreal-Namensschema, Knochenliste identisch. scenes/test/asset_pipeline_test
legt darum Koerper, Ranger-Outfit und Frisur auf das Skelett der Animation
Library — 13 Meshes auf 65 Knochen — und spielt elf Schau-Animationen ab.

Keine bestehende Szene angefasst: der Primitiven-Austausch ist laut CR 23
ausdruecklich ein eigener Folge-Schritt und steht jetzt als CR 24 in
CHANGEREQUESTS.md, zusammen mit dem noetigen Trimmen der Basis-Koerper und
der offenen Entscheidung ueber die 4K-Outfit-Texturen.

Verifiziert mit dev_cr23_probe (25/25) und einem Boot-Check ueber zwoelf
Szenen — Hof, Sparringshalle, Aula, Schlafsaal, Gauntlet, Viadukt und
Kampf-Testground alle unveraendert lauffaehig. Sonden vor dem Commit
geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 18:00:57 +02:00

143 lines
5.4 KiB
GDScript

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(),
]