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>
143 lines
5.4 KiB
GDScript
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(),
|
|
]
|