Generate2dsprite
Usa esta habilidad para activos de sprites 2D o animaciones autónomas en el sandbox de app-builder (TanStack Start + juegos de navegador).
Cuando un juego o prototipo jugable más grande necesite sprites, usa esta habilidad para los activos de sprites visibles y mantén el ensamblaje del juego/tiempo de ejecución por separado (integra en Phaser / Canvas / DOM después de la exportación). No reemplaces los activos de sprite solicitados con marcadores de posición dibujados con código.
Entorno de App-builder / Grok
| Elemento | Valor |
|---|---|
| Dir de habilidad | .grok/skills/generate2dsprite/ |
| Scripts | python3 .grok/skills/generate2dsprite/scripts/<script>.py … |
| Herramientas de imagen | imagine_text_to_image / imagine_image_to_image (basado en ruta; consulta la habilidad imagine para la elaboración de prompts) |
| Inspeccionar imágenes | read_file en la ruta PNG (no Codex view_image) |
| Ruta de imagen generada | imagine_text_to_image devuelve un file_path del sandbox; copia esa ruta en tu directorio de ejecución antes de procesar |
| Dependencias de Python | Pillow + numpy (preinstaladas en la imagen) |
| Directorio de salida | Prefiere assets/sprites/<name>/ bajo /workspace para que la aplicación pueda importarlos |
| Motor objetivo | Navegador: Canvas 2D, Phaser o DOM/<img> — no Godot/Unity a menos que el usuario lo solicite |
Habilidades relacionadas: imagine (uso de herramientas de imagen), game-asset-core (+ game-animation-frames / game-character-consistency para control de calidad y valores predeterminados listos para el motor), generate2dmap (mapas/accesorios), video2dsprite (movimiento más denso mediante imagine_image_to_video), building-games (bucle de juego / integración).
Parámetros
Infiera estos a partir de la solicitud del usuario:
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:autoo recuento explícitobundle: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: el tema o la dirección visual del usuariorole: solo cuando el activo es claramente un rol de PNJname: slug de salida opcional
Lee references/modes.md cuando la solicitud sea ambigua.
Reglas del Agente
- Decide el plan de activos tú mismo. No obligues al usuario a especificar el tamaño de la hoja, el recuento de fotogramas o la estructura del paquete cuando la solicitud ya los implique.
- No empaques acciones no relacionadas en una sola hoja generada en bruto solo para satisfacer un
4x4,5x5o atlas de motor personalizado. Una hoja generada en bruto debe representar una familia de acciones, una secuencia continua, una hoja de locomoción direccional canónica o un paquete de accesorios/activos. - Para héroes controlables, personajes principales y activos de jugador de alto valor con múltiples acciones, genera primero hojas de cuadrícula separadas por acción, controla la calidad de cada acción y luego ensambla el atlas requerido por el motor de manera determinista solo después de que las cuadrículas pasen la revisión visual.
- Para héroes controlables, personajes principales y acciones de cuerpo de jugador de alto valor, las hojas de cuerpo de ataque/disparo/lanzamiento predeterminadas deben ser solo del cuerpo. No incluyas grandes arcos de corte, destellos de boca, proyectiles, ráfagas de impacto, polvo desprendido, estelas largas o FX desprendidos y anchos en la hoja del cuerpo. Génere esos como hojas
fx,projectileoimpactseparadas y colócalas en capas en el juego. - Solo incluye FX de ataque ancho en la misma hoja de cuerpo en bruto cuando el tiempo de ejecución de destino admita explícitamente celdas por acción más anchas más metadatos de origen/anclaje por acción. De lo contrario, un bbox de FX ancho obligará al cuerpo a encogerse dentro de la celda fija.
- Escribe el prompt de arte tú mismo. No uses el script de construcción de prompts de forma predeterminada.
- Usa
imagine_text_to_imageincorporado para cada imagen en bruto. - No crees sprites en bruto con Three.js, Canvas, SVG, dibujo HTML/CSS, dibujo de formas PIL, geometría procesal, primitivas de marcador de posición o capturas de pantalla renderizadas por código. El código de tiempo de ejecución puede mostrar activos generados finalizados y los scripts pueden hacer guías de diseño o posprocesar imágenes generadas, pero el arte de sprite solicitado debe originarse de
imagine_text_to_imageincorporado. - Cuando el usuario proporcione o implique una referencia visual, pasa el
file_pathdel sandbox de esa referencia aimagine_image_to_image(la herramienta lee el archivo). También usaread_fileen la referencia local para que puedas verla; una ruta mencionada solo dentro del prompt no es una entrada visual. - No fuerces el pixel art cuando el activo sea un accesorio de mapa para
$generate2dmapo cuando el usuario/proyecto solicite un estilo diferente. Primero, coincide con el estilo del mapa o la referencia. - Usa el script solo como un procesador determinista: limpieza magenta, división de fotogramas, filtrado de componentes, escalado, alineación, metadatos de control de calidad, exportación de hojas transparentes y exportación GIF.
- No uses scripts para generar el prompt de imagen creativo. Si existe un comando de construcción de prompts heredado, trátalo solo como compatibilidad histórica, no como el flujo de trabajo normal de la habilidad.
- Las guías de diseño solo están permitidas como referencias de geometría deterministas para la generación de imágenes. Pueden mostrar el recuento de ranuras, el espaciado, el centrado y el relleno seguro, pero nunca deben definir la dirección artística creativa.
- Trata las banderas de script como primitivas de ejecución elegidas por el agente, no un flujo de trabajo codificado orientado al usuario.
- Si una hoja generada toca los bordes de las celdas, se desplaza en escala o rompe un bucle de proyectil/impacto, reprocésala con mejores configuraciones primitivas o regenera la hoja en bruto.
- No uses hojas en bruto de una sola fila como
1x4,1x6,1x8o1xNpara personajes, jugadores, héroes controlables, criaturas, PNJ, enemigos, invocaciones, accesorios animados o cualquier activo donde un cuerpo/sujeto deba permanecer centrado. Es demasiado probable que la generación en bruto de una sola fila se desplace horizontalmente y recorte de manera inconsistente. - Para activos de cuerpo animado, usa una cuadrícula de varias filas de forma predeterminada: 4 fotogramas ->
2x2, 6 fotogramas ->2x3, 8 fotogramas ->2x4, 9 fotogramas ->3x3, 12 fotogramas ->3x4o4x3, 16 fotogramas ->4x4. - Si un motor de juego necesita una tira final de una sola fila o un atlas mixto, primero genera y controla la calidad de la acción como una cuadrícula de varias filas, luego ensambla la tira/atlas de entrega de manera determinista.
- En cada prompt de cuadrícula de cuerpo animado, exige que el cuerpo del sujeto permanezca centrado en cada celda, cuerpo completo dentro del área segura central del 60% al 70%, escala consistente en todas las celdas, línea de anclaje de pies/parte inferior estable cuando sea aplicable, y sin extremidades, armas, cabello, capas, polvo, destellos de boca o FX desprendidos que crucen los bordes de las celdas.
- Para prompts de cuerpo de ataque de héroe, exige explícitamente que la altura del cuerpo y la escala del cuerpo coincidan con las hojas de idle/correr aceptadas, anclaje de pies/parte inferior estable, arma mantenida lo suficientemente cerca para no ensanchar el bbox del cuerpo y sin arco de corte desprendido o efecto de ataque en espacio de pantalla.
- Para paquetes de accesorios de mapa, clasifica los accesorios antes de elegir una cuadrícula. Los paquetes cuadrados
2x2,3x3y4x4son solo para accesorios compactos. No pongas plataformas, pisos, puentes, paredes, escaleras, puertas, portones, peligros largos, accesorios anchos/altos, objetos con colisión o piezas de tileset/tira en paquetes de accesorios cuadrados; usa uno por uno, tiras1x3/1x4, celdas anchas personalizadas o un atlas tipo tileset. - Mantén la regla de fondo sólido
#FF00FFa menos que el usuario quiera explícitamente un flujo de trabajo de procesamiento diferente.
Flujo de trabajo
1. Inferir el plan de activos
Elige la salida útil más pequeña.
Ejemplos:
- héroe controlable con cuatro direcciones ->
player+player_sheet - héroe controlable en vista lateral con idle/correr/disparar/saltar ->
player+hero_action_bundle- hoja de cuadrícula idle, normalmente
2x2para 4 fotogramas - hoja de cuadrícula correr, normalmente
2x2o2x3dependiendo del recuento de fotogramas necesario - hoja de cuadrícula disparar solo con cuerpo/arma, normalmente
2x2 - hoja de cuadrícula saltar, normalmente
2x2 - proyectil / destello de boca como activos separados cuando sea necesario
- atlas de motor ensamblado opcional después del control de calidad por acción
- hoja de cuadrícula idle, normalmente
- héroe controlable en vista lateral con ataque cuerpo a cuerpo ->
player+hero_action_bundle- hoja de cuadrícula de cuerpo de ataque, normalmente
2x2o2x3, solo cuerpo - arco de corte / estela de arma como hoja
fxseparada cuando el ataque necesita un efecto visual amplio - chispa de impacto como hoja
impactseparada cuando los golpes necesitan retroalimentación
- hoja de cuadrícula de cuerpo de ataque, normalmente
- PNJ de mundo abierto sanador ->
npc+single_assetounit_bundle - bucle idle de jefe grande ->
creature+idle+3x3 - mago lanzando un orbe mágico ->
spell_bundle- hoja de lanzamiento del lanzador
- bucle de proyectil
- ráfaga de impacto
- solicitud de línea de monstruos ->
line_bundle- planea 1-3 formas
- por forma, haz las hojas que la solicitud realmente necesita
2. Escribe el prompt manualmente
Usa references/prompt-rules.md.
Elige art_style antes de escribir el prompt:
- Usa
pixel_artoretro_pixelpara sprites clásicos, actores RPG de 16 bits y solicitudes que pidan explícitamente pixel art. - Usa
clean_hdpara accesorios de mapa o activos destinados a coincidir con mapas HD pintados a mano y limpios. - Usa
pixel_inspiredsolo cuando el usuario quiera un aspecto cercano al pixel sin la pesadez retro. - Usa
map_styleoproject-nativecuando un mapa, juego o referencia existente deba definir el estilo.
Si hay una referencia involucrada:
- Conecta la referencia en la llamada: pasa su
file_pathdel sandbox aimagine_image_to_image— o la lista de rutas aimagine_reference_to_imagepara 2+ referencias (las imágenes generadas ya tienen unfile_path; los archivos locales usan su ruta de sandbox). También usaread_fileen las referencias locales para que puedas verlas. - Indica el rol de la referencia explícitamente: conservar la identidad/estilo, crear una hoja de animación para el mismo sujeto, crear una evolución/variante o derivar un accesorio/FX coincidente.
- Conserva los marcadores de identidad estables de la referencia: silueta, paleta, rasgos faciales/de ojos, marcas de vestuario, accesorios principales y lenguaje de materiales.
- Deja que solo la acción o evolución solicitada cambie. No rediseñes el sujeto a menos que el usuario lo pida.
- Aún exige la forma exacta de la hoja, el fondo magenta sólido, la contención de fotogramas y la misma escala en todos los fotogramas.
Mantén las partes estrictas:
- fondo
#FF00FFsólido - forma exacta de la hoja
- misma identidad de personaje o activo en todos los fotogramas
- mismo cuadro delimitador y escala de píxeles en todos los fotogramas
- contención explícita: nada puede cruzar los bordes de las celdas
Barandilla de atlas de acción mixta:
- No le pidas a
imagine_text_to_imageque genere filas de acciones no relacionadas en una sola hoja en bruto, comofila 1 idle, fila 2 correr, fila 3 disparar, fila 4 saltar, para un héroe controlable o personaje principal. - No le pidas a
imagine_text_to_imageque genere tiras de acción en bruto de una sola fila como1x4 idle,1x4 correr,1x4 dispararo1x4 saltarpara un héroe controlable, personaje, criatura, PNJ, enemigo, invocación o accesorio animado. - Si un motor necesita un
4x4,5x5, atlas personalizado o formato de entrega de tira de fila combinado, genera las cuadrículas de acción por separado, procésalas y controla su calidad por separado, luego ensambla el atlas de entrega de manera determinista. - Las excepciones son las hojas de locomoción direccional canónicas, una secuencia de acción larga y continua, paquetes de accesorios, atlas tipo tileset y hojas de combate de enemigos compactas de bajo riesgo. Estos aún necesitan un prompt coherente y control de calidad visual.
- Mantén los proyectiles, destellos de boca, impactos, estelas de polvo y FX desprendidos en hojas separadas a menos que sean intencionalmente parte de la misma silueta de acción y permanezcan firmemente unidos.
- Para héroes controlables y personajes principales, "firmemente unido" no es suficiente cuando el efecto hace que el bbox de la acción sea mucho más ancho o más alto que idle/correr. Divide los arcos de corte anchos, destellos de boca, estelas de arma largas, nubes de polvo y ráfagas de impacto en hojas FX separadas de forma predeterminada.
Barandilla de cuadrícula de cuerpo animado:
- Las hojas en bruto de una sola fila como
1x4no son valores predeterminados válidos para cuerpos animados. Esto incluye jugadores, héroes controlables, criaturas, PNJ, enemigos, invocaciones, accesorios animados y acciones de combate con cuerpo adjunto. - Usa
2x2para acciones de cuerpo de 4 fotogramas. Este es el valor predeterminado para idle, ataque corto, cuerpo de disparo, salto, daño, flotación y acciones compactas de caminar/correr en vista lateral. - Usa
2x3para acciones de cuerpo de 6 fotogramas como lanzamiento, ataque, invocación, correr, carga o transformación. - Usa
2x4,3x3,3x4o4x4para acciones de cuerpo más largas. Prefiere una cuadrícula compacta sobre una fila larga. - Para caminar en 4 direcciones de arriba hacia abajo,
4x4puede seguir siendo una forma de generación en bruto porque es una hoja de locomoción direccional canónica, no cuatro filas de acción no relacionadas. - Si el tiempo de ejecución final necesita una tira de fila, ensámblala después del control de calidad a partir de los fotogramas de cuadrícula de varias filas procesados.
- Mantén el personaje centrado en cada celda. La línea central del cuerpo debe permanecer cerca del centro de la celda, el anclaje de pies/parte inferior debe permanecer en la misma posición y cuando sea visible, y el sujeto debe ocupar solo el área segura central con un generoso relleno magenta.
- Para ataque, disparo, lanzamiento, carga y otras acciones de cuerpo, la altura del cuerpo debe mantenerse cerca de la altura del cuerpo de idle/correr aceptada. Si se usa un tiempo de ejecución de celda fija, rechaza la salida de acción de cuerpo cuando el cuerpo parezca más de aproximadamente un 10-15% más pequeño que idle/correr, incluso si
edge_touch_framesestá vacío.
Barandilla de paquete de accesorios de mapa:
- Usa paquetes de accesorios en bruto cuadrados
2x2,3x3y4x4solo para accesorios compactos como rocas, arbustos, barriles, cajas, lámparas, letreros pequeños, macetas, escombros y adornos pequeños. - No uses paquetes de accesorios cuadrados para objetos de mapa anchos o críticos para la colisión: pisos, plataformas, repisas, trozos de terreno, puentes, tramos de pared, escaleras, carreteras, rieles, tuberías, trampas de púas largas, portones, puertas, edificios, árboles grandes, puntos de control, salidas o plataformas de construcción.
- Usa generación uno por uno para accesorios únicos, grandes, importantes, altos, irregulares o alineados con la colisión.
- Usa tiras
1x3o1x4para activos de plataforma/piso repetibles, con límite izquierdo, repetición media, límite derecho y variante opcional de pendiente/esquina/final. - Usa celdas anchas personalizadas para múltiples variantes.