Generate2dsprite
Nutze diese Skill für eigenständige 2D-Sprite- oder Animations-Assets in der App-Builder-Sandbox (TanStack Start + Browser-Spiele).
Wenn ein größeres Spiel oder ein spielbarer Prototyp Sprites benötigt, verwende diese Skill für die sichtbaren Sprite-Assets und halte die Laufzeit / Spielkomposition separat (nach dem Export in Phaser / Canvas / DOM einbinden). Ersetze nicht angeforderte Sprite-Assets durch code-gezeichnete Platzhalter.
App-Builder / Grok-Umgebung
| Element | Wert |
|---|---|
| Skill-Verzeichnis | .grok/skills/generate2dsprite/ |
| Skripte | python3 .grok/skills/generate2dsprite/scripts/<script>.py … |
| Bildwerkzeuge | imagine_text_to_image / imagine_image_to_image (pfadbasiert; siehe imagine-Skill für die Prompt-Erstellung) |
| Bilder ansehen | read_file mit dem PNG-Pfad (nicht Codex view_image) |
| Generierter Bildpfad | imagine_text_to_image gibt einen Sandbox-file_path zurück; kopiere diesen Pfad vor der Verarbeitung in dein Laufverzeichnis |
| Python-Abhängigkeiten | Pillow + numpy (vorinstalliert im Image) |
| Ausgabeverzeichnis | Bevorzuge assets/sprites/<name>/ unter /workspace, damit die App sie importieren kann |
| Zielplattform | Browser: Canvas 2D, Phaser oder DOM/<img> – nicht Godot/Unity, es sei denn, der Benutzer fragt explizit danach |
Verwandte Skills: imagine (Nutzung der Bildwerkzeuge), game-asset-core (+ game-animation-frames / game-character-consistency für Qualitätskontrolle und engine-fertige Standardeinstellungen), generate2dmap (Karten/Requisiten), video2dsprite (dichtere Bewegungen via imagine_image_to_video), building-games (Spielschleife / Integration).
Parameter
Leite diese aus der Benutzeranfrage ab:
asset_type:player|npc|creature|character|spell|projectile|impact|prop|summon|fxaction:single|idle|cast|attack|shoot|jump|hurt|combat|walk|run|hover|charge|projectile|impact|explode|deathview:topdown|side|3/4sheet:auto|2x2|2x3|2x4|3x3|3x4|4x4|5x5|custom_grid|strip_1x3|strip_1x4frames:autooder explizite Anzahlbundle:single_asset|unit_bundle|spell_bundle|combat_bundle|line_bundle|hero_action_bundle|engine_atlaseffect_policy:all|largestanchor:center|bottom|feetmargin:tight|normal|safeart_style: pixel_art | clean_hd | pixel_inspired | retro_pixel | map_style | project-nativereference:none|attached_image|generated_image|local_filelayout_guide:none|optional|recommendedprompt: das Thema oder die visuelle Richtung des Benutzersrole: nur wenn das Asset eindeutig eine NPC-Rolle hatname: optionaler Ausgabe-Slug
Lies references/modes.md, wenn die Anfrage mehrdeutig ist.
Agenten-Regeln
- Entscheide den Asset-Plan selbst. Zwinge den Benutzer nicht, Sheet-Größe, Bildanzahl oder Bundle-Struktur anzugeben, wenn die Anfrage diese bereits impliziert.
- Packe keine unzusammenhängenden Aktionen in ein einziges roh generiertes Sheet, nur um eine
4x4-,5x5- oder benutzerdefinierte Engine-Atlas-Anforderung zu erfüllen. Ein roh generiertes Sheet sollte eine Aktionsfamilie, eine kontinuierliche Abfolge, ein kanonisches Richtungsfortbewegungsblatt oder ein Requisiten-/Asset-Paket darstellen. - Für steuerbare Helden, Hauptfiguren und hochwertige Spieler-Assets mit mehreren Aktionen generiere zuerst separate Raster-Sheets pro Aktion, überprüfe jede Aktion visuell und setze dann erst den von der Engine benötigten Atlas deterministisch zusammen, nachdem die Raster die visuelle Überprüfung bestanden haben.
- Für steuerbare Helden, Hauptfiguren und körperbezogene Aktionen wie Angriff/Schuss/Zauber: Standardmäßig die Körper-Sheets auf „nur Körper“ setzen. Füge keine großen Hiebbögen, Mündungsfeuer, Projektile, Einschlagsexplosionen, losen Staub, lange Spuren oder breite, losgelöste Effekte in das Körper-Sheet ein. Generiere diese als separate
fx-,projectile- oderimpact-Sheets und lege sie im Spiel übereinander. - Füge breite Angriffseffekte nur dann in dasselbe rohe Körper-Sheet ein, wenn die Ziel-Laufzeit explizit breitere Aktionszellen sowie Ursprungs-/Anker-Metadaten pro Aktion unterstützt. Andernfalls zwingt ein breiter Effekt-Bounding-Box den Körper dazu, innerhalb der festen Zelle zu schrumpfen.
- Schreibe den Kunst-Prompt selbst. Verwende nicht standardmäßig das Prompt-Builder-Skript.
- Verwende
imagine_text_to_imagefür jedes einzelne Rohbild. - Erstelle keine rohe Sprite-Grafik mit Three.js, Canvas, SVG, HTML/CSS-Zeichnungen, PIL-Formenzeichnungen, prozeduraler Geometrie, Platzhalter-Primitiven oder code-gerenderten Screenshots. Laufzeit-Code darf fertig generierte Assets anzeigen, und Skripte dürfen Layout-Vorlagen erstellen oder generierte Bilder nachbearbeiten, aber die angeforderte Sprite-Grafik muss von
imagine_text_to_imagestammen. - Wenn der Benutzer einen visuellen Referenz bereitstellt oder impliziert, übergib den Sandbox-
file_pathdieser Referenz animagine_image_to_image(das Tool liest die Datei). Lies die lokale Referenz auch mitread_file, damit du sie sehen kannst; ein nur im Prompt erwähnter Pfad ist keine visuelle Eingabe. - Erzwinge keine Pixel-Art, wenn das Asset eine Kartenrequisite für
$generate2dmapist oder wenn der Benutzer / das Projekt einen anderen Stil wünscht. Passe dich zuerst dem Karten- oder Referenzstil an. - Verwende das Skript nur als deterministischen Prozessor: Magenta-Bereinigung, Aufteilung in Frames, Komponentenfilterung, Skalierung, Ausrichtung, Qualitätskontroll-Metadaten, transparenten Sheet-Export und GIF-Export.
- Verwende keine Skripte, um den kreativen Bild-Prompt zu generieren. Falls ein altes Prompt-Builder-Kommando existiert, behandle es nur als historische Kompatibilität, nicht als normalen Skill-Workflow.
- Layout-Vorlagen sind nur als deterministische Geometrie-Referenzen für die Bildgenerierung erlaubt. Sie können die Anzahl der Slots, Abstände, Zentrierung und sichere Abstände anzeigen, dürfen aber niemals die kreative künstlerische Richtung definieren.
- Behandle Skript-Flags als Ausführungs-Primitive, die vom Agenten ausgewählt werden, nicht als benutzerseitigen, fest codierten Workflow.
- Wenn ein generiertes Sheet Zellkanten berührt, in der Größe schwankt oder eine Projektils-/Einschlagsschleife unterbricht, verarbeite es entweder mit besseren Primitiveinstellungen neu oder generiere das rohe Sheet neu.
- Verwende keine rohen einzeiligen Sheets wie
1x4,1x6,1x8oder1xNfür Charaktere, Spieler, steuerbare Helden, Kreaturen, NPCs, Feinde, Beschwörungen, animierte Requisiten oder Assets, bei denen ein Körper/Subjekt zentriert bleiben muss. Einzeilige Rohgenerierung driftet zu wahrscheinlich horizontal und schneidet inkonsistent zu. - Verwende für animierte Körper-Assets standardmäßig ein mehrzeiliges Raster: 4 Frames ->
2x2, 6 Frames ->2x3, 8 Frames ->2x4, 9 Frames ->3x3, 12 Frames ->3x4oder4x3, 16 Frames ->4x4. - Wenn eine Spiel-Engine einen finalen einzeiligen Streifen oder gemischten Atlas benötigt, generiere und überprüfe die Aktion zuerst als mehrzeiliges Raster und setze dann den Auslieferungsstreifen/Atlas deterministisch zusammen.
- Fordere bei jedem animierten Körper-Raster-Prompt, dass der Subjektkörper in jeder Zelle zentriert bleibt, der gesamte Körper im zentralen 60% bis 70% sicheren Bereich liegt, die Größe über alle Zellen hinweg konsistent ist, eine stabile Fuß-/Bodenankerlinie (sofern zutreffend) eingehalten wird und keine Gliedmaßen, Waffen, Haare, Umhänge, Staub, Mündungsfeuer oder losgelöste Effekte Zellkanten überschreiten.
- Fordere bei Held-Angriffs-Körper-Prompts explizit, dass Körperhöhe und Körpergröße mit den akzeptierten Leerlauf-/Lauf-Sheets übereinstimmen, ein stabiler Fuß-/Bodenanker vorhanden ist, die Waffe nah genug bleibt, um den Körper-Bounding-Box nicht zu verbreitern, und kein losgelöster Hiebbogen oder Bildschirm-Angriffseffekt vorhanden ist.
- Klassifiziere bei Kartenrequisiten-Paketen die Requisiten, bevor du ein Raster wählst. Quadratische
2x2-,3x3- und4x4-Pakete sind nur für kompakte Requisiten geeignet. Lege keine Plattformen, Böden, Brücken, Wände, Leitern, Tore, Türen, lange Hindernisse, breite/hohe Requisiten, kollisionsrelevante Objekte oder Kachel-/Streifenstücke in quadratische Requisitenpakete; verwende stattdessen einzeln,1x3/1x4-Streifen, benutzerdefinierte breite Zellen oder einen tileset-ähnlichen Atlas. - Behalte die feste
#FF00FF-Hintergrundregel bei, es sei denn, der Benutzer wünscht explizit einen anderen Verarbeitungsworkflow.
Workflow
1. Leite den Asset-Plan ab
Wähle die kleinste sinnvolle Ausgabe.
Beispiele:
- steuerbarer Held mit vier Richtungen ->
player+player_sheet - Seitenansicht-steuerbarer Held mit Leerlauf/Laufen/Schießen/Springen ->
player+hero_action_bundle- Leerlauf-Raster-Sheet, normalerweise
2x2für 4 Frames - Lauf-Raster-Sheet, normalerweise
2x2oder2x3je nach benötigter Frame-Anzahl - Schuss-Raster-Sheet mit Körper/Waffe nur, normalerweise
2x2 - Sprung-Raster-Sheet, normalerweise
2x2 - Projektil / Mündungsfeuer als separate Assets, wenn nötig
- optionaler zusammengestellter Engine-Atlas nach Qualitätskontrolle pro Aktion
- Leerlauf-Raster-Sheet, normalerweise
- Seitenansicht-steuerbarer Held mit Nahkampfangriff ->
player+hero_action_bundle- Angriffs-Körper-Raster-Sheet, normalerweise
2x2oder2x3, nur Körper - Hiebbogen / Waffenspur als separates
fx-Sheet, wenn der Angriff einen breiten visuellen Effekt benötigt - Einschlagsfunke als separates
impact-Sheet, wenn Treffer Feedback benötigen
- Angriffs-Körper-Raster-Sheet, normalerweise
- Heiler-Overworld-NPC ->
npc+single_assetoderunit_bundle - große Boss-Leerlauf-Schleife ->
creature+idle+3x3 - Zauberer wirft eine Magiekugel ->
spell_bundle- Zauberer-Zauber-Sheet
- Projektil-Schleife
- Einschlags-Explosion
- Monster-Linien-Anfrage ->
line_bundle- plane 1-3 Formen
- pro Form die Sheets erstellen, die die Anfrage tatsächlich benötigt
2. Schreibe den Prompt manuell
Nutze references/prompt-rules.md.
Wähle den art_style vor dem Schreiben des Prompts:
- Verwende
pixel_artoderretro_pixelfür klassische Sprites, 16-Bit-RPG-Akteure und Anfragen, die explizit Pixel-Art verlangen. - Verwende
clean_hdfür Kartenrequisiten oder Assets, die zu sauberen, handgemalten HD-Karten passen sollen. - Verwende
pixel_inspirednur, wenn der Benutzer einen pixel-ähnlichen Look ohne Retro-Körnigkeit wünscht. - Verwende
map_styleoderproject-native, wenn eine vorhandene Karte, ein Spiel oder eine Referenz den Stil definieren soll.
Wenn eine Referenz beteiligt ist:
- Leite die Referenz in den Aufruf ein: Übergib ihren Sandbox-
file_pathanimagine_image_to_image– oder die Pfadliste animagine_reference_to_imagefür 2+ Referenzen (generierte Bilder haben bereits einenfile_path; lokale Dateien verwenden ihren Sandbox-Pfad). Lies auch lokale Referenzen mitread_file, damit du sie sehen kannst. - Gib die Rolle der Referenz explizit an: Identität/Stil bewahren, ein Animationssheet für dasselbe Subjekt erstellen, eine Evolution/Variante erstellen oder eine passende Requisite/Effekt ableiten.
- Bewahre die stabilen Identitätsmarker der Referenz: Silhouette, Palette, Gesichts-/Augenmerkmale, Kostümdetails, Hauptaccessoires und Materialsprache.
- Lass nur die angeforderte Aktion oder Evolution sich ändern. Gestalte das Subjekt nicht neu, es sei denn, der Benutzer fragt explizit danach.
- Fordere weiterhin die exakte Sheet-Form, einen durchgehenden Magenta-Hintergrund, Frame-Einhaltung und dieselbe Größe über alle Frames hinweg.
Schutzmaßnahme für gemischte Aktions-Atlasse:
- Bitte
imagine_text_to_imagenicht, in einem rohen Sheet unzusammenhängende Aktionszeilen zu generieren, wie z. B. „Zeile 1 Leerlauf, Zeile 2 Laufen, Zeile 3 Schießen, Zeile 4 Springen“ für einen steuerbaren Helden oder Hauptcharakter. - Bitte
imagine_text_to_imagenicht, rohe einzeilige Aktionsstreifen wie1x4 Leerlauf,1x4 Laufen,1x4 Schießenoder1x4 Springenfür einen steuerbaren Helden, Charakter, Kreatur, NPC, Feind, Beschwörung oder animierte Requisite zu generieren. - Wenn eine Engine eine kombinierte
4x4-,5x5-, benutzerdefinierten Atlas oder zeilenbasiertes Ausgabeformat benötigt, generiere die Aktionsraster separat, verarbeite und überprüfe sie separat und setze dann den Auslieferungsatlas deterministisch zusammen. - Ausnahmen sind kanonische Richtungsfortbewegungsblätter, eine einzige, kontinuierliche, lange Aktionssequenz, Requisitenpakete, tileset-ähnliche Atlassen und wenig riskante, kompakte Feindkampfblätter. Auch diese benötigen einen kohärenten Prompt und eine visuelle Qualitätskontrolle.
- Halte Projektile, Mündungsfeuer, Einschläge, Staubspuren und losgelöste Effekte in separaten Sheets, es sei denn, sie sind absichtlich Teil derselben Aktionssilhouette und bleiben fest verbunden.
- Für steuerbare Helden und Hauptfiguren ist „fest verbunden“ nicht ausreichend, wenn der Effekt den Aktions-Bounding-Box viel breiter oder höher als Leerlauf/Laufen macht. Spalte breite Hiebbögen, Mündungsfeuer, lange Waffenspuren, Staubwolken und Einschlags-Explosionen standardmäßig in separate FX-Sheets auf.
Schutzmaßnahme für animierte Körper-Raster:
1x4und andere rohe einzeilige Sheets sind keine gültigen Standardeinstellungen für animierte Körper. Dies gilt für Spieler, steuerbare Helden, Kreaturen, NPCs, Feinde, Beschwörungen, animierte Requisiten und körperbezogene Kampfaktionen.- Verwende
2x2für 4-Frame-Körperaktionen. Dies ist der Standard für Leerlauf, kurze Angriffe, Schuss-Körper, Springen, Verletzung, Schweben und kompakte Seitenansicht-Lauf-/Lauf-Aktionen. - Verwende
2x3für 6-Frame-Körperaktionen wie Zaubern, Angriff, Beschwörung, Laufen, Aufladen oder Verwandlung. - Verwende
2x4,3x3,3x4oder4x4für längere Körperaktionen. Bevorzuge ein kompaktes Raster gegenüber einer langen Zeile. - Für 4-Richtungen-Topdown-Laufen kann
4x4eine Rohgenerierungsform bleiben, da es ein kanonisches Richtungsfortbewegungsblatt ist, nicht vier unzusammenhängende Aktionszeilen. - Wenn die endgültige Laufzeit einen Zeilenstreifen benötigt, setze ihn nach der Qualitätskontrolle aus den verarbeiteten mehrzeiligen Raster-Frames zusammen.
- Halte den Charakter in jeder Zelle zentriert. Die Körpermittellinie sollte nahe der Zellmitte bleiben, der Fuß-/Bodenanker sollte bei Sichtbarkeit auf derselben Y-Position bleiben und das Subjekt sollte nur den zentralen sicheren Bereich mit großzügigem Magenta-Rand belegen.
- Bei Angriffs-, Schuss-, Zauber-, Auflade- und anderen Körperaktionen sollte die Körperhöhe nahe der akzeptierten Leerlauf-/Lauf-Körperhöhe bleiben. Wenn eine feste Zellenlaufzeit verwendet wird, lehne das Körperaktions-Output ab, wenn der Körper mehr als etwa 10–15 % kleiner als Leerlauf/Laufen erscheint, selbst wenn
edge_touch_framesleer ist.
Schutzmaßnahme für Kartenrequisiten-Pakete:
- Verwende quadratische
2x2-,3x3- und4x4-Rohrequisitenpakete nur für kompakte Requisiten wie Steine, Sträucher, Fässer, Kisten, Lampen, kleine Schilder, Töpfe, Trümmer und kleine Ornamente. - Verwende quadratische Requisitenpakete nicht für breite oder kollisionskritische Kartenobjekte: Böden, Plattformen, Felsvorsprünge, Geländestücke, Brücken, Wandverläufe, Leitern, Straßen, Schienen, Rohre, lange Spießfallen, Tore, Türen, Gebäude, große Bäume, Kontrollpunkte, Ausgänge oder Baupads.
- Verwende Einzelgenerierung für einzigartige, große, wichtige, hohe, unregelmäßige oder kollisionsausgerichtete Requisiten.
- Verwende
1x3- oder1x4-Streifen für wiederholbare Plattform-/Boden-Assets, mit linker Kappe, mittlerer Wiederholung, rechter Kappe und optionaler Steigungs-/Eck-/Endvariante. - Verwende benutzerdefinierte breite Zellen für mehrere si
…
[gekürzt für die Übersetzung]