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>
This commit is contained in:
parent
adf9fb706f
commit
b911f243be
1021 changed files with 152674 additions and 73 deletions
143
scripts/test/asset_pipeline_test.gd
Normal file
143
scripts/test/asset_pipeline_test.gd
Normal file
|
|
@ -0,0 +1,143 @@
|
|||
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(),
|
||||
]
|
||||
1
scripts/test/asset_pipeline_test.gd.uid
Normal file
1
scripts/test/asset_pipeline_test.gd.uid
Normal file
|
|
@ -0,0 +1 @@
|
|||
uid://dxyk7566apq3b
|
||||
Loading…
Add table
Add a link
Reference in a new issue