CommunityBildgithub.com

Sprite Forge

Generiere 2D-Spielgrafiken lokal und kostenlos – Sprites, Props, Items, Icons und UI-Elemente mit transparentem Hintergrund, echtes Pixel-Art (Raster, limitierte Palette), Charaktere mit 4/8-Richtungs-Turnarounds und Animations-Spritesheets (Gehen, Rennen, Idle, Angriff …), Animation eines vorhandenen Pixel-Sprites anhand einer Beschreibung, Normal Maps für 2D-Beleuchtung, nahtlose Kacheln, Porträts und VFX-Frames – als spielbereite PNGs, GIFs und TexturePacker/Phaser JSON-Atlanten. Verwende das Skill immer dann, wenn der Benutzer darum bittet, ein Sprite, 2D-Asset, Pixel-Art, Icon, Spritesheet, Charakterblatt, Laufzyklus, Kachel oder Textur, Porträt, Effektanimation oder Normal Map zu erstellen, zu generieren, neu zu generieren, zu animieren oder zu reparieren, oder ein PNG zu überprüfen.

Was ist Sprite Forge?

Sprite Forge ist ein leistungsstarkes KI-Tool, das auf der lokalen GPU (ComfyUI im Hintergrund) läuft und Textbeschreibungen in professionelle 2D-Spielgrafiken umwandelt – alles ohne Cloud-Kosten oder Lizenzen. Es unterstützt eine breite Palette von Asset-Typen: von einfachen Sprites, Icons und Pixel-Art über Charaktere mit vollständigen Turnarounds (4 oder 8 Richtungen) und Animations-Spritesheets (Gehen, Rennen, Idle, Angriff etc.) bis hin zu nahtlosen Kacheln, Porträts und VFX-Frames. Ein herausragendes Merkmal ist die Fähigkeit, echte Pixel-Art mit exaktem Raster und limitierter Palette zu erzeugen sowie bestehende Pixel-Sprites anhand einer Textbeschreibung zu animieren. Alle Ergebnisse werden automatisch beschnitten, zentriert, auf Qualität geprüft und als spielbereite PNGs, GIFs und JSON-Atlanten (TexturePacker/Phaser) gespeichert. Der Workflow umfasst die Erstellung referenzierbarer Charaktere, asynchrone Auftragsverarbeitung für längere Aufgaben und eine automatische Fehlererkennung mit klaren Handlungsanweisungen. Es eignet sich besonders für Indie-Entwickler und Teams, die konsistente, lokale und sofort einsetzbare 2D-Assets benötigen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp/tree/main/skills/sprite-forge

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

ProfilFürAusgabe
spriteProps, Gegenstände, Pickups, Waffen, Möbel, UI-ElementeTransparentes PNG, beschnitten, zentriert auf einer quadratischen Leinwand
iconSkill-/Item-Icons, Abzeichen, ButtonsQuadratisches PNG plus 256/128/64 px Versionen
pixel_spriteEchtes Pixel-Art: Charaktere, Gegenstände, GegnerEchtes Pixel-Raster (z.B. 32 px), harter Alpha, limitierte oder benannte Palette, plus eine x8-Vorschau
characterEine wiederverwendbare CharakterreferenzGanzkörper-transparentes PNG, Füße auf der Grundlinie
pixel_characterDasselbe, im Pixel-Art-Stil gezeichnetReferenz für Pixel-Art-Blätter
turnaroundDer Charakter in 4 oder 8 RichtungenFrames + <name>_sheet.png + <name>.atlas.json
animationGehen, Rennen, Idle, Angriff, Springen, Treffer, Tod, ZauberFrames + Blatt + Atlas mit einem Animations-Tag
tileBoden, Wände, Böden, Wasser, LaubNahtlose quadratische Textur + eine 3x3 gekachelte Vorschau (optionale Pixel-Version)
portraitDialogporträts, Karten, SchlüsselgrafikenVollauflösendes Bild
vfxExplosionen, Rauch, Magieausbrüche, TrefferfunkenFrames + Blatt + Atlas; Helligkeit ist Transparenz
animate_pixel (Tool)Ein VORHANDENES Pixel-Sprite anhand einer Beschreibung animierenFrames 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

  1. Übergib immer den Spielprojektordner (project_dir / --project). Seine Datei spriteforge.json enthä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>).
  2. Schreibe den Prompt so, wie es der prompt_guide des Profils vorgibt (list_profiles gibt ihn zurück). Beschreibe das Ding, nicht das Bild: kein "ein Sprite von", kein Hintergrund, keine Kamerawörter im Prompt – setze den Winkel mit params.view (front view, side view, top-down view, isometric view).
  3. Charaktere, die mehr als einmal vorkommen: erstelle sie zuerst. create_character (oder das Profil character mit gesetztem character) speichert eine Referenz; Turnarounds und Animationen sind Bearbeitungen davon, sodass der Charakter ein einheitliches Aussehen behält. Verwende für Pixel-Art-Blätter profile: "pixel_character" und übergib params.pixel_grid (z.B. 32) an das Blatt.
  4. Längere Aufträge sind asynchron. Wenn ein Tool eine Auftrags-ID zurückgibt, rufe get_job mit wait_seconds: 50 auf, bis der Status nicht mehr queued oder running ist. Ein Auftrag nach dem anderen.
  5. 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 problems und 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 als palette.hex im Projekt durch das erste Pixel-Asset, von jedem späteren wiederverwendet). Verwende "project" für ein Spiel.
  • outline: true fügt eine 1-Pixel-dunkle Kontur hinzu; canvas: 32 platziert 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 poses selbst 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: true setzt 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 seed oder preset: "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_strength 0,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.

ProblemLösung
cut offNeu ausführen mit einem neuen seed; "klein, zentriert, mit Platz drum herum" hinzufügen oder params.padding erhöhen.
several objectsNur ein Objekt nennen; neu ausführen mit einem neuen Seed.
background not removed / emptyEin 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 foundDas 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 colourDas 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_profiles listet jeden Parameter mit einer Erklärung auf.
  • Neues Profil: eine kleine JSON-Datei im spriteforge_profiles/-Verzeichnis des Projekts, die eine extends-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.

Verwandte Skills