sprite-stacking é um skill de código aberto para agentes, criado por Daniel White, que transforma quatro vistas em pixel art de um objeto (de cima, lateral, frente e traseira) em um "sprite stack": uma tira de camadas planas que o jogo desenha uma sobre a outra para simular um objeto 3D que dá para girar. Funciona com Claude Code, Codex, Cursor, OpenCode, Gemini CLI e Pi. O repositório foi criado em 20 de novembro de 2026 e tinha 187 estrelas quando verificamos, em 21 de novembro de 2026. A licença é MIT.
Este guia explica o que é sprite stacking, o que o skill acrescenta, como instalar, o que você precisa entregar a ele e onde ele deixa a desejar. Todos os comandos abaixo foram copiados do README do repositório ou do SKILL.md. Lemos os arquivos em 21 de novembro de 2026, mas não rodamos o skill, então os resultados descritos são o que a documentação diz que deve acontecer.
O que é sprite stacking
Um sprite stack é um objeto visto de cima e cortado em camadas horizontais, como um pão fatiado do chão para cima. O jogo desenha as camadas de baixo para cima. Cada uma é girada pelo mesmo ângulo, achatada na vertical conforme a inclinação da câmera e erguida 1 pixel acima da anterior. O resultado parece um pequeno modelo de voxels girando suavemente, mas continua sendo desenho 2D comum: sem engine 3D, sem malhas, e todo ângulo fica com pixels nítidos.
O README deixa claro que a técnica não é nova: "Sprite stacking is a long-standing indie game technique, not invented here." O que o skill traz é o entalhe a partir de quatro vistas e um fluxo de trabalho para agentes.
A parte chata costuma ser desenhar as camadas. Um carro de 30 camadas são 30 imagens pequenas que precisam se alinhar. O skill pula essa etapa: você (ou o seu agente) desenha quatro vistas comuns, e um script entalha as camadas a partir delas.
O que o skill faz
O README descreve quatro etapas:
- Vistas: uma folha com as vistas de cima, lateral, frente e traseira, ortográficas, em uma única linha.
- Entalhe: um voxel só é mantido onde as quatro vistas o cobrem.
- Camadas: o volume entalhado é cortado em uma tira de camadas planas, começando pela do chão.
- Render: cada camada é girada, achatada conforme a inclinação e erguida 1 px.
A pasta do skill contém:
SKILL.md, as instruções que o agente lê: como obter uma boa folha de quatro vistas, uma checklist antes de fatiar, as opções do fatiador, o loop de render e seus números, uma checklist de "pronto quando" e uma tabela de erros antigos com as correções.scripts/views_to_slices.py, o fatiador. Ele remove o fundo, tira o contorno de 1 px de cada vista, reduz tudo a uma paleta compartilhada, entalha as camadas e pode gerar uma imagem de conferência e uma página de visualização independente.scripts/viewer.html, um visualizador no navegador que também abre sozinho e aceita tiras de camadas arrastadas.references/engines.md, receitas curtas para Canvas web e React, Godot 4, Unity, e Phaser, Pygame ou qualquer outra.
Instalar no Claude Code ou no Codex
A instalação em uma linha do README usa a CLI de skills, que exige Node 22.20 ou mais recente:
npx skills add danielwh2/sprite-stacking
Isso instala o skill no projeto atual. Segundo o README, adicione -g para instalar em todos os projetos e -a claude-code (ou codex, cursor etc.) para escolher o agente.
A outra opção é copiar a pasta skills/sprite-stacking do repositório para a pasta de skills do seu agente:
| Agente | Pasta |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex, Cursor, OpenCode, Gemini CLI, Pi | ~/.agents/skills/ |
O fatiador é um script Python, então você também precisa de Python 3 com Pillow e NumPy. O comando do README:
pip install pillow numpy
Como usar: o que pedir ao agente
Não é preciso chamar o skill pelo nome. Depois de instalado, peça o que você quer e o agente o usa. Os exemplos do README (traduzidos):
- "Faça um carro em pixel art que dê para girar."
- "Faça um sprite stack desta folha de 4 vistas e me dê um giro de 360°."
- "Adicione uma árvore em pixel art 3D falso ao meu jogo no Godot."
O SKILL.md manda o agente escolher um caminho conforme o que você entregar:
- Um PNG com a tira de camadas ou uma exportação de camadas do MagicaVoxel: vai direto para o render.
- Uma folha de quatro vistas: confere a folha e depois entalha.
- Só um prompt ou uma ideia: primeiro cria a folha de quatro vistas, depois entalha e renderiza.
Se você não tem folha, o agente usa uma ferramenta de geração de imagens quando tiver uma, com um prompt que já vem escrito no SKILL.md. Se não tiver, ele mesmo desenha as quatro vistas em pixel art com um script Python curto. O README resume: "No image generator? The agent draws the views itself in a short Python script."
Em um jogo que já existe, o SKILL.md pede que o agente leia primeiro o seu renderizador (engine, escala de pixel, como os sprites são desenhados e ordenados) e encaixe o stack nele, sem nunca criar um segundo canvas ou outro pipeline de render.
Que entrada ele precisa
A folha de quatro vistas tem regras rígidas, e a maioria dos resultados ruins vem de quebrá-las. Segundo o SKILL.md:
- Uma linha na ordem TOP, SIDE, FRONT, BACK (cima, lateral, frente, traseira), sobre branco liso, com espaços claros entre as vistas.
- TOP olha reto para baixo, com a frente do objeto apontando para baixo. Em SIDE, a frente aponta para a esquerda.
- Estritamente ortográfica: sem perspectiva, sem inclinação, sem vista 3/4.
- A mesma escala nas quatro vistas: o comprimento de TOP igual ao de SIDE, a largura de TOP igual à de FRONT e BACK, a altura de SIDE igual à de FRONT e BACK.
- Preenchimentos de cor chapados e contornos nítidos. Bordas esfumadas e linhas internas de 1 px borram quando as camadas giram, e o skill recomenda redesenhar em vez de tentar salvar.
Ele também define três faixas de tamanho:
- Retrô robusto: 15 a 20 camadas, cerca de 25×48 px, exibido em 8 a 10×.
- Hi-bit detalhado: 26 a 44 camadas, de 36×72 a 46×107 px, com espaço para grades de ventilação, logotipos e rodas raiadas.
- Vitrine / vídeo 1080p: 36 a 56 camadas, de 30×30 a 148×148 px, exibido em 4 a 6×.
Rodar o fatiador você mesmo
Normalmente quem roda o fatiador é o agente, mas você pode executá-lo na raiz do repositório com o comando do README:
python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
--slices 36 --preview check.png --html viewer.html
views.png é a sua folha de quatro vistas e slices.png é a tira de camadas gerada. As opções listadas no README:
--slices N: número de camadas. 15 a 20 para o estilo robusto, 32 a 48 para o detalhado.--order reading: força a ordem TOP, SIDE, FRONT, BACK. Por padrão, o script associa as vistas pelas proporções.--round: entalha torres, balões e vasos redondos em vez de quadrados.--side-nose right: use quando a vista SIDE estiver virada para a direita.--colours N: tamanho da paleta compartilhada;0mantém todas as cores.--normals path.png: salva também uma tira de camadas com mapa de normais.--emissive path.png: salva também uma máscara de brilho detectada automaticamente (faróis, janelas, neon).
O SKILL.md lista mais algumas, como --top-nose (use down para tudo que não for veículo), --shade, --bg-tol e --dark-thresh.
O check.png mostra as quatro vistas extraídas, quatro ângulos do giro e uma vista explodida. O skill manda o agente olhar essa imagem antes de escrever qualquer código do jogo.
O visualizador
--html gera uma página independente. Segundo o README, ela tem giro de 360°, um modo Scene com objetos procedurais, varredura por camadas, vista explodida e um modo Play em que dá para dirigir com WASD ou as setas. Também tem hora do dia, um sol arrastável com sombras, chuva e neve, e um botão de exportação que gera uma sprite sheet PNG em 16 direções. Isso ajuda se a sua engine só aceita sprites direcionais comuns.
Levando para um jogo
O loop de render é o mesmo em qualquer lugar: para cada camada, do chão para cima, gire em torno do centro, escale o y pelo valor de achatamento, erga pelo índice vezes o espaçamento, arredonde para pixels inteiros e desenhe com filtragem nearest-neighbour. O SKILL.md dá os padrões: espaçamento 1.0 e achatamento 0.75 para uma câmera top-down inclinada (1.0 olha reto para baixo). O references/engines.md traz uma função pronta para Canvas 2D e um script Node2D para Godot 4, além de notas para Unity (um SpriteRenderer por camada, filtro Point) e para Phaser ou Pygame.
Duas dicas do skill fazem diferença em desempenho e aparência. Ordene stacks inteiros pelo ponto de contato com o chão e nunca intercale camadas de dois objetos. E transforme stacks estáticos em sprites comuns quando o jogo carregar: o skill observa que 200 árvores de 30 camadas cada dariam 6.000 desenhos por quadro.
Limites
Estes vêm da própria checklist do skill e da tabela de erros antigos:
- Cavidades escondidas ficam maciças. O entalhe mantém só o que as quatro silhuetas cobrem, então a caçamba de uma picape ou um arco oco que nenhuma vista mostra sai sólido. Saliências que deixam ver o fundo na vista lateral, como um aerofólio traseiro elevado, sobrevivem. Cavidades precisam ser corrigidas à mão depois do entalhe.
- Partes redondas saem quadradas, a menos que a vista de cima tenha um círculo de pixels, ou que você use
--roundquando a parte redonda for mais estreita que a base. - Partes de 1 px piscam enquanto o stack gira. Postes, cordas e antenas precisam ter pelo menos 2 px de largura; o fatiador mostra um aviso.
- Saliências viram parapeitos. Algo saindo de uma parede, como uma floreira ou uma placa, entalha um parapeito ao longo da parede inteira. Pinte os detalhes pequenos chapados.
- Vãos fechados saem maciços. Fundo totalmente cercado dentro de uma vista (entre pernas, barbatanas ou cordas) é tratado como parte do objeto. Todo vão precisa chegar à borda externa da vista.
- Objetos fora do centro bambeiam. O stack gira em torno do meio da sua caixa delimitadora, então centralize o objeto nas vistas.
- Só pixel art. A técnica e o fatiador foram feitos para sprites pequenos com sombreamento chapado. Não é um caminho para obter um modelo 3D de verdade para um jogo 3D em three.js ou Unity.
Licença
O repositório usa a licença MIT (copyright 2026 Daniel White), como mostram o GitHub e o arquivo LICENSE. Você pode usar, modificar e incluir em projetos comerciais, desde que mantenha o aviso de copyright e de licença nas cópias do código. O README não diz nada sobre a licença dos sprites que você cria com ele.
Perguntas frequentes
O que é sprite stacking?
Um jeito de simular 3D em um jogo 2D. O objeto fica guardado como uma tira de camadas planas vistas de cima, e o jogo as desenha de baixo para cima, cada uma girada pelo mesmo ângulo e erguida 1 pixel. Parece um pequeno modelo de voxels girando, mas continua sendo pixel art nítido.
O skill sprite-stacking é gratuito?
Sim. É de código aberto, sob a licença MIT. Você só precisa de Python 3 com Pillow e NumPy, e de Node 22.20 ou mais recente se instalar com npx skills. A assinatura ou o uso de API do seu agente de IA é à parte.
Funciona com Claude Code e Codex?
Sim, os dois estão no README. Instale com npx skills add danielwh2/sprite-stacking (com -a claude-code ou -a codex para escolher o agente), ou copie skills/sprite-stacking para ~/.claude/skills/ no Claude Code ou ~/.agents/skills/ no Codex.
Preciso de um gerador de imagens?
Não. Se o seu agente tiver um, o skill passa a ele um prompt para a folha de quatro vistas. Se não tiver, o agente desenha as vistas sozinho com um script Python curto. Você também pode entregar uma folha desenhada por você, uma tira de camadas ou uma exportação de camadas do MagicaVoxel.
Dá para usar o resultado no Godot, Unity ou Phaser?
Sim. O references/engines.md traz um script para Godot 4, notas para Unity, uma função de Canvas 2D para web e React, e o loop geral para Phaser e Pygame. O visualizador também exporta uma sprite sheet PNG em 16 direções para engines que preferem sprites comuns.
Por que partes do meu sprite saem maciças ou quadradas?
O fatiador só mantém um voxel onde as quatro vistas o cobrem. Cavidades escondidas de todas as vistas são preenchidas, partes redondas precisam de um círculo na vista de cima ou da opção --round, e vãos totalmente fechados dentro de uma vista saem maciços. A seção de limites acima lista as correções.
Guias relacionados
- Skills de agentes e servidores MCP para desenvolvimento de jogos: mais skills para Godot, Unity, three.js, pixel art e sprites.
- Blender MCP: para quando você precisa de um modelo 3D de verdade em vez de um sprite stack.
- Modelos 3D grátis do Polyfork: GLBs low-poly gratuitos para jogos em three.js.
Fontes
Verificado em 21 de novembro de 2026: README do danielwh2/sprite-stacking, SKILL.md, references/engines.md, LICENSE e os dados do repositório no GitHub (criado em 20 de novembro de 2026; 187 estrelas em 21 de novembro de 2026).
Fez um jogo com carros ou objetos em sprite stacking? Envie para o VibeGamer.



