Generate2dmap
App-Builder / Grok-Umgebung
| Element | Wert |
|---|---|
| Skill-Verzeichnis / Skripte | .grok/skills/generate2dmap/, ausführen als python3 .grok/skills/generate2dmap/scripts/<script>.py … |
| Bildwerkzeuge | imagine_text_to_image / imagine_image_to_image (pfadbasiert; siehe imagine); Ausgabe mit read_file auf dem PNG-Pfad prüfen (nicht Codex view_image) |
| Generierter Bildpfad | imagine_text_to_image → Sandbox file_path → kopieren nach assets/map/; Pillow ist vorinstalliert |
Standard engine_target | raw_canvas oder Phaser für diese TanStack-Browser-Sandbox – Godot/Unity/Tiled nur verwenden, wenn der Benutzer diesen Export explizit wünscht |
| Verwandte Skills | generate2dsprite (Charakter-/FX-Sprites; Prop-Packs verwenden weiterhin das Extraktionsskript dieses Skills), building-games, imagine |
Entscheide zuerst die Pipeline
Erstelle das kleinste spielbare Kartenpaket, das das Spiel zufriedenstellt: Wähle einen produktionsreifen map_mode, dann die untergeordneten Achsen (visual_model, runtime_object_model, collision_model, engine_target).
tile_mode– editierbare Tile/Gitter-Karten: Pokémon-ähnliche Routen, Top-Down-RPG-Städte, Plattformer-Tilemaps oder jedes Projekt, das bereits auf Tiled/LDtk/Godot/Unity/Phaser-Tilemaps läuft.scene_mode– Grundfläche plus separate Props: Tower Defense, Survivors-ähnliche Arenen, gemütliche Top-Down-Showcase-Karten.side_scroll_mode– Parallax-Seitenscroller-Stages: Mega Man ähnlich, Action-Plattformer, Metroidvania-Räume, Runner, Brawler.grid_mode– regelbasierte Gitter: taktische RPGs, Fabrik-/Automatisierungsspiele, Brett-/Karten-Battler, Baugitter.room_chunk_mode– modulare Räume/Blöcke: Rogue-like-Dungeons, Metroidvania-Netzwerke, prozedurale Montage.baked_scene_mode– explizit flache, nicht spielbare Szenen: Titel-/Menübildschirme, Kampf-Hintergründe, Visual-Novel-Szenen, Konzeptkunst.
Verwende vom Benutzer angegebene Parameter, falls vorhanden; andernfalls leite die leichteste spielbare Pipeline aus dem bestehenden Spiel, der Kamera, den Kollisionsanforderungen, dem Kartenmaßstab und den Bearbeitungsanforderungen ab. Wenn Modus und Achsen widersprüchlich sind, gilt der spielbare/editierbare Vertrag des Modus. Genre-Routing, modusspezifische Achsen-Standardwerte, Voreinstellungen und die Eskalationsheuristik findest du in references/map-strategies.md – lies es jedes Mal, wenn die Wahl nicht offensichtlich ist.
Eine spielbare Karte ist niemals ein einzelnes eingebackenes Bild. Für jede Anfrage, die eine spielbare Karte, ein Level, eine Stage, einen Raum, einen Prototypen oder eine Engine-Szene impliziert, muss die Ausgabe die Spielgeometrie und Objekte als separate Ebenen, Props, Tile-/Objektdaten, Kollisionen, Zonen oder Engine-native Szenenknoten bereitstellen. Ein eingebackenes Bild kann ein Hintergrund, eine Referenz oder ein Vorschau-Artefakt sein – niemals die Laufzeitkarte – es sei denn, der Benutzer hat explizit nach einem flachen Hintergrund gefragt.
Nur Szenen und Karten. Generiere keine Charakter-, Gegner-, Boss-, NPC-, Spieler-, Projektil- oder Animations-Sprites hier; diese gehören zu $generate2dsprite. Karten tragen Szenen-Hooks (Spawn-Marker, Patrouillen-/Begegnungszonen, Arena-Eingänge, Tore, Ausgänge, Kamera-Trigger) als Metadaten, nicht als gezeichnete Kunst.
Kunst kommt aus der Bildgenerierung, und du schreibst die Prompts
imagine_text_to_imageist die Standard-Kunstquelle für Basiskarten, Parallax-Ebenen, Referenzen, Prop-Bögen und Tileset-Kunst. Standard-art_styleistclean_hd(handgemaltes HD, scharfe lesbare Formen, geringes Texturrauschen, keine klobigen Pixel); verwendepixel_inspiredoderretro_pixelnur, wenn darum gebeten wird.- Schreibe jeden kreativen Prompt selbst. Skripte können montieren, zuschneiden, Chroma-Key anwenden, zuschneiden, validieren, Vorschauen erstellen und JSON/Engine-Dateien ausgeben – niemals kreative Prompts schreiben oder endgültige Kunst zeichnen. Prozedurale/Platzhalter-Kunst nur, wenn der Benutzer explizit nach Platzhaltern, Fixtures, Debug-Karten oder Gerüsten fragt. Bei einem Tile-Engine-Ziel generiere zuerst die Tileset-Kunst, dann skripte nur die Ebenen, Kollision, Zonen und Szenenverkabelung.
- Speichere jeden Prompt neben seinem Asset als
<asset>.prompt.txt(oder ein explizites Manifest-Feld), wenn der Durchlauf neue visuelle Assets erstellt. - Eine Referenz-Übergabe ist ein Dateipfad, kein Satz. Um auf einem früheren Bild aufzubauen, übergib seinen Sandbox-
file_pathanimagine_image_to_image(und lies ihn mitread_file, damit du ihn sehen kannst), und nenne dann die konkreten Merkmale, die erhalten bleiben sollen: Kamera-Bildausschnitt, Horizont, Straßen-/Wasserformen, Geländegrenzen, Eingänge/Ausgänge, Orientierungspunkte. Ein Dateiname, „basierend auf der Karte“ oder dass das Bild lediglich im Gespräch sichtbar ist, ist keine Übergabe – halte an und übergib den Pfad.
Halte Laufzeitobjekte aus der Basis-Ebene heraus
Das erste generierte Basis-/Background-/Foundation-Bild darf nur stabile, nicht interaktive Foundation-Kunst enthalten – Bodenmaterial, Wege, Straßen, Wasser, Klippen, Bodenmuster, Spurmarkierungen und Bauplatten; für Seitenansichten Himmel, weit/mittel entfernte Szenen, Silhouetten, Atmosphäre; für Tilemaps Tileset-Kunst als editierbare Ebenen. Es darf nicht enthalten: hohe Props, Gebäude, Bäume, Felsen, Kisten, Schilder, Türen, Tore, Pickups, Truhen, Checkpoints, Gefahren, Fallen, Türme, Leitern, Vordergrund-Verdecker, zerstörbare Objekte, Akteure, Gegner, NPCs, UI, Beschriftungen oder alles, was Kollision, Interaktion, Wiederverwendung, y-Sortierung, Animation oder eine eigene Render-Reihenfolge benötigt – generiere ein Foundation-only-Bild neu oder stufe ein solches Bild zu einem Referenz-Artefakt herab.
Referenz-Mockups sind Zwischenstopps, keine Liefergegenstände
Angezogene Referenzen (Top-Down) und Stage-Referenzen (Seitenansicht) planen die Platzierung in der Welt: natürliche Game-World-Objekte oder subtile Blockout-Geometrie, höchstens 9 deutlich sichtbare Objektkandidaten (Wiederholungen zählen einmal, dann wieder in den Platzierungsmetadaten), keine Beschriftungsgrafiken (Kreise, Pfeile, Umrisse, Beschriftungen, Text, Callouts, Legenden, Maßlinien) und keine nicht-visuellen Metadaten – Spawns, Trigger, Patrouillenhinweise, Kameragrenzen werden später als Szenen-Hooks geschrieben.
Nachdem du eine generiert hast, höre nicht auf. Fahre fort mit references/object-production-gate.md: lies erneut beide Bilder mit read_file, erstelle die Objektliste, generiere die endgültigen separaten Objekte, schreibe Platzierungs-/Kollisions-/Szenen-Hook-Metadaten, erstelle die QA-Vorschau. Die Referenz-only-Ausgabe ist ein unvollständiger Durchlauf, es sei denn, der Benutzer hat explizit nach einem Konzeptbild gefragt.
Tiefe für die gewählte Pipeline – öffne diese, bevor du Assets erzeugst
- Geschichtete Rasterkarten →
references/layered-map-contract.md(Ebenentypen, Basis- und Prop-Prompt-Muster, Prop-Metadaten, Render-Reihenfolge, Kollision, QA-Checkliste). side_scroll_mode→references/side-scroll-stages.md: diestage_canvas-Entscheidung, die benannten Szenen-nur-Parallax-Ebenen und die obligatorische In-World-Stage-Referenz vor jeder Plattform-/Objektarbeit.- Jede Prop- oder Szenenobjekt-Generierung → klassifiziere zuerst jedes Objekt, befolge dann
references/prop-pack-contract.md: Nur kompakte Props dürfen sich ein quadratisches Prop-Pack teilen; Plattformen, Böden, Brücken, Tore, Gebäude und alles Kollisionsausgerichtete werden einzeln, als Plattformstreifen, ein benutzerdefiniertes breites Pack oder Tile-/Objektebenen erstellt. - Parameter, der schrittweise Workflow und die Befehle
extract_prop_pack.py/compose_layered_preview.py→references/pipeline.md. - Lieferlisten pro Pipeline und die Validierungs-Checkliste →
references/deliverables.md; führe beide aus, bevor du eine Karte für fertig erklärst.