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
| Perfil | Para | Salida |
|---|---|---|
sprite | accesorios, objetos, recogibles, armas, muebles, piezas de UI | PNG transparente, recortado, centrado en un lienzo cuadrado |
icon | íconos de habilidades/objetos, insignias, botones | PNG cuadrado más versiones de 256/128/64 px |
pixel_sprite | píxel art real: personajes, objetos, enemigos | cuadrícula de píxel real (ej. 32 px), alfa duro, paleta limitada o nombrada, más una vista previa x8 |
character | una referencia de personaje reutilizable | PNG transparente de cuerpo completo, pies en la línea del suelo |
pixel_character | lo mismo, dibujado en estilo píxel art | referencia para hojas de píxel art |
turnaround | el personaje mirando en 4 u 8 direcciones | fotogramas + <nombre>_sheet.png + <nombre>.atlas.json |
animation | caminar, correr, reposo, atacar, saltar, daño, muerte, lanzar hechizos | fotogramas + hoja + atlas con una etiqueta de animación |
tile | suelo, paredes, pisos, agua, follaje | textura cuadrada sin costuras + vista previa en mosaico 3x3 (versión de píxel opcional) |
portrait | retratos de diálogo, cartas, arte clave | imagen a resolución completa |
vfx | explosiones, humo, explosiones mágicas, chispas de impacto | fotogramas + hoja + atlas; el brillo es transparencia |
animate_pixel (herramienta) | animar un sprite de píxel EXISTENTE a partir de una descripción | fotogramas 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
- Siempre pasa la carpeta del proyecto del juego (
project_dir/--project). Suspriteforge.jsonproporciona 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>). - Escribe el prompt como lo indica la
prompt_guidedel perfil (list_profileslo devuelve). Describe la cosa, no la imagen: sin "un sprite de", sin fondo, sin palabras de cámara en el prompt – establece el ángulo conparams.view(front view,side view,top-down view,isometric view). - Personajes que aparecen más de una vez: créalos primero.
create_character(o el perfilcharacterconcharacterconfigurado) 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 usaprofile: "pixel_character"y pasaparams.pixel_grid(ej. 32) a la hoja. - Los trabajos más largos son asíncronos. Si una herramienta devuelve un id de trabajo, llama a
get_jobconwait_seconds: 50hasta que el estado no seaqueuedorunning. Un trabajo a la vez. - 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
problemsy 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 comopalette.hexen el proyecto por el primer activo de píxel, reutilizada por cada uno posterior). Usa"project"para un juego.outline: trueagrega un contorno oscuro de 1 píxel;canvas: 32coloca 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
posestú 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: truecoloca 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
seedopreset: "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_strength0.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é.
| Problema | Solución |
|---|---|
cut off | Vuelve a ejecutar con una nueva seed; agrega "pequeño, centrado, con espacio alrededor" o aumenta params.padding. |
several objects | Nombra solo un objeto; vuelve a ejecutar con una nueva seed. |
background not removed / empty | Describe 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 found | La 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 colour | El 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_profilesenumera cada parámetro con una explicación. - Nuevo perfil: un pequeño archivo JSON en la carpeta
spriteforge_profiles/del proyecto queextendsuno. - Modelos y hardware: la herramienta
modelsinforma 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.