Im Auslieferungszustand kann Unity keine GLB-Dateien (glTF) importieren. Die 3D-Modellformate, die das offizielle Unity-Handbuch als nativ unterstützt aufführt, sind .fbx, .dae (Collada), .dxf und .obj; glTF und GLB stehen nicht auf dieser Liste (Quelle: Unity Manual - Model file formats, Stand Juli 2026). Um mit GLB zu arbeiten, fügst du über den Package Manager Unity glTFast (com.unity.cloud.gltfast) hinzu, ein offiziell von Unity bereitgestelltes Paket. Danach reicht es, eine GLB-Datei in den Assets-Ordner zu kopieren, und sie wird wie jedes andere 3D-Format importiert.
Dieser Artikel konzentriert sich ausschließlich auf die technischen Schritte, mit denen Unity eine GLB-Datei einliest. Das Gesamtbild, von der Umwandlung einer Illustration in ein 3D-Modell bis zur Realität von Rigging und Animation, findest du in 2D-Charakterillustrationen in Unity in 3D verwandeln: Umwandlung, Import und Voraussetzungen fürs Animieren. Wenn du den gesamten Workflow verstehen willst, lies zuerst diesen Artikel.
Hinweis: Mit Figmee kannst du derzeit aus hochgeladenen Zeichnungen und Illustrationen Bilder im Figuren-Stil sowie 3D-Modelldaten (GLB / 3MF) erzeugen und herunterladen. Der Verkauf physischer 3D-Drucke ist in Vorbereitung (Coming Soon).
Warum Unity GLB standardmäßig nicht einlesen kann
Unity ist so konzipiert, dass FBX als interner Importweg dient, und auch das offizielle Handbuch empfiehlt als Best Practice, nach Möglichkeit .fbx zu verwenden. glTF 2.0 dagegen ist ein von der Khronos Group festgelegtes Format für die schnelle Darstellung zur Laufzeit und im Web sowie in der Echtzeitdarstellung weit verbreitet. Da beide Formate unterschiedliche Ziele verfolgen, gehört glTF schlicht nicht zum Kern von Unity.
| Format | Native Unterstützung in Unity | Merkmale |
|---|---|---|
| FBX | Ja | Unitys interner Importweg. Stark bei der Übergabe von Animationen und Rigs |
| OBJ | Ja | Ein einfaches, auf die Geometrie ausgerichtetes Format. Materialien liegen in einer separaten Datei |
| DAE (Collada) | Ja | Ein XML-basiertes Austauschformat |
| DXF | Ja | Für den Austausch mit CAD-Programmen |
| glTF / GLB | Nein (über ein Paket nachrüstbar) | Kann Farben und Texturen in einer Datei bündeln und lässt sich leicht mit der Webdarstellung teilen |
Die Unterschiede im Charakter der einzelnen Formate erklären wir in OBJ, FBX, STL, GLB: Was ist der Unterschied? So wählst du das richtige 3D-Dateiformat. Wenn deine Daten bereits als GLB vorliegen, ist es am einfachsten, sie ohne Umwandlung direkt mit glTFast zu laden.
Unity glTFast installieren (etwa 3 Minuten)
Unity glTFast ist ein offizielles Paket von Unity, das auf Geschwindigkeit, Speichereffizienz und einen kleinen Build-Footprint ausgelegt ist. Es unterstützt die glTF-2.0-Spezifikation und zahlreiche Erweiterungen und läuft auf allen Plattformen sowie mit den Render-Pipelines Built-in, Universal (URP) und High Definition (HDRP) (Quelle: Unity glTFast Documentation, Stand Juli 2026, Version 6.17.0).
Die Installationsschritte laut offizieller Dokumentation sehen so aus (Quelle: Unity glTFast - Installation, Stand Juli 2026).
- Öffne dein Unity-Projekt und wähle
Window > Package Manager(20 Sekunden). - Klicke auf die Hinzufügen-Schaltfläche (+) in der Statusleiste (10 Sekunden).
- Wähle im Menü
Add + package by name(10 Sekunden). - Gib
com.unity.cloud.gltfastin das Feld Name ein (20 Sekunden). Achte auf Tippfehler. Diese ID gehört zum offiziellen Paket, nicht der Name aus dem früheren privaten Repository. - Klicke auf
Add(1 Minute). Die neueste Version wird automatisch abgerufen. Je nach Netzwerk kann das einige Minuten dauern.
Optionale Module je nach Einsatzzweck
In Kombination mit Unitys integrierten Paketen und zusätzlichen Paketen deckt glTFast mehr ab. Die offizielle Dokumentation nennt Folgendes:
- Image Conversion: Unterstützung für JPEG- / PNG-Texturen
- Unity Web Request Texture: Laden von Bildern über eine URI
- Animation: Wiedergabe von Animationen
- Physics: Erzeugen von Collidern
- Draco for Unity / KTX for Unity / meshoptimizer decompression for Unity: wenn du die entsprechenden glTF-Erweiterungen (Mesh- und Texturkompression) nutzt
Du musst nicht alles von Anfang an installieren. Es genügt, das passende Modul erst dann hinzuzufügen, wenn ein Symptom auftritt, etwa wenn Texturen nicht angezeigt werden oder sich eine komprimierte GLB-Datei nicht öffnen lässt.
Eine GLB-Datei importieren (etwa 2 Minuten)
Nach der Installation behandelst du GLB genauso wie jedes andere 3D-Format.
- Verschiebe oder kopiere die GLB-Datei in den
Assets-Ordner deines Projekts (30 Sekunden). Die offizielle Dokumentation erklärt, dass du glTF-Dateien wie andere 3D-Formate in den Assets-Ordner des Projekts verschieben oder kopieren kannst und Unity glTFast sie als native Unity-Prefabs importiert und zur Asset-Datenbank hinzufügt (Quelle: Unity glTFast - Editor Import, Stand Juli 2026). - Bei
.gltf-Dateien kopierst du die zugehörigen Dateien mit (30 Sekunden). Dieselbe Dokumentation stellt klar, dass du nicht vergessen darfst, die zugehörigen Buffer (.bin) und Bilddateien mitzukopieren, und dass Dateinamen und relative Pfade nicht geändert werden dürfen, da sonst Verweise brechen können. Eine.glbist in einer einzigen Datei gebündelt, dieses Problem entfällt also. Das ist einer der Gründe, warum bei der Übergabe von Daten oft GLB gewählt wird. - Wähle die Datei in der Project-Ansicht aus und sieh dir den Inspector an (1 Minute). Hier werden die Importeinstellungen sowie etwaige Warnungen und Fehler angezeigt. Wenn etwas anders geladen wird als erwartet, schau zuerst hier nach.
- Klappe die Datei in der Project-Ansicht auf (30 Sekunden). Die importierten Bestandteile werden als Scenes / Meshes / Materials / AnimationClips / Textures aufgelistet. Willst du ein einzelnes Mesh oder Material für ein anderes Objekt wiederverwenden, nimmst du es von hier.
- Zieh die Datei in die Szene, um sie zu platzieren (10 Sekunden). Das funktioniert genau wie bei einem normalen Prefab.
Zur Verknüpfung der Dateiendungen
Bei der Installation registriert sich glTFast als Standard-Importer für .gltf und .glb. Nach der Installation werden diese Endungen also ohne weiteres Zutun automatisch über glTFast geladen.
Wenn du bereits einen anderen glTF-Importer verwendest und es zu Konflikten kommt, kannst du die Registrierung von glTFast als Standard-Importer deaktivieren, indem du GLTFAST_FORCE_DEFAULT_IMPORTER_OFF zu den Scripting Define Symbols des Projekts hinzufügst. Wenn in einem Projekt mit mehreren glTF-bezogenen Assets das Importergebnis nicht deinen Erwartungen entspricht, prüfe zuerst, welcher Importer tatsächlich arbeitet.
Die erzeugten Sub-Assets verstehen
Die fünf Typen, die erscheinen, wenn du eine GLB-Datei in der Project-Ansicht aufklappst, haben jeweils eine eigene Rolle. Wenn du sie kennst, kannst du später schnell reagieren, wenn nur ein Teil wiederverwendet oder nur die Materialien ausgetauscht werden sollen.
| Sub-Asset | Inhalt | Typische Verwendung |
|---|---|---|
| Scenes | Die Hierarchie der Knoten | Das Hauptobjekt für die Szene. Normalerweise ziehst du dieses hinein |
| Meshes | Geometriedaten | Nur das Mesh für ein anderes Objekt wiederverwenden |
| Materials | Einstellungen für Farbe und Oberfläche | Shader austauschen oder an den Look des Projekts anpassen |
| Textures | Bilddaten | Kompressionseinstellungen und Auflösung an die Projektstandards angleichen |
| AnimationClips | Animationen | Erscheint nur, wenn die Ausgangsdaten Animationen enthalten |
Ist AnimationClips leer, ist der Import nicht fehlgeschlagen, sondern die ursprüngliche GLB-Datei enthält einfach keine Animation. Ein aus einer einzelnen Zeichnung erzeugtes 3D-Modell ist ein statisches Mesh, daher ist dieser Eintrag normalerweise leer.
Die unter Materials aufgeführten Materialien folgen der glTF-Kernspezifikation. glTF-Materialien bestehen aus Kanälen wie Grundfarbe, Metallic, Roughness, Ambient Occlusion, Normal Map und Emissive, und auf Unity-Seite werden sie den Shadern des Projekts zugewiesen. Wenn etwas metallischer wirkt als erwartet oder viel zu stark glänzt, musst du in der Regel an genau zwei Werten drehen: Metallic und Roughness.
Auch die anderen Optionen kennen
glTFast ist nicht der einzige Weg, mit glTF in Unity zu arbeiten. UnityGLTF, veröffentlicht von der Khronos Group (Stand Juli 2026), ist ein glTF-2.0-Loader und -Exporter für die Laufzeit in Unity und ebenfalls als Open Source verfügbar. Er ist eine starke Wahl, wenn dir Exportfunktionen wichtig sind oder ein bestehendes Projekt ihn bereits verwendet.
Es geht nicht darum, welcher besser ist. In der Praxis wählst du nach den Anforderungen deines Projekts: benötigte Erweiterungen, ob du exportieren musst, vorhandene Assets. Wenn ein neues Projekt nur importieren soll, ist glTFast einfacher einzurichten, da es als offizielles Unity-Paket über den Package Manager installiert wird.
Drei Dinge, die du nach dem Import prüfen solltest
Nur weil sich ein Modell laden lässt, heißt das nicht, dass es sofort einsatzbereit ist.
1. Materialien und Render-Pipeline
Das ist die häufigste Stolperfalle. glTFast unterstützt Built-in, URP und HDRP gleichermaßen, aber wenn die Pipeline des Projekts und die Shader der Materialien nicht zusammenpassen, erscheint das Modell komplett weiß, komplett schwarz oder magenta (pink). Magenta ist Unitys Standardanzeige, wenn ein Shader nicht gefunden wird. Siehst du diese Farbe, tippe zuerst auf eine nicht passende Pipeline. Prüfe außerdem, ob ein Licht in der Szene platziert ist.
2. Skalierung und Ursprung
Manchmal ist ein Charakter in dem Moment, in dem du ihn platzierst, riesig oder winzig klein. Das passiert, wenn die Ausgangsdaten nicht mit Blick auf reale Maße erstellt wurden, und ist kein Fehler. Passe es über Scale im Transform an oder lege die Größe relativ zum Boden oder zu vorhandenen Objekten fest. Wenn du in diesem Schritt auch den Ursprung prüfst (an den Füßen oder in der Körpermitte), wird das spätere Platzieren einfacher.
3. Flächenanzahl und Darstellungslast
KI-generierte Modelle und aufwendig ausgearbeitete Modelle können nach Echtzeitmaßstäben viele Flächen haben. Je mehr Flächen, desto höher die Last für Rendering und Verarbeitung, und je stärker du auf Mobilgeräte zielst, desto größer die Auswirkung (Was ist die Polygonanzahl? Was passiert, wenn sie hoch ist, Richtwerte je Einsatzzweck und wie du sie zählst). Orientiere dich daran, wie viele Charaktere gleichzeitig angezeigt werden, und reduziere bei Bedarf die Flächen in einem Tool wie Blender, bevor du neu importierst.
Tabelle zur Fehlerbehebung
| Symptom | Mögliche Ursache | Lösung |
|---|---|---|
| Nach dem Hinzufügen der GLB passiert nichts | Das Paket ist nicht installiert | com.unity.cloud.gltfast im Package Manager hinzufügen |
| Ein unerwarteter Importer läuft | Konflikt mit einem anderen glTF-Asset | Mit GLTFAST_FORCE_DEFAULT_IMPORTER_OFF umschalten |
| Das Modell erscheint magenta (pink) | Shader und Pipeline passen nicht zusammen | Durch Shader ersetzen, die zur Pipeline des Projekts passen |
Bei einer .gltf fehlen die Texturen | .bin- oder Bilddateien wurden nicht kopiert | Die zugehörigen Dateien mit denselben relativen Pfaden mitkopieren |
| Eine komprimierte GLB lässt sich nicht öffnen | Das Modul für die entsprechende Erweiterung fehlt | Die Pakete für Draco / KTX / meshoptimizer hinzufügen |
| Das Modell erscheint komplett schwarz | In der Szene gibt es kein Licht | Ein Licht platzieren und in der Materialvorschau prüfen |
| Es lässt sich nicht bewegen oder umposen | Es enthält keine Knochen | Rigging ist separat nötig (Was ist Rigging?) |
Häufige Fragen
Hat Unity einen eingebauten glTF- / GLB-Import?
Nein. Die Formate, die das offizielle Unity-Handbuch als nativ unterstützt aufführt, sind .fbx, .dae, .dxf und .obj. Um mit GLB zu arbeiten, fügst du über den Package Manager das offizielle Unity-Paket glTFast (com.unity.cloud.gltfast) hinzu. Danach ist es als Standard-Importer für diese Endungen registriert, sodass du GLB-Dateien von da an wie jedes gewöhnliche Asset behandeln kannst.
Ist es besser, vor dem Import nach FBX zu konvertieren oder die GLB direkt zu importieren?
Wenn du bereits eine GLB-Datei hast, sparst du dir mit dem direkten Laden über glTFast Arbeitsschritte, und Farben oder Texturen gehen seltener verloren. Wenn dein Team dagegen einheitlich FBX für die Übergabe nutzt oder ihr Daten mit Animationen austauscht, ist es durchaus sinnvoll, auf FBX zu setzen. Den Charakter des Formats erklären wir in Was ist eine GLB-Datei? Öffnen, Einsatzzwecke und Konvertierung einfach erklärt.
Kann ich GLB-Dateien auch zur Laufzeit (im Spiel) laden?
Ja. glTFast unterstützt nicht nur den Import im Editor, sondern auch das Laden zur Laufzeit. So lassen sich etwa Designs umsetzen, bei denen Modelle, die Nutzer mitbringen, in der App angezeigt werden. Asynchrones Laden und Fehlerbehandlung musst du allerdings selbst umsetzen. Am sichersten ist es deshalb, zuerst die Darstellung per Import im Editor zu prüfen und danach die Laufzeitunterstützung anzugehen.
Fazit
Die Arbeit mit GLB in Unity lässt sich auf drei Schritte bringen: (1) das offizielle Paket com.unity.cloud.gltfast über den Package Manager hinzufügen, (2) die GLB-Datei nach Assets kopieren, (3) im Inspector die Warnungen prüfen und das Modell in der Szene platzieren. Dass Unity GLB nicht nativ lesen kann, ist so vorgesehen; sobald ein einziges Paket installiert ist, ist alles Weitere Standardarbeit.
Wenn es hakt, liegt es fast immer am Zusammenspiel von Materialien und Render-Pipeline. Magenta deutet auf die Shader, komplett schwarz auf die Beleuchtung, fehlende Texturen auf die zugehörigen Dateien einer .gltf. Grenzt du es so ein, ist das meiste schnell gelöst. Wenn du das importierte Modell später auch bewegen willst, brauchst du zusätzlich Knochen und ein Rig. Sieh dir deshalb den gesamten Ablauf in 2D-Charakterillustrationen in Unity in 3D verwandeln: Umwandlung, Import und Voraussetzungen fürs Animieren an.
