Generate2dmap
Entorno App-builder / Grok
| Elemento | Valor |
|---|---|
| Directorio / scripts del skill | .grok/skills/generate2dmap/, ejecutar como python3 .grok/skills/generate2dmap/scripts/<script>.py … |
| Herramientas de imagen | imagine_text_to_image / imagine_image_to_image (basadas en rutas; consulta imagine); inspecciona la salida con read_file sobre la ruta PNG (no Codex view_image) |
| Ruta de imagen generada | imagine_text_to_image → file_path del sandbox → copiar en assets/map/; Pillow ya está preinstalado |
engine_target por defecto | raw_canvas o Phaser para este sandbox del navegador TanStack — solo usar Godot/Unity/Tiled cuando el usuario pida explícitamente esas exportaciones |
| Skills relacionados | generate2dsprite (sprites de personajes/FX; los paquetes de props siguen usando el script de extracción de este skill), building-games, imagine |
Decide primero el pipeline
Construye el paquete de mapa jugable más pequeño que satisfaga el juego: elige un map_mode a nivel de producto, luego los ejes de nivel inferior (visual_model, runtime_object_model, collision_model, engine_target).
tile_mode— mapas editables de cuadrícula/tiles: rutas tipo Pokémon, pueblos de RPG en vista superior, tilemaps de plataformas, o cualquier proyecto que ya use tilemaps de Tiled/LDtk/Godot/Unity/Phaser.scene_mode— base de fondo más props separados: torres de defensa, arenas tipo survivors, mapas acogedores de exhibición en vista superior.side_scroll_mode— escenarios de desplazamiento lateral con paralaje: tipo Mega Man, plataformas de acción, salas de Metroidvania, runners, beat 'em ups.grid_mode— cuadrículas con muchas reglas: RPGs tácticos, fábricas/automatización, juegos de cartas/tablero, cuadrículas de construcción.room_chunk_mode— salas/módulos modulares: mazmorras tipo roguelike, redes de Metroidvania, ensamblaje procedural.baked_scene_mode— escenas explícitamente planas y no jugables: solo pantallas de título/menú, fondos de batalla, escenas de novelas visuales, arte conceptual.
Usa los parámetros especificados por el usuario cuando estén presentes; de lo contrario, infiere el pipeline jugable más ligero a partir del juego existente, la cámara, las necesidades de colisión, la escala del mapa y las necesidades de edición. Cuando el modo y los ejes no coincidan, el contrato de jugabilidad/edición del modo tiene prioridad. El enrutamiento por género, los valores predeterminados por modo, los ajustes preestablecidos y la heurística de escalado están en references/map-strategies.md — léelo siempre que la elección no sea obvia.
Un mapa jugable nunca es una sola imagen horneada. Para cualquier solicitud que implique un mapa jugable, nivel, escenario, sala, prototipo o escena de motor, el entregable debe exponer la geometría y los objetos del juego como capas separadas, props, datos de tiles/objetos, colisiones, zonas o nodos de escena nativos del motor. Una imagen horneada puede ser un fondo, referencia o artefacto de vista previa — nunca el mapa de ejecución — a menos que el usuario haya solicitado explícitamente solo un fondo plano.
Solo escenas y mapas. No generes aquí sprites de personajes, enemigos, jefes, PNJ, jugador, proyectiles o animaciones; esos pertenecen a $generate2dsprite. Los mapas llevan ganchos de escena (marcadores de aparición, zonas de patrulla/encuentro, entradas de arena, puertas, salidas, disparadores de cámara) como metadatos, no como arte dibujado.
El arte proviene de la generación de imágenes, y tú escribes los prompts
imagine_text_to_imagees la fuente de arte predeterminada para mapas base, láminas de paralaje, referencias, hojas de props y arte de tilesets. Elart_stylepredeterminado esclean_hd(HD pintado a mano, formas nítidas y legibles, bajo ruido de textura, sin píxeles gruesos); usapixel_inspiredoretro_pixelsolo cuando se solicite.- Escribe tú mismo cada prompt creativo. Los scripts pueden ensamblar, dividir, hacer croma, recortar, validar, componer vistas previas y emitir JSON/archivos de motor — nunca escriben prompts creativos ni dibujan arte final. Arte procedural/de relleno solo cuando el usuario solicite explícitamente marcadores de posición, accesorios, mapas de depuración o andamios. Con un objetivo de motor de tiles, genera primero el arte del tileset, luego scriptea solo las capas, colisiones, zonas y cableado de la escena.
- Guarda cada prompt junto a su activo como
<asset>.prompt.txt(o un campo explícito en el manifiesto) cada vez que la ejecución cree nuevos activos visuales. - Una transferencia de referencia es una ruta de archivo, no una frase. Para construir sobre una imagen anterior, pasa su
file_pathdel sandbox aimagine_image_to_image(y hazread_filepara poder verla), luego nombra las características concretas a conservar: encuadre de cámara, horizonte, formas de caminos/agua, límites del terreno, entradas/salidas, puntos de referencia. Un nombre de archivo, "basado en el mapa", o que la imagen sea meramente visible en la conversación no es una transferencia — detente y pasa la ruta.
Mantén los objetos de ejecución fuera de la capa base
La primera imagen base/fondo/fundación generada puede contener solo arte de fundación estable y no interactivo — material del suelo, caminos, carreteras, agua, acantilados, patrones de suelo, marcas de carril y almohadillas de construcción; para vistas laterales, cielo, paisaje lejano/medio, siluetas, atmósfera; para tilemaps, arte de tileset como capas editables. No debe contener props altos, edificios, árboles, rocas, cajas, carteles, puertas, puertas de entrada, recogibles, cofres, puntos de control, peligros, trampas, torretas, escaleras, oclusores de primer plano, destructibles, actores, enemigos, PNJ, IU, etiquetas ni nada que necesite colisión, interacción, reutilización, ordenamiento y, animación o su propio orden de renderizado — regenera una base solo de fundación, o degrada dicha imagen a un artefacto de referencia.
Las referencias maquetadas son puntos de control, no entregables
Las referencias vestidas (vista superior) y las referencias de escenario (vista lateral) planifican la colocación en el mundo: objetos naturales del mundo del juego o geometría sutil de bloqueo, con como máximo 9 candidatos de objetos visibles distintos (las repeticiones cuentan una vez, luego se repiten en los metadatos de colocación), sin gráficos de anotación (círculos, flechas, contornos, etiquetas, texto, leyendas, líneas de medición), y sin metadatos no visuales — las apariciones, disparadores, indicaciones de patrulla, límites de cámara se escriben más tarde como ganchos de escena.
Habiendo generado una, no te detengas ahí. Continúa con references/object-production-gate.md: vuelve a read_file ambas imágenes, construye la lista de objetos, genera los objetos separados finales, escribe los metadatos de colocación/colisión/gancho de escena, compone la vista previa de control de calidad. La salida solo de referencia es una ejecución incompleta a menos que el usuario haya solicitado explícitamente una imagen conceptual.
Profundidad para el pipeline elegido — abre estos antes de producir activos
- Mapas ráster en capas →
references/layered-map-contract.md(tipos de capa, patrones de prompt para base y props, metadatos de props, orden de renderizado, colisión, lista de verificación de QA). side_scroll_mode→references/side-scroll-stages.md: la decisión destage_canvas, las capas de paralaje solo de escenario nombradas, y la referencia de escenario en el mundo obligatoria antes de cualquier trabajo de plataforma/objeto.- Cualquier generación de props u objetos de escena → clasifica cada objeto primero, luego sigue
references/prop-pack-contract.md: solo los props compactos pueden compartir un paquete de props cuadrado; las plataformas, pisos, puentes, puertas, edificios y cualquier cosa alineada con colisiones van uno por uno, como una tira de plataforma, un paquete ancho personalizado o capas de tiles/objetos. - Parámetros, el flujo de trabajo paso a paso y los comandos de
extract_prop_pack.py/compose_layered_preview.py→references/pipeline.md. - Listas de entregables por pipeline y la lista de verificación de validación →
references/deliverables.md; ejecuta ambas antes de dar el mapa por terminado.