O que Sprite Forge faz?
Sprite Forge transforma texto em assets 2D prontos para jogos na GPU desta máquina (ComfyUI por baixo; ele é iniciado automaticamente). Nada é enviado para um serviço pago. Cada resultado é recortado com borda limpa, cropado, redimensionado, verificado e salvo com um manifesto; várias tentativas são feitas e a melhor é mantida.
Como chamá-lo
Prefira as ferramentas MCP sprite-forge quando estiverem disponíveis:
list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status.
Caso contrário, use a linha de comando a partir da pasta Sprite Forge; cada comando imprime um objeto JSON:
python forge.py profiles
python forge.py sprite <nome> "<prompt>" -p sprite --project <pasta do jogo>
python forge.py sprite <nome> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <pasta do jogo>
python forge.py character <id> "<quem, roupa, cores, props>" --project <pasta do jogo>
python forge.py sprite <nome> -p turnaround --character <id> --set directions=8 --project <pasta do jogo>
python forge.py sprite <nome> -p animation --character <id> --set action=walk --set facing=right --project <pasta do jogo>
python forge.py animate <nome> <sprite.png> "<o movimento>" --pose "<quadro 1>" --pose "<quadro 2>" ...
python forge.py normal <sprite.png>
python forge.py check <arquivo.png> --kind sprite
Código de saída 0 = ok, 2 = terminou, mas o resultado falhou na verificação, 1 = erro.
Escolha o perfil
| Perfil | Para | Saída |
|---|---|---|
sprite | props, itens, pickups, armas, móveis, peças de UI | PNG transparente, cropado, centralizado em uma tela quadrada |
icon | ícones de habilidades / itens, emblemas, botões | PNG quadrado mais versões 256/128/64 px |
pixel_sprite | pixel art verdadeiro: personagens, itens, inimigos | grade de pixel real (ex.: 32 px), alfa duro, paleta limitada ou nomeada, mais uma prévia x8 |
character | uma referência de personagem reutilizável | PNG corpo inteiro transparente, pés na linha do chão |
pixel_character | o mesmo, desenhado em estilo pixel art | referência para folhas pixel art |
turnaround | o personagem virado para 4 ou 8 direções | quadros + <nome>_sheet.png + <nome>.atlas.json |
animation | andar, correr, parado, ataque, pular, machucado, morte, lançar feitiço | quadros + folha + atlas com uma tag de animação |
tile | chão, paredes, pisos, água, folhagem | textura quadrada contínua + uma prévia em grade 3x3 (versão pixel opcional) |
portrait | retratos de diálogo, cards, arte chave | imagem em resolução total |
vfx | explosões, fumaça, rajadas mágicas, faíscas de ataque | quadros + folha + atlas; brilho é transparência |
animate_pixel (ferramenta) | animar um sprite pixel EXISTENTE a partir de uma descrição | quadros na grade e paleta do próprio sprite + folha + atlas + GIF |
Cada folha também ganha <nome>.gif (loops) para que o usuário possa assisti-la.
Cada um tem três predefinições: fast (uma tentativa rápida), standard (o padrão), max (modelo
maior ou mais tentativas; Qwen-Image-Edit para turnarounds/animação). Diga qual predefinição você usou.
Fluxo de trabalho
- Sempre passe a pasta do projeto do jogo (
project_dir/--project). Seuspriteforge.jsonfornece o estilo, pasta de saída, pasta de personagens e configurações por perfil, para que a arte do jogo permaneça consistente. Se não tiver nenhum, ofereça criar um (forge.py init <dir>). - Escreva o prompt como o
prompt_guidedo perfil diz (list_profileso retorna). Descreva a coisa, não a imagem: sem "um sprite de", sem fundo, sem palavras de câmera no prompt – defina o ângulo comparams.view(frente,lateral,vista superior,vista isométrica). - Personagens que aparecem mais de uma vez: crie-os primeiro.
create_character(ou o perfilcharactercomcharacterdefinido) salva uma referência; turnarounds e animações são edições dela, então o personagem mantém uma aparência. Para folhas pixel art useprofile: "pixel_character"e passeparams.pixel_grid(ex.: 32) para a folha. - Trabalhos mais longos são assíncronos. Se uma ferramenta retornar um id de trabalho, chame
get_jobcomwait_seconds: 50até que o status não sejaqueuedourunning. Um trabalho por vez. - Olhe a prévia. Todo resultado vem com uma imagem de prévia (sprites em um
tabuleiro de xadrez). Verifique-a antes de considerar o asset pronto: assunto errado, parte cortada, um
segundo objeto, um halo, um quadro que não é o mesmo personagem. Reporte o arquivo, seu tamanho,
quaisquer
problems, e mencione as outras tentativas em.spriteforge/<nome>/.
Pixel art
- Modelos de imagem só desenham estilo pixel art; Sprite Forge o torna real: ele encontra a
grade de pixel do modelo (ou força
grid), pega a cor dominante de cada célula, remove pixels soltos, torna o alfa totalmente ligado/desligado e limita a paleta. Nunca afirme que um sprite é pixel art sem esta etapa. grid: o lado mais longo do sprite em pixels (16, 24, 32, 48, 64)."auto"mantém o tamanho do pixel que o modelo desenhou.palette:pico8,gameboy,nes,endesga32,sweetie16, uma lista de cores hexadecimais, ou"project"– uma paleta congelada para todo o jogo (salva comopalette.hexno projeto pelo primeiro asset pixel, reutilizada por todos os posteriores). Use"project"para um jogo.outline: trueadiciona um contorno escuro de 1 pixel;canvas: 32coloca o sprite em uma grade de 32x32.- Nenhum dithering é aplicado (ele pisca em animação).
Animar um sprite pixel existente
Use animate_pixel quando o usuário já tiver um sprite pixel (próprio, ou feito com
pixel_sprite) e descrever um movimento: "faça o slime quicar", "anime o cavaleiro balançando a espada". Ele mantém o tamanho exato de pixel e a paleta do sprite em cada quadro.
image: o PNG (tamanho nativo até 256 px, ou uma cópia ampliada com pixels duros).description: o movimento. walk / run / idle / attack / jump / hurt / death / cast usam poses-chave embutidas.- Escreva
posesvocê mesmo para qualquer outra coisa: uma linha curta por quadro dizendo o que muda, ex.: para um balanço de espada["levantando a espada bem acima da cabeça", "a espada no topo, corpo inclinado para trás", "balançando a espada para baixo na frente dele", "a espada baixa após o golpe"]. 3-6 quadros são melhores. Estas são poses-chave, não intermediárias. params.include_original: truecoloca o sprite intocado como quadro 0;params.fps.- Olhe o GIF / prévia: se um quadro perdeu parte do sprite ou o alterou, execute novamente com uma
nova
seedoupreset: "max"(mais tentativas por quadro).
Mapas normais (iluminação 2D)
Para jogos com luzes 2D (Godot CanvasTexture + Light2D, luzes 2D Unity, Phaser
light2d), passe params.normal_map: true para sprite, icon, pixel_sprite, character,
turnaround, animation ou animate_pixel, ou chame make_normal_map em qualquer PNG existente.
- Escreve
<nome>_normal.png(ou<nome>_sheet_normal.png, mesma disposição da folha) e<nome>_lit_preview.png(o sprite iluminado da esquerda, topo, direita e base) – mostre ao usuário a prévia. - Pixel art mantém sua grade de pixel com normais nítidas e ajustadas.
- Convenção padrão é OpenGL (verde = para cima), que Godot e Unity esperam;
normal_y: "down"/y: "down"para DirectX.normal_strength0.5 sutil – 2 forte. - O relevo é inferido do desenho (contorno, regiões de cor, realces), não modelado: ele é lido bem sob luzes em movimento, mas não é uma varredura de profundidade real.
Quando o resultado diz failed_check
O arquivo é escrito, mas não deve ser usado como está. problems explica o porquê.
| Problema | Correção |
|---|---|
cut off | Execute novamente com uma nova seed; adicione "pequeno, centralizado, com espaço ao redor" ou aumente params.padding. |
several objects | Nomeie apenas um objeto; execute novamente com uma nova seed. |
background not removed / empty | Descreva um objeto sólido; mantenha background simples; execute novamente. |
may not look like the character (folhas) | Execute essa folha novamente com uma nova seed ou preset: "max"; mantenha o prompt do personagem simples. |
may not have turned (turnaround) | Execute novamente com preset: "max" (Qwen-Image-Edit segue melhor as mudanças de vista). |
no clear pixel grid found | A imagem não foi desenhada como pixel art: defina grid para um número, ou execute novamente. |
visible seam (tile) | Use uma superfície orgânica ou aumente params.blend; execute novamente. |
much smaller than the original (animate_pixel) | Esse quadro perdeu parte do sprite: execute novamente com uma nova seed ou dê uma pose mais clara. |
flat: almost a single colour | O modelo desenhou uma silhueta: execute novamente com uma nova seed; diga "em cores completas". |
Mesmo name + mesmas configurações retorna o arquivo existente; altere uma configuração, a seed, ou passe
force: true para criar um novo.
Customização
- Por projeto:
spriteforge.json(style,style_preset,output_dir,characters_dir,profiles.<id>.params, ex.:{"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}}). - Por chamada:
params, ex.:{"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}.list_profileslista cada parâmetro com uma explicação. - Novo perfil: um pequeno arquivo JSON na pasta
spriteforge_profiles/do projeto queextendsum perfil existente. - Modelos e hardware: a ferramenta
modelsinforma o que cada perfil e predefinição precisa e o que está faltando. Os downloads são grandes – pergunte ao usuário antes de instalar. - Licenças: todos os modelos que Sprite Forge instala permitem uso comercial do que você cria (FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511 e o pixel LoRA: Apache 2.0; BiRefNet e CLIP: MIT). Algumas lojas (ex.: Steam, itch.io) pedem que você divulgue assets feitos por IA.