CommunityImagemgithub.com

Sprite Forge

Gere arte 2D para jogos localmente e gratuitamente – sprites, props, itens, ícones e elementos de UI com fundos transparentes, pixel art verdadeiro (grade real, paleta limitada), personagens com animações em 4/8 direções e folhas de sprites animadas (andar, correr, parado, atacar...), anime um pixel sprite existente a partir de uma descrição, mapas normais para iluminação 2D, tiles contínuos, retratos e quadros de VFX – tudo como PNGs prontos para jogo, GIFs e atlas JSON para TexturePacker/Phaser. Use sempre que o usuário pedir para criar, gerar, regenerar, animar ou corrigir um sprite, asset 2D, pixel art, ícone, sprite sheet, folha de personagem, ciclo de caminhada, tile ou textura, retrato, animação de efeito ou mapa normal, ou para verificar um PNG.

O que é Sprite Forge?

Sprite Forge é uma habilidade de IA agente que gera assets 2D prontos para jogos localmente, utilizando a GPU da máquina (com ComfyUI executado automaticamente), sem enviar dados para serviços pagos. Ela suporta diversos tipos de criação: sprites, props, itens, ícones, pixel art verdadeiro (com grade real e paleta limitada), personagens com folhas de animação em 4 ou 8 direções (incluindo andar, correr, ataque, etc.), animação de sprites pixel existentes a partir de descrições textuais, mapas normais para iluminação 2D, tiles contínuos, retratos e quadros de VFX. Os resultados são gerados como PNGs, GIFs e atlas JSON compatíveis com TexturePacker e Phaser. A ferramenta funciona através de ferramentas MCP (`sprite-forge`) ou linha de comando, oferecendo perfis ajustáveis (como `sprite`, `pixel_sprite`, `character`, `animation`) e presets (`fast`, `standard`, `max`). Cada asset passa por um processo de pós-processamento que garante bordas limpas, recorte, redimensionamento, verificação de qualidade e salvamento com um manifesto, mantendo a consistência visual através de um arquivo de configuração por projeto (`spriteforge.json`). Se algo falhar na verificação, o sistema reporta problemas específicos e sugere correções.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

PerfilParaSaída
spriteprops, itens, pickups, armas, móveis, peças de UIPNG transparente, cropado, centralizado em uma tela quadrada
iconícones de habilidades / itens, emblemas, botõesPNG quadrado mais versões 256/128/64 px
pixel_spritepixel art verdadeiro: personagens, itens, inimigosgrade de pixel real (ex.: 32 px), alfa duro, paleta limitada ou nomeada, mais uma prévia x8
characteruma referência de personagem reutilizávelPNG corpo inteiro transparente, pés na linha do chão
pixel_charactero mesmo, desenhado em estilo pixel artreferência para folhas pixel art
turnaroundo personagem virado para 4 ou 8 direçõesquadros + <nome>_sheet.png + <nome>.atlas.json
animationandar, correr, parado, ataque, pular, machucado, morte, lançar feitiçoquadros + folha + atlas com uma tag de animação
tilechão, paredes, pisos, água, folhagemtextura quadrada contínua + uma prévia em grade 3x3 (versão pixel opcional)
portraitretratos de diálogo, cards, arte chaveimagem em resolução total
vfxexplosões, fumaça, rajadas mágicas, faíscas de ataquequadros + folha + atlas; brilho é transparência
animate_pixel (ferramenta)animar um sprite pixel EXISTENTE a partir de uma descriçãoquadros 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

  1. Sempre passe a pasta do projeto do jogo (project_dir / --project). Seu spriteforge.json fornece 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>).
  2. Escreva o prompt como o prompt_guide do perfil diz (list_profiles o retorna). Descreva a coisa, não a imagem: sem "um sprite de", sem fundo, sem palavras de câmera no prompt – defina o ângulo com params.view (frente, lateral, vista superior, vista isométrica).
  3. Personagens que aparecem mais de uma vez: crie-os primeiro. create_character (ou o perfil character com character definido) 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 use profile: "pixel_character" e passe params.pixel_grid (ex.: 32) para a folha.
  4. Trabalhos mais longos são assíncronos. Se uma ferramenta retornar um id de trabalho, chame get_job com wait_seconds: 50 até que o status não seja queued ou running. Um trabalho por vez.
  5. 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 como palette.hex no projeto pelo primeiro asset pixel, reutilizada por todos os posteriores). Use "project" para um jogo.
  • outline: true adiciona um contorno escuro de 1 pixel; canvas: 32 coloca 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 poses você 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: true coloca 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 seed ou preset: "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_strength 0.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ê.

ProblemaCorreção
cut offExecute novamente com uma nova seed; adicione "pequeno, centralizado, com espaço ao redor" ou aumente params.padding.
several objectsNomeie apenas um objeto; execute novamente com uma nova seed.
background not removed / emptyDescreva 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 foundA 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 colourO 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_profiles lista cada parâmetro com uma explicação.
  • Novo perfil: um pequeno arquivo JSON na pasta spriteforge_profiles/ do projeto que extends um perfil existente.
  • Modelos e hardware: a ferramenta models informa 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.

Habilidades Relacionadas