Was macht Sprite Forge?
Sprite Forge verwandelt Text auf der GPU dieses Rechners in spielbereite 2D-Assets (darunter läuft ComfyUI; es wird automatisch gestartet). Nichts wird an einen kostenpflichtigen Dienst gesendet. Jedes Ergebnis wird sauber ausgeschnitten, beschnitten, skaliert, geprüft und mit einem Manifest gespeichert; es werden mehrere Versuche gemacht und der beste behalten.
So wird es aufgerufen
Bevorzuge die sprite-forge MCP-Tools, wenn sie verfügbar sind:
list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status.
Andernfalls verwende die Kommandozeile aus dem Sprite-Forge-Ordner; jeder Befehl gibt ein JSON-Objekt aus:
python forge.py profiles
python forge.py sprite <name> "<prompt>" -p sprite --project <Spielordner>
python forge.py sprite <name> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <Spielordner>
python forge.py character <id> "<wer, Outfit, Farben, Props>" --project <Spielordner>
python forge.py sprite <name> -p turnaround --character <id> --set directions=8 --project <Spielordner>
python forge.py sprite <name> -p animation --character <id> --set action=walk --set facing=right --project <Spielordner>
python forge.py animate <name> <sprite.png> "<die Bewegung>" --pose "<Frame 1>" --pose "<Frame 2>" ...
python forge.py normal <sprite.png>
python forge.py check <datei.png> --kind sprite
Exit-Code 0 = ok, 2 = fertig, aber das Ergebnis hat die Prüfung nicht bestanden, 1 = Fehler.
Das Profil wählen
| Profil | Für | Ausgabe |
|---|---|---|
sprite | Props, Gegenstände, Pickups, Waffen, Möbel, UI-Elemente | Transparentes PNG, beschnitten, zentriert auf einer quadratischen Leinwand |
icon | Skill-/Item-Icons, Abzeichen, Buttons | Quadratisches PNG plus 256/128/64 px Versionen |
pixel_sprite | Echtes Pixel-Art: Charaktere, Gegenstände, Gegner | Echtes Pixel-Raster (z.B. 32 px), harter Alpha, limitierte oder benannte Palette, plus eine x8-Vorschau |
character | Eine wiederverwendbare Charakterreferenz | Ganzkörper-transparentes PNG, Füße auf der Grundlinie |
pixel_character | Dasselbe, im Pixel-Art-Stil gezeichnet | Referenz für Pixel-Art-Blätter |
turnaround | Der Charakter in 4 oder 8 Richtungen | Frames + <name>_sheet.png + <name>.atlas.json |
animation | Gehen, Rennen, Idle, Angriff, Springen, Treffer, Tod, Zauber | Frames + Blatt + Atlas mit einem Animations-Tag |
tile | Boden, Wände, Böden, Wasser, Laub | Nahtlose quadratische Textur + eine 3x3 gekachelte Vorschau (optionale Pixel-Version) |
portrait | Dialogporträts, Karten, Schlüsselgrafiken | Vollauflösendes Bild |
vfx | Explosionen, Rauch, Magieausbrüche, Trefferfunken | Frames + Blatt + Atlas; Helligkeit ist Transparenz |
animate_pixel (Tool) | Ein VORHANDENES Pixel-Sprite anhand einer Beschreibung animieren | Frames im eigenen Raster und Palette des Sprites + Blatt + Atlas + GIF |
Jedes Blatt erhält auch <name>.gif (Schleife), damit der Benutzer es ansehen kann.
Jedes Profil hat drei Voreinstellungen: fast (ein schneller Versuch), standard (Standard), max (größeres Modell oder mehr Versuche; Qwen-Image-Edit für Turnarounds/Animationen). Gib an, welche Voreinstellung du verwendet hast.
Arbeitsablauf
- Übergib immer den Spielprojektordner (
project_dir/--project). Seine Dateispriteforge.jsonenthält den Stil, den Ausgabeordner, den Charakterordner und die profileinstellungen, sodass die Grafik eines Spiels konsistent bleibt. Wenn keine vorhanden ist, biete an, eine zu erstellen (forge.py init <verzeichnis>). - Schreibe den Prompt so, wie es der
prompt_guidedes Profils vorgibt (list_profilesgibt ihn zurück). Beschreibe das Ding, nicht das Bild: kein "ein Sprite von", kein Hintergrund, keine Kamerawörter im Prompt – setze den Winkel mitparams.view(front view,side view,top-down view,isometric view). - Charaktere, die mehr als einmal vorkommen: erstelle sie zuerst.
create_character(oder das Profilcharactermit gesetztemcharacter) speichert eine Referenz; Turnarounds und Animationen sind Bearbeitungen davon, sodass der Charakter ein einheitliches Aussehen behält. Verwende für Pixel-Art-Blätterprofile: "pixel_character"und übergibparams.pixel_grid(z.B. 32) an das Blatt. - Längere Aufträge sind asynchron. Wenn ein Tool eine Auftrags-ID zurückgibt, rufe
get_jobmitwait_seconds: 50auf, bis der Status nicht mehrqueuedoderrunningist. Ein Auftrag nach dem anderen. - Sieh dir die Vorschau an. Jedes Ergebnis wird mit einem Vorschaubild geliefert (Sprites auf einem Schachbrettmuster). Überprüfe es, bevor du das Asset als fertig bezeichnest: falsches Motiv, ein abgeschnittener Teil, ein zweites Objekt, ein Halo, ein Frame, der nicht dem gleichen Charakter entspricht. Melde die Datei, ihre Größe, etwaige
problemsund erwähne die anderen Versuche in.spriteforge/<name>/.
Pixel-Art
- Bildmodelle zeichnen nur Pixel-Art im Stil; Sprite Forge macht es echt: Es findet das Pixel-Raster des Modells (oder erzwingt
grid), nimmt die dominante Farbe jeder Zelle, entfernt einzelne Pixel, macht Alpha vollständig an/aus und begrenzt die Palette. Bezeichne ein Sprite niemals als Pixel-Art ohne diesen Schritt. grid: die längste Seite des Sprites in Pixeln (16, 24, 32, 48, 64)."auto"behält die Pixelgröße bei, die das Modell gezeichnet hat.palette:pico8,gameboy,nes,endesga32,sweetie16, eine Liste von Hex-Farben oder"project"– eine Palette, die für das gesamte Spiel eingefroren wird (gespeichert alspalette.hexim Projekt durch das erste Pixel-Asset, von jedem späteren wiederverwendet). Verwende"project"für ein Spiel.outline: truefügt eine 1-Pixel-dunkle Kontur hinzu;canvas: 32platziert das Sprite auf einem 32x32-Raster.- Es wird kein Dithering angewendet (es flackert in der Animation).
Ein vorhandenes Pixel-Sprite animieren
Verwende animate_pixel, wenn der Benutzer bereits ein Pixel-Sprite hat (eigenes oder mit pixel_sprite erstellt) und eine Bewegung beschreibt: "lass den Schleim hüpfen", "animieren Sie den Ritter, wie er sein Schwert schwingt". Es behält die genaue Pixelgröße und Palette des Sprites in jedem Frame bei.
image: das PNG (native Größe bis zu 256 px, oder eine vergrößerte Kopie mit harten Pixeln).description: die Bewegung. walk / run / idle / attack / jump / hurt / death / cast verwenden eingebaute Schlüsselposen.- Schreibe
posesselbst für alles andere: eine kurze Zeile pro Frame, die die Änderungen beschreibt, z.B. für einen Schwertschwung["hebt das Schwert hoch über seinen Kopf", "das Schwert oben, der Körper lehnt sich zurück", "schwingt das Schwert vor sich nach unten", "das Schwert tief nach dem Schlag"]. 3-6 Frames lesen sich am besten. Dies sind Schlüsselposen, keine Zwischenbilder. params.include_original: truesetzt das unberührte Sprite als Frame 0 ein;params.fps.- Sieh dir das GIF / die Vorschau an: Wenn ein Frame einen Teil des Sprites verloren oder verändert hat, führe es mit einem neuen
seedoderpreset: "max"(mehr Versuche pro Frame) erneut aus.
Normal Maps (2D-Beleuchtung)
Für Spiele mit 2D-Lichtern (Godot CanvasTexture + Light2D, Unity 2D-Lichter, Phaser light2d) übergib params.normal_map: true an sprite, icon, pixel_sprite, character, turnaround, animation oder animate_pixel, oder rufe make_normal_map für ein vorhandenes PNG auf.
- Schreibt
<name>_normal.png(oder<name>_sheet_normal.png, gleiches Layout wie das Blatt) und<name>_lit_preview.png(das Sprite von links, oben, rechts und unten beleuchtet) – zeige dem Benutzer die Vorschau. - Pixel-Art behält sein Pixel-Raster mit scharfen, eingerasteten Normalen.
- Standardkonvention ist OpenGL (grün = oben), die Godot und Unity erwarten;
normal_y: "down"/y: "down"für DirectX.normal_strength0,5 dezent – 2 stark. - Das Relief wird aus der Zeichnung abgeleitet (Kontur, Farbbereiche, Glanzlichter), nicht modelliert: Es wirkt gut unter beweglichen Lichtern, ist aber kein echter Tiefenscan.
Wenn das Ergebnis failed_check anzeigt
Die Datei wird geschrieben, sollte aber nicht so verwendet werden. problems erklärt, warum.
| Problem | Lösung |
|---|---|
cut off | Neu ausführen mit einem neuen seed; "klein, zentriert, mit Platz drum herum" hinzufügen oder params.padding erhöhen. |
several objects | Nur ein Objekt nennen; neu ausführen mit einem neuen Seed. |
background not removed / empty | Ein solides Objekt beschreiben; background schlicht halten; neu ausführen. |
may not look like the character (Blätter) | Das Blatt mit einem neuen Seed oder preset: "max" neu ausführen; den Charakter-Prompt einfach halten. |
may not have turned (Turnaround) | Mit preset: "max" neu ausführen (Qwen-Image-Edit folgt Ansichtsänderungen besser). |
no clear pixel grid found | Das Bild wurde nicht als Pixel-Art gezeichnet: grid auf eine Zahl setzen oder neu ausführen. |
visible seam (Kachel) | Eine organische Oberfläche verwenden oder params.blend erhöhen; neu ausführen. |
much smaller than the original (animate_pixel) | Dieser Frame hat einen Teil des Sprites verloren: neu ausführen mit einem neuen Seed oder eine klarere Pose angeben. |
flat: almost a single colour | Das Modell hat eine Silhouette gezeichnet: neu ausführen mit einem neuen Seed; "in voller Farbe" sagen. |
Gleicher name + gleiche Einstellungen geben die vorhandene Datei zurück; ändere eine Einstellung, den Seed oder übergib force: true, um eine neue zu erstellen.
Anpassung
- Pro Projekt:
spriteforge.json(style,style_preset,output_dir,characters_dir,profiles.<id>.params, z.B.{"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}}). - Pro Aufruf:
params, z.B.{"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}.list_profileslistet jeden Parameter mit einer Erklärung auf. - Neues Profil: eine kleine JSON-Datei im
spriteforge_profiles/-Verzeichnis des Projekts, die eineextends-Erweiterung eines bestehenden Profils vornimmt. - Modelle und Hardware: Das
models-Tool meldet, was jedes Profil und jede Voreinstellung benötigt und was fehlt. Downloads sind groß – frage den Benutzer vor der Installation. - Lizenzen: Jedes Modell, das Sprite Forge installiert, erlaubt die kommerzielle Nutzung dessen, was du erstellst (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511 und die Pixel-LoRA: Apache 2.0; BiRefNet und CLIP: MIT). Einige Stores (z.B. Steam, itch.io) verlangen, dass du KI-erstellte Assets angibst.