Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

In dein Spiel exportieren

Alles, was aus einer Zeichnung herauskommt, hat ein eigenes Kärtchen im Bereich Export: das Modell für dein Spiel, das gleiche Modell für einen Editor oder einen Drucker, und vier Bilder. Erreichbar vom Kachel Export im Einrichtungsfeld, oder tippe die Titelleiste eines Bereichs darauf.

Strg+E exportiert das Modell und Strg+Umschalt+E die Grafik, ohne etwas zu öffnen.

Exporte liegen im Projektordner, also haben sie nirgendwohin zu gehen, bis das Projekt eins hat. Bis dahin ist jeder Button hier inaktiv, mit der Begründung in einem Hinweis.

Was landet in einer

Eine Ebene, die du verborgen hast, ist in keiner dieser Dateien — nicht das Modell, nicht ein Bild. Der Haken im Ebenenbaum wird mit dem Projekt gespeichert, also bedeutet es morgen das gleiche wie jetzt, und alles, das hier geschrieben wird, ehrt es.

Ein Solo ist anders und hält vor einer Modell-Datei an. Es ändert, was du anschaust — die 3D-Ansicht, die Strichzeichnung, jedes Bild davon — aber .glb, .bbmodel, .obj und .stl werden aus jeder gehakten Ebene gebaut, egal. Solo wird nicht mit dem Projekt gespeichert, also würde eine Modell-Datei, die es honöriert, morgen anders aus der gleichen Zeichnung herauskommen, mit nichts in der Zeichnung zu sagen, warum.

Eine verblasste Ebene kommt fest heraus, überall außer der Kunstwerk-PNG — und dort nur, weil diese Datei die 2D-Leinwand ist, die hinausgeschrieben wird. Siehe Ebenen und Tiefe.

Die Kärtchen

3D-Modell

<prefix>.glb und <prefix>.meshes.json — das extrudierte Modell und die Begleitdatei, die seine Teile benennt, bereit für ein Spiel zum Laden. Das ist, wofür die App existiert.

Die .glb enthält das Gitter, einen eingebetteten PNG-Atlas und eine Knotenhierarchie von sprite → layer → island.

Die Begleitdatei existiert, weil raylibis Model keine Mesh-Namen hat, nur ein Meshes-Array. Sie ordnet Index zu Insel, damit du “das Schwert” in einem Modell ohne Zählen finden kannst. Inselnamen werden pro Ebene nummeriert, also suche Teile nach path ("face/part_1") statt nach bloßem Namen.

Unbeleuchtetes Material ist der eine Schalter der Karte. An teilt die Datei jedem, der sie öffnet, mit, deine Farben genau wie gemalt zu zeichnen — keine Beleuchtung, keine Schatten — das ist so wie Flattys eigene 3D-Ansicht sie zeigt. Blender ehrt das, und so tut es jede Engine, die unbeleuchtetes glTF versteht; raylib hat nie davon gehört und beleuchtet das Modell wie immer, darum kostet der Schalter ein raylib-Spiel nichts. Es ist eine Voreinstellung statt einer Projekteinstellung: es sagt, wie eine Engine die Datei beleuchten sollte, und ein Spiel will die gleiche Antwort für jeden Export.

Für Editoren

Das gleiche Modell für jemanden, der weiter daran arbeiten möchte.

Für Blockbench export. (BBMODEL) schreibt <prefix>.bbmodel, ein Blockbench-Projekt, das sich ohne Importer und ohne Plugin öffnet: jede Ebene eine Gruppe, jedes Teil ein Maschengitter von Vierecken, die Textur in der Datei. Nutze das, wenn Blockbench das Ziel des Modells ist — es ist die einzige Route, auf der nichts unterwegs geraten wird.

3D-Modell export. (OBJ) schreibt drei Dateien, die nur zusammenarbeiten:

DateiIst
<prefix>.objdie Geometrie als Vierecke
<prefix>.mtldie Materialsdatei, die die .obj nennt
<prefix>.atlas.pngdie Textur, die das Material nennt

Lösche eine der Begleitdateien und das Modell wird ohne Textur importiert — so funktioniert OBJ, und jedes Programm, das es liest, erwartet die drei nebeneinander.

In Blender stelle die Textur auf Nächster. Ein OBJ hat keinen Weg, Nächster-Nachbar-Abtastung zu verlangen, darum lässt Blenders Importer das Bild auf Linear und ein kleiner Atlas verschwimmt über die Flächen, mit einer dunklen Kante um jede, wo die Kante eines Pixels mit der Transparenz daneben gemittelt wird. Wähle das Material, finde den Bild-Texture-Knoten und ändere Interpolation auf Nächster; der Unschärfe und die Kante gehen zusammen. Der Hinweis des Knopfes sagt das Gleiche, da die Datei nicht kann.

3D-Druck

Für den Druck export. (STL) schreibt <prefix>.stl: das Modell als ein geschlossener Körper, fertig für einen Slicer, bei ein Millimeter pro Pixel — ein 32-Pixel-Sprite kommt 32 mm breit an. Px / Einh. gilt hier nicht; es sagt, wie groß das Modell in einer Spielewelt ist, nicht auf einem Schreibtisch.

Ebenen, die sich überlappen oder ineinander sitzen, kommen als ein Körper heraus, mit nichts mehr innen — ein Drucker braucht eine einzelne wasserdichte Oberfläche, und das ist, was das schreibt. Der Körper ist in jedem Betrachter weiß, weil STL nur Geometrie trägt, und es steht, wo der Drehpunkt es hinlegt: Unten Mitte legt den tiefsten Punkt auf dem Boden ab, Mitte im Bereich Projekt zentriert es stattdessen.

Grafik

<prefix>.png — die 2D-Leinwand wie gemalt, flach zusammengesetzt, in ihrer eigenen Pixelgröße. Das Sprite, in anderen Worten.

Strichzeichnung

<prefix>.svg und <prefix>.vector.png für dieselbe Zeichnung gerastert.

Der Renderer und der Stil leben in der Vektor-Leiste — dieses Kärtchen schreibt nur das, wozu diese Leiste eingerichtet ist. Bildgröße ist die lange Kante des PNG; das SVG ist eine Vektordatei und hat keine Pixelgröße.

3D-Ansicht

<prefix>.view.png — ein Foto der 3D-Ansicht in diesem Arbeitsbereich, ohne den Boden darunter. Das Bild ist das Modell; ein Boden gehört zu deinem Arbeitsbereich statt zum Ding, das du exportierst.

BedienelementTut
Bildgrößedie lange Kante
Formdie gleiche Form wie die Ansicht oder eine feste. Die Kamera schaut um einen festen Betrag auf und ab, also entscheidet die Form, wie viel an den Seiten sichtbar ist
Transparenter Hintergrundstandardmäßig an — das Modell allein, mit nichts dahinter, das auf eine Storepage oder ein README ohne Rechteck darum passt

Das Kärtchen sagt, welche 3D-Leiste es verfolgt, und wenn es in diesem Arbeitsbereich keine 3D-Ansicht gibt, hält es den letzten Winkel statt zu verweigern.

Es gibt einen Kamerataste auf der 3D-Leiste selbst, die dasselbe Bild schreibt, was normalerweise der kürzere Weg ist: du richtest den Schuss ein, dann machst du ihn.

Ein durchscheinendes Modell über nichts composites gegen Transparenz, also kommt Lam::pulas Glas dunkler heraus, als es in der Leiste aussieht, die zu einem undurchsichtigen Hintergrund führt. Den Hintergrund einzuschalten ist die Antwort, und deshalb ist es ein Schalter statt einer Tatsache.

Teilen

Zum Teilen verpacken… — siehe unten.

Eine Aufzeichnung landet auch hier. Die Recorder-Leiste schreibt ihre GIFs und Videos in denselben exports-Ordner unter ihren eigenen Namen — siehe Aufzeichnung. Es hat seine eigene Größe, denn ein Film bezahlt für seine Größe auf jedem Frame, wo ein Bild einmal bezahlt.

Alles wird zweimal geschrieben, absichtlich

fluffy cloud/
  exports/
    2026-08-21_144312_fluffy_cloud.glb    kept forever, never overwritten
    2026-08-21_144312_fluffy_cloud.meshes.json
    latest/
      fluffy_cloud.glb                    replaced by every export
      fluffy_cloud.meshes.json

Das Archiv verhindert, dass ein Export den vorherigen zerstört. Die stabile Kopie ermöglicht es deinem Spiel, einen Pfad hartcodiert zu setzen, der sich nicht jedes Mal ändert, wenn du den Button drückst.

Stelle rl.LoadModel auf exports/latest/.

Beide Kopien sind das gleiche Modell. Der Szenenname, der Wurzelknoten und der Atlas alle nehmen das Projektpräfix — absichtlich nicht den Dateinamen — also sieht ein Verbraucher, der den Szenenamen liest, keine Änderung, weil ein Zeitstempel sich änderte. Die Begleitdatei ist das eine, das sich unterscheidet: jede Kopie benennt die .glb, die daneben sitzt.

Ordner anzeigen öffnet den Exportordner in deinem Dateimanager, und Ordner danach anzeigen tut dies bei jedem Export, mit der Datei, die es gerade geschrieben hat, hervorghoben, wo dein Desktop das kann.

Präfix

Das Präfix-Feld ist, wie die Exportdateien heißen. Es folgt dem Projektnamen automatisch, bis du es selbst bearbeitest, woraufhin es aufhört zu folgen — die Dateien von jemandem stillschweigend umzubenennen ist schlimmer, als die beiden auseinanderzulassen. Das Kärtchen sagt, welches der beiden geschieht.

Der Slug, der einen Namen in ein Präfix umwandelt, faltet Akzente statt sie zu löschen: Zażółć wird zazolc, nicht z.

Drehpunkt und Skalierung

Beide befinden sich in der Projekt-Leiste, unter Weltplatzierung.

Px / Einheit stellt die Skalierung ein: bei 16 wird ein 64-Pixel-Sprite zu 4 Welteinheiten.

Der Drehpunkt verzweigt sich standardmäßig zu unten-Mitte, also DrawModel(m, pos, ...) die Füße eines Charakters auf pos.

Zeichne deinen Charakter an den unteren Rand der Leinwand. X und Y kommen von der Leinwand, nicht von den engen Grenzen der Grafik. Das ist absichtlich: Animationsframes müssen einen gemeinsamen Ursprung haben, und enge Grenzen würden es jeden Mal verschieben, wenn sich die Silhouette änderte.

Es in raylib laden

m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")

// Die eine Zeile, die du hinzufügen musst. Die Datei verlangt Nearest-Neighbour-
// Filterung in ihrem glTF-Sampler, aber raylibs Loader wendet glTF-Sampler nicht
// an — ohne das kommen deine Pixel geglättet heraus.
for _, mat := range m.GetMaterials() {
    if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
        rl.SetTextureFilter(tex, rl.FilterPoint)
    }
}

rl.DrawModel(m, playerPos, 1, rl.White)  // der Drehpunkt ist fest eingebaut

Das ist die ganze Integration. Keine Konvertierung, keine Importeinstellungen, kein Material zum Neuaufbau.

Die .glb in Blender öffnen

Wenn das Modell grau importiert wird, wechsle das Ansichtsfenster aus der Volltonschattierung — drücke Z und wähle Material-Vorschau, oder klicke auf die dritte Kugel oben rechts im 3D-Ansichtsfenster.

Blenders Standard-Volltonmodus ignoriert Materialien vollständig und zeigt jedes Gitter in flachem Grau, was identisch mit einem Modell aussieht, das wirklich keine Textur hat. Die Datei ist in Ordnung.

Ein helleres Band, das diagonal über das Modell läuft, ist Blenders Beleuchtung, nicht deine Textur. Material Preview beleuchtet das Modell aus einer Studio-Umgebung und lässt die vordere Ebene einen Schatten auf die Ebene dahinter werfen; das Band ist der Streifen, der nicht im Schatten ist, und es überquert mehrere Flächen als eine gerade Linie, was keine Textur könnte. Wechsel zu Solid-Schattierung mit Beleuchtung: Flach und es ist weg. Besser, schalte Unbeleuchtetes Material vor dem Exportieren ein: Blender zeichnet dann die Farben wie gemalt, genau wie der 3D-Bereich.

Blockbench öffnet die .glb über sein glTF-Plugin, und der Export ist so angeordnet, dass es funktioniert; die .bbmodel ist immer noch die bessere Tür, weil sie als Vierecke mit ihren Ebenen bereits gruppiert ankommt.

Transparenz

Wenn ein Texel im Atlas halbtransparent ist, wird das Material mit alphaMode: "BLEND" geschrieben. Wenn keins ist, wird überhaupt kein alphaMode-Schlüssel geschrieben und das Modell verhält sich genau wie ein undurchsichtiges. Der Schalter Unbeleuchtetes Material ändert keinen: er nimmt die Beleuchtung weg und lässt die Transparenz genau wie sie war.

Siehe Farbe warum, und was Mischen kostet.

Ein Projekt zum Versenden packen

Zum Teilen verpacken… fragt nach einem neuen, leeren Ordner und kopiert das Projekt darin zusammen mit jedem Bibliotheks-Asset, das es benutzt — die Texturen und Paletten, die sonst in deinen Ordnern statt im Projekt leben. Zippe diesen Ordner und es ist eine vollständige Übergabe. Siehe Deine Bibliotheken.

Exportieren ohne das Fenster zu öffnen

Für Build-Skripte:

flatty -open ./sprites/cloud -export     # schreibt exports/ und exports/latest/
flatty -project ./sprites/cloud -save    # erzeugt die Projektdatei

Beide laufen kopflos und verlassen. Sie brauchen irgendwo zum Schreiben, also weigern sich, ohne -project oder -open zu laufen, statt einen Pfad zu erfinden — und keiner berührt deine Einstellungen oder deine letzte-Projektliste dabei.