Eine Animation in Godot 4 importieren

Was das Paket enthält

Exportiere godot_pack für spritesheet.png, animation.tres, animation.tscn, animgen-manifest.json und README in einem benannten Stammordner.

Die .tres ist eine Godot-4-SpriteFrames-Ressource aus AtlasTexture-Rechtecken. Die .tscn enthält eine AnimatedSprite2D mit dieser Ressource, automatischer Wiedergabe und drehpunktabhängigem Versatz. Das ist keine Godot-3-AnimatedSprite-Ressource.

Den Stammpfad beibehalten

Entpacke und kopiere den benannten Stammordner direkt ins Godot-Projektverzeichnis. Die README nennt den erwarteten Pfad res://<exported-folder>/.

Die erzeugten Ressourcenpfade verwenden diesen Ordnernamen. Nur animation.tres zu verschieben, den Stammordner umzubenennen oder ohne angepasste Verweise tiefer zu verschachteln kann fehlende Texturen oder Ressourcen verursachen.

Warte auf den PNG-Import durch Godot. Öffne dann animation.tscn oder instanziiere sie in einer kleinen Testszene.

Fertige Szene oder bestehenden Knoten nutzen

Am schnellsten verwendest du die gelieferte Szene. Bei einer vorhandenen AnimatedSprite2D weise animation.tres unter Sprite Frames zu, wähle die exportierte Animation und konfiguriere die Wiedergabe.

Godots Anleitung zu 2D-Sprite-Animation erläutert AnimatedSprite2D, SpriteFrames, Wiedergabe und FPS. Die AnimGen-Ressource enthält Frames, Loop-Flag und Geschwindigkeit bereits; erneutes PNG-Zerschneiden ist unnötig.

Nur die SpriteFrames-Ressource zuzuweisen kopiert nicht den Versatz der Szene. Übernimm für einen nicht zentrierten Drehpunkt auch deren Versatz oder konfiguriere den entsprechenden Ursprung am vorhandenen Knoten.

Timing und Ausrichtung prüfen

Vergleiche Frame-Anzahl und FPS mit animgen-manifest.json. Prüfe, ob Elterntransformation oder Skript Geschwindigkeit oder Position verändern. Spiele mindestens einen vollständigen Loop und vergleiche Bodenposen mit einer festen Linie.

Zeigt der Knoten nichts, prüfe zuerst Meldungen zu fehlenden Ressourcen, Texturimport, ausgewählte Animation, Sichtbarkeit und Platzierung. Bei falschen Frames stelle sicher, dass Textur und .tres aus demselben Export stammen.

Bei abweichenden Kanten prüfe Texturfilter und Rendering mit demselben PNG als Vergleich. Siehe transparente Formate.

Sicher wiederverwenden

Behalte Namen und Pfade möglichst bei. Beim Umorganisieren aktualisiere Texturpfad in animation.tres und Ressourcenpfad in animation.tscn gemeinsam, öffne erneut und teste.

Ein bestandener Paketgenerierungstest ist kein Laufzeittest deines Godot-Projekts. Prüfe einen kleinen Import, bevor du Gameplay integrierst oder auf ein Zielgerät exportierst.

Das getestete Beispiel reproduzieren

Der Godot-4-Import-Praxistest dokumentiert einen echten Import- und Wiedergabetest mit Godot 4.7.2. Er enthält öffentliches Paket, herunterladbares Minimalprojekt, Laufzeitaufnahme und genaue Testgrenzen. Nutze ihn als Beispiel und wiederhole die Prüfungen mit deinem Export und deiner Zielumgebung.