CommunityImagengithub.com

sprite-forge

Genera arte 2D para juegos localmente y gratis: sprites, accesorios, objetos, íconos y elementos de UI con fondos transparentes, píxel art real (cuadrícula real, paleta limitada), personajes con giros de 4/8 direcciones y hojas de animación (caminar, correr, reposo, ataque...), animar un sprite de píxel existente a partir de una descripción, mapas normales para iluminación 2D, mosaicos sin costuras, retratos y fotogramas de VFX, todo como PNGs, GIFs y atlas JSON para TexturePacker/Phaser listos para el juego.

¿Qué es sprite-forge?

Sprite Forge es una habilidad de agente de IA que permite generar, animar y editar activos 2D para videojuegos, todo ejecutándose localmente en la GPU de la máquina (utilizando ComfyUI como backend). No requiere servicios de pago ni envío de datos externos. El flujo de trabajo incluye la creación de sprites, personajes, mapas normales, mosaicos, retratos y animaciones, con soporte para múltiples formatos de salida como PNG, GIF y atlas JSON de TexturePacker/Phaser. Los resultados se recortan, redimensionan y verifican automáticamente, seleccionando la mejor toma entre varias. Admite píxel art real mediante detección de cuadrícula y limitación de paletas, y puede animar sprites de píxel existentes a partir de descripciones textuales. Funciona a través de herramientas MCP (`sprite-forge`) o línea de comandos, con perfiles configurables (`sprite`, `icon`, `pixel_sprite`, `character`, `turnaround`, `animation`, `tile`, `portrait`, `vfx`, etc.) y soporte para proyectos con estilos consistentes mediante archivos `spriteforge.json`.

Compatible con~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 Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sprite Forge

Sprite Forge convierte texto en activos 2D listos para juegos en la GPU de esta máquina (ComfyUI subyacente; se inicia automáticamente). No se envía nada a un servicio de pago. Cada resultado se recorta con un borde limpio, se recuadra, se dimensiona, se verifica y se guarda con un manifiesto; se realizan varias tomas y se conserva la mejor.

Cómo llamarlo

Prefiere las herramientas MCP sprite-forge cuando estén disponibles: list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status.

De lo contrario, usa la línea de comandos desde la carpeta de Sprite Forge; cada comando imprime un objeto JSON:

python forge.py profiles
python forge.py sprite  <nombre> "<prompt>" -p sprite --project <carpeta del juego>
python forge.py sprite  <nombre> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <carpeta del juego>
python forge.py character <id> "<quién, vestimenta, colores, accesorios>" --project <carpeta del juego>
python forge.py sprite  <nombre> -p turnaround --character <id> --set directions=8 --project <carpeta del juego>
python forge.py sprite  <nombre> -p animation  --character <id> --set action=walk --set facing=right --project <carpeta del juego>
python forge.py animate <nombre> <sprite.png> "<el movimiento>" --pose "<fotograma 1>" --pose "<fotograma 2>" ...
python forge.py normal  <sprite.png>
python forge.py check   <archivo.png> --kind sprite

Código de salida 0 = correcto, 2 = terminado pero el resultado no pasó su verificación, 1 = error.

Elige el perfil

PerfilParaSalida
spriteaccesorios, objetos, recogibles, armas, muebles, piezas de UIPNG transparente, recortado, centrado en un lienzo cuadrado
iconíconos de habilidades/objetos, insignias, botonesPNG cuadrado más versiones de 256/128/64 px
pixel_spritepíxel art real: personajes, objetos, enemigoscuadrícula de píxel real (ej. 32 px), alfa duro, paleta limitada o nombrada, más una vista previa x8
characteruna referencia de personaje reutilizablePNG transparente de cuerpo completo, pies en la línea del suelo
pixel_characterlo mismo, dibujado en estilo píxel artreferencia para hojas de píxel art
turnaroundel personaje mirando en 4 u 8 direccionesfotogramas + <nombre>_sheet.png + <nombre>.atlas.json
animationcaminar, correr, reposo, atacar, saltar, daño, muerte, lanzar hechizosfotogramas + hoja + atlas con una etiqueta de animación
tilesuelo, paredes, pisos, agua, follajetextura cuadrada sin costuras + vista previa en mosaico 3x3 (versión de píxel opcional)
portraitretratos de diálogo, cartas, arte claveimagen a resolución completa
vfxexplosiones, humo, explosiones mágicas, chispas de impactofotogramas + hoja + atlas; el brillo es transparencia
animate_pixel (herramienta)animar un sprite de píxel EXISTENTE a partir de una descripciónfotogramas en la propia cuadrícula y paleta del sprite + hoja + atlas + GIF

Cada hoja también obtiene <nombre>.gif (bucles) para que el usuario pueda verla.

Cada uno tiene tres preajustes: fast (una toma rápida), standard (el predeterminado), max (modelo más grande o más tomas; Qwen-Image-Edit para giros/animaciones). Indica qué preajuste usaste.

Flujo de trabajo

  1. Siempre pasa la carpeta del proyecto del juego (project_dir / --project). Su spriteforge.json proporciona el estilo, la carpeta de salida, la carpeta de personajes y la configuración por perfil, para que el arte de un juego sea consistente. Si no tiene ninguno, ofrece crear uno (forge.py init <dir>).
  2. Escribe el prompt como lo indica la prompt_guide del perfil (list_profiles lo devuelve). Describe la cosa, no la imagen: sin "un sprite de", sin fondo, sin palabras de cámara en el prompt – establece el ángulo con params.view (front view, side view, top-down view, isometric view).
  3. Personajes que aparecen más de una vez: créalos primero. create_character (o el perfil character con character configurado) guarda una referencia; los giros y animaciones son ediciones de él, por lo que el personaje mantiene una apariencia. Para hojas de píxel art usa profile: "pixel_character" y pasa params.pixel_grid (ej. 32) a la hoja.
  4. Los trabajos más largos son asíncronos. Si una herramienta devuelve un id de trabajo, llama a get_job con wait_seconds: 50 hasta que el estado no sea queued o running. Un trabajo a la vez.
  5. Mira la vista previa. Cada resultado viene con una imagen de vista previa (sprites sobre un tablero de ajedrez). Verifícala antes de dar el activo por terminado: sujeto incorrecto, parte cortada, un segundo objeto, un halo, un fotograma que no es el mismo personaje. Reporta el archivo, su tamaño, cualquier problems y menciona las otras tomas en .spriteforge/<nombre>/.

Píxel art

  • Los modelos de imagen solo dibujan estilo píxel art; Sprite Forge lo hace real: encuentra la cuadrícula de píxel del modelo (o fuerza grid), toma el color dominante de cada celda, elimina píxeles perdidos, hace que el alfa sea completamente encendido/apagado y limita la paleta. Nunca afirmes que un sprite es píxel art sin este paso.
  • grid: el lado más largo del sprite en píxeles (16, 24, 32, 48, 64). "auto" conserva el tamaño de píxel que dibujó el modelo.
  • palette: pico8, gameboy, nes, endesga32, sweetie16, una lista de colores hexadecimales, o "project" – una paleta congelada para todo el juego (guardada como palette.hex en el proyecto por el primer activo de píxel, reutilizada por cada uno posterior). Usa "project" para un juego.
  • outline: true agrega un contorno oscuro de 1 píxel; canvas: 32 coloca el sprite en una cuadrícula de 32x32.
  • No se aplica tramado (parpadea en animación).

Animar un sprite de píxel existente

Usa animate_pixel cuando el usuario ya tiene un sprite de píxel (el suyo propio, o uno hecho con pixel_sprite) y describe un movimiento: "haz que el slime rebote", "anima al caballero balanceando su espada". Mantiene el tamaño de píxel exacto y la paleta del sprite en cada fotograma.

  • image: el PNG (tamaño nativo de hasta 256 px, o una copia ampliada con píxeles duros).
  • description: el movimiento. walk / run / idle / attack / jump / hurt / death / cast usan poses clave incorporadas.
  • Escribe poses tú mismo para cualquier otra cosa: una línea corta por fotograma que indique qué cambia, ej. para un balanceo de espada ["levantando la espada en alto sobre su cabeza", "la espada en la parte superior, cuerpo inclinado hacia atrás", "balanceando la espada hacia abajo frente a él", "la espada baja después del golpe"]. 3-6 fotogramas se leen mejor. Estas son poses clave, no interpolaciones.
  • params.include_original: true coloca el sprite intacto como fotograma 0; params.fps.
  • Mira el GIF / vista previa: si un fotograma perdió parte del sprite o lo cambió, vuelve a ejecutar con una nueva seed o preset: "max" (más tomas por fotograma).

Mapas normales (iluminación 2D)

Para juegos con luces 2D (Godot CanvasTexture + Light2D, luces 2D de Unity, light2d de Phaser), pasa params.normal_map: true a sprite, icon, pixel_sprite, character, turnaround, animation o animate_pixel, o llama a make_normal_map en cualquier PNG existente.

  • Escribe <nombre>_normal.png (o <nombre>_sheet_normal.png, con el mismo diseño que la hoja) y <nombre>_lit_preview.png (el sprite iluminado desde la izquierda, arriba, derecha y abajo) – muestra al usuario la vista previa.
  • El píxel art conserva su cuadrícula de píxel con normales nítidas y ajustadas.
  • La convención predeterminada es OpenGL (verde = arriba), que Godot y Unity esperan; normal_y: "down" / y: "down" para DirectX. normal_strength 0.5 sutil – 2 fuerte.
  • El relieve se infiere del dibujo (contorno, regiones de color, reflejos), no se modela: se lee bien bajo luces en movimiento pero no es un escaneo de profundidad real.

Cuando el resultado dice failed_check

El archivo está escrito pero no debe usarse tal cual. problems explica por qué.

ProblemaSolución
cut offVuelve a ejecutar con una nueva seed; agrega "pequeño, centrado, con espacio alrededor" o aumenta params.padding.
several objectsNombra solo un objeto; vuelve a ejecutar con una nueva seed.
background not removed / emptyDescribe un objeto sólido; mantén background simple; vuelve a ejecutar.
may not look like the character (hojas)Vuelve a ejecutar esa hoja con una nueva seed o preset: "max"; mantén el prompt del personaje simple.
may not have turned (turnaround)Vuelve a ejecutar con preset: "max" (Qwen-Image-Edit sigue mejor los cambios de vista).
no clear pixel grid foundLa imagen no se dibujó como píxel art: establece grid a un número, o vuelve a ejecutar.
visible seam (tile)Usa una superficie orgánica o aumenta params.blend; vuelve a ejecutar.
much smaller than the original (animate_pixel)Ese fotograma perdió parte del sprite: vuelve a ejecutar con una nueva seed o da una pose más clara.
flat: almost a single colourEl modelo dibujó una silueta: vuelve a ejecutar con una nueva seed; di "en color completo".

Mismo nombre + mismas configuraciones devuelve el archivo existente; cambia una configuración, la seed, o pasa force: true para crear uno nuevo.

Personalización

  • Por proyecto: spriteforge.json (style, style_preset, output_dir, characters_dir, profiles.<id>.params, ej. {"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}}).
  • Por llamada: params, ej. {"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}. list_profiles enumera cada parámetro con una explicación.
  • Nuevo perfil: un pequeño archivo JSON en la carpeta spriteforge_profiles/ del proyecto que extends uno.
  • Modelos y hardware: la herramienta models informa qué necesita cada perfil y preajuste y qué falta. Las descargas son grandes – pregunta al usuario antes de instalar.
  • Licencias: cada modelo que Sprite Forge instala permite uso comercial de lo que creas (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511 y el LoRA de píxel: Apache 2.0; BiRefNet y CLIP: MIT). Algunas tiendas (ej. Steam, itch.io) te piden que reveles activos hechos con IA.

Skills relacionados