Generate2dsprite
Use esta skill para ativos de sprite 2D ou animação autocontidos no sandbox app-builder (TanStack Start + jogos de navegador).
Quando um jogo maior ou protótipo jogável precisar de sprites, use esta skill para os ativos de sprite visíveis e mantenha a montagem do runtime/jogo separada (conecte ao Phaser / Canvas / DOM após a exportação). Não substitua ativos de sprite solicitados por placeholders desenhados com código.
Ambiente App-builder / Grok
| Item | Valor |
|---|---|
| Diretório da skill | .grok/skills/generate2dsprite/ |
| Scripts | python3 .grok/skills/generate2dsprite/scripts/<script>.py … |
| Ferramentas de imagem | imagine_text_to_image / imagine_image_to_image (baseado em caminho; veja a skill imagine para criação de prompt) |
| Inspecionar imagens | read_file no caminho do PNG (não Codex view_image) |
| Caminho da imagem gerada | imagine_text_to_image retorna um file_path do sandbox; copie esse caminho para seu diretório de execução antes de processar |
| Dependências Python | Pillow + numpy (pré-instalados na imagem) |
| Diretório de saída | Prefira assets/sprites/<nome>/ em /workspace para que o app possa importá-los |
| Alvo do motor | Navegador: Canvas 2D, Phaser ou DOM/<img> — não Godot/Unity a menos que o usuário peça |
Skills relacionadas: imagine (uso da ferramenta de imagem), game-asset-core (+
game-animation-frames / game-character-consistency para QC e padrões prontos para o motor),
generate2dmap (mapas/props), video2dsprite (movimento mais denso
via imagine_image_to_video), building-games (game loop / integração).
Parâmetros
Infira estes a partir da solicitação do usuário:
asset_type:player|npc|creature|character|spell|projectile|impact|prop|summon|fxaction:single|idle|cast|attack|shoot|jump|hurt|combat|walk|run|hover|charge|projectile|impact|explode|deathview:topdown|side|3/4sheet:auto|2x2|2x3|2x4|3x3|3x4|4x4|5x5|custom_grid|strip_1x3|strip_1x4frames:autoou contagem explícitabundle:single_asset|unit_bundle|spell_bundle|combat_bundle|line_bundle|hero_action_bundle|engine_atlaseffect_policy:all|largestanchor:center|bottom|feetmargin:tight|normal|safeart_style: pixel_art | clean_hd | pixel_inspired | retro_pixel | map_style | project-nativereference:none|attached_image|generated_image|local_filelayout_guide:none|optional|recommendedprompt: o tema ou direção visual do usuáriorole: apenas quando o ativo for claramente um papel de NPCname: slug de saída opcional
Leia references/modes.md quando a solicitação for ambígua.
Regras do Agente
- Decida você mesmo o plano do ativo. Não force o usuário a especificar o tamanho da folha, contagem de quadros ou estrutura do pacote quando a solicitação já os implica.
- Não empacote ações não relacionadas em uma única folha gerada bruta apenas para satisfazer um
4x4,5x5ou atlas de motor personalizado. Uma folha gerada bruta deve representar uma família de ações, uma sequência contínua, uma folha de locomoção direcional canônica ou um pacote de props/ativos. - Para heróis controláveis, personagens principais e ativos de jogador de alto valor com múltiplas ações, gere folhas de grade separadas por ação primeiro, faça o QC de cada ação, depois monte deterministicamente o atlas exigido pelo motor somente após as grades passarem pela revisão visual.
- Para heróis controláveis, personagens principais e ações corporais de jogador de alto valor, defina as folhas corporais padrão de ataque/disparo/feitiço como apenas o corpo. Não inclua grandes arcos de corte, flashes de boca, projéteis, explosões de impacto, poeira destacada, rastros longos ou FX amplos destacados na folha do corpo. Gere-os como folhas separadas
fx,projectileouimpacte coloque-as em camadas no jogo. - Inclua apenas FX de ataque amplo na mesma folha corporal bruta quando o runtime alvo suportar explicitamente células mais largas por ação mais metadados de origem/âncora por ação. Caso contrário, uma caixa delimitadora de FX ampla forçará o corpo a encolher dentro da célula fixa.
- Escreva você mesmo o prompt de arte. Não use o script de criação de prompt como padrão.
- Use o
imagine_text_to_imageintegrado para cada imagem bruta. - Não crie arte de sprite bruta com Three.js, Canvas, SVG, desenho HTML/CSS, desenho de forma PIL, geometria procedural, placeholders primitivos ou capturas de tela renderizadas por código. O código de tempo de execução pode exibir ativos gerados finalizados, e scripts podem fazer guias de layout ou pós-processar imagens geradas, mas a arte de sprite solicitada deve ter origem no
imagine_text_to_imageintegrado. - Quando o usuário fornecer ou implicar uma referência visual, passe o
file_pathdo sandbox dessa referência paraimagine_image_to_image(a ferramenta lê o arquivo). Tambémread_filea referência local para que você possa vê-la; um caminho mencionado apenas dentro do prompt não é uma entrada visual. - Não force pixel art quando o ativo for um prop de mapa para
$generate2dmapou quando o usuário/projeto solicitar um estilo diferente. Corresponda primeiro ao mapa ou ao estilo de referência. - Use o script apenas como um processador determinístico: limpeza magenta, divisão de quadros, filtragem de componentes, redimensionamento, alinhamento, metadados de QC, exportação de folha transparente e exportação de GIF.
- Não use scripts para gerar o prompt de imagem criativo. Se um comando legado de criação de prompt existir, trate-o apenas como compatibilidade histórica, não como o fluxo de trabalho normal da skill.
- Guias de layout são permitidos apenas como referências geométricas determinísticas para geração de imagem. Eles podem mostrar contagem de slots, espaçamento, centralização e preenchimento seguro, mas nunca devem definir a direção artística criativa.
- Trate as flags de script como primitivas de execução escolhidas pelo agente, não fluxo de trabalho codificado voltado para o usuário.
- Se uma folha gerada tocar as bordas das células, desviar na escala ou quebrar um loop de projétil/impacto, ou reprocesse com melhores configurações primitivas ou regenere a folha bruta.
- Não use folhas brutas de linha única como
1x4,1x6,1x8ou1xNpara personagens, jogadores, heróis controláveis, criaturas, NPCs, inimigos, invocações, props animados ou qualquer ativo onde um corpo/sujeito deva permanecer centralizado. A geração bruta de linha única é muito propensa a desviar horizontalmente e cortar de forma inconsistente. - Para ativos corporais animados, use uma grade de várias linhas por padrão: 4 quadros ->
2x2, 6 quadros ->2x3, 8 quadros ->2x4, 9 quadros ->3x3, 12 quadros ->3x4ou4x3, 16 quadros ->4x4. - Se um motor de jogo precisar de uma tira de linha única final ou atlas misto, primeiro gere e faça o QC da ação como uma grade de várias linhas, depois monte a tira/atlas de entrega deterministicamente.
- Em cada prompt de grade corporal animada, exija que o corpo do sujeito permaneça centralizado em cada célula, corpo inteiro dentro da área segura central de 60% a 70%, escala consistente entre as células, linha de ancoragem de pés/fundo estável quando aplicável, e sem membros, armas, cabelos, capas, poeira, flashes de boca ou FX destacados cruzando as bordas das células.
- Para prompts de ataque corporal de herói, exija explicitamente que a altura do corpo e a escala do corpo correspondam às folhas de idle/run aceitas, pés/âncora inferior estáveis, arma mantida suficientemente próxima para não alargar a caixa delimitadora do corpo, e nenhum arco de corte destacado ou efeito de ataque em espaço de tela.
- Para pacotes de props de mapa, classifique os props antes de escolher uma grade. Pacotes quadrados
2x2,3x3e4x4são apenas para props compactos. Não coloque plataformas, pisos, pontes, paredes, escadas, portões, portas, perigos longos, objetos largos/altos, objetos de colisão ou peças de tileset/tira em pacotes de props quadrados; use um por um, tiras1x3/1x4, células largas personalizadas ou um atlas do tipo tileset. - Mantenha a regra de fundo sólido
#FF00FFa menos que o usuário queira explicitamente um fluxo de trabalho de processamento diferente.
Fluxo de Trabalho
1. Inferir o plano do ativo
Escolha a menor saída útil.
Exemplos:
- herói controlável com quatro direções ->
player+player_sheet - herói controlável de visão lateral com idle/run/shoot/jump ->
player+hero_action_bundle- folha de grade idle, geralmente
2x2para 4 quadros - folha de grade run, geralmente
2x2ou2x3dependendo da contagem de quadros necessária - folha de grade shoot apenas com corpo/arma, geralmente
2x2 - folha de grade jump, geralmente
2x2 - projétil/flash de boca como ativos separados quando necessário
- atlas de motor opcional montado após QC por ação
- folha de grade idle, geralmente
- herói controlável de visão lateral com ataque corpo a corpo ->
player+hero_action_bundle- folha de grade de ataque corporal, geralmente
2x2ou2x3, apenas corpo - arco de corte/rastro de arma como uma folha
fxseparada quando o ataque precisar de um efeito visual amplo - faísca de impacto como uma folha
impactseparada quando os acertos precisarem de feedback
- folha de grade de ataque corporal, geralmente
- NPC curandeiro de mundo superior ->
npc+single_assetouunit_bundle - loop idle de chefe grande ->
creature+idle+3x3 - mago lançando um orbe mágico ->
spell_bundle- folha de lançamento do conjurador
- loop de projétil
- explosão de impacto
- solicitação de linha de monstro ->
line_bundle- planeje 1-3 formas
- por forma, faça as folhas que a solicitação realmente precisa
2. Escrever o prompt manualmente
Use references/prompt-rules.md.
Escolha art_style antes de escrever o prompt:
- Use
pixel_artouretro_pixelpara sprites clássicos, personagens de RPG 16 bits e solicitações que pedem explicitamente pixel art. - Use
clean_hdpara props de mapa ou ativos destinados a combinar com mapas HD pintados à mão limpos. - Use
pixel_inspiredapenas quando o usuário quiser um visual adjacente a pixel sem a rigidez retrô. - Use
map_styleouproject-nativequando um mapa, jogo ou referência existente deve definir o estilo.
Se uma referência estiver envolvida:
- Conecte a referência na chamada: passe seu
file_pathdo sandbox paraimagine_image_to_image— ou a lista de caminhos paraimagine_reference_to_imagepara 2+ referências (imagens geradas já têm umfile_path; arquivos locais usam seu caminho do sandbox). Tambémread_filereferências locais para que você possa vê-las. - Declare explicitamente o papel da referência: preservar identidade/estilo, criar uma folha de animação para o mesmo sujeito, criar uma evolução/variante ou derivar um prop/FX correspondente.
- Preserve os marcadores de identidade estáveis da referência: silhueta, paleta, características faciais/de olhos, marcas de figurino, acessórios principais e linguagem material.
- Deixe apenas a ação ou evolução solicitada mudar. Não redesenhe o sujeito a menos que o usuário peça.
- Ainda exija forma exata da folha, fundo magenta sólido, contenção de quadros e mesma escala entre os quadros.
Mantém as partes estritas:
- fundo
#FF00FFsólido - forma exata da folha
- mesma identidade de personagem ou ativo entre os quadros
- mesma caixa delimitadora e escala de pixel entre os quadros
- contenção explícita: nada pode cruzar as bordas das células
Barreira de segurança do atlas de ação mista:
- Não peça ao
imagine_text_to_imagepara gerar linhas de ação não relacionadas em uma folha bruta, comolinha 1 idle, linha 2 run, linha 3 shoot, linha 4 jump, para um herói controlável ou personagem principal. - Não peça ao
imagine_text_to_imagepara gerar tiras de ação brutas de linha única como1x4 idle,1x4 run,1x4 shootou1x4 jumppara um herói controlável, personagem, criatura, NPC, inimigo, invocação ou prop animado. - Se um motor precisar de um
4x4,5x5, atlas personalizado ou formato de entrega de tira de linha combinado, gere as grades de ação separadamente, processe e faça o QC delas separadamente, depois monte o atlas de entrega deterministicamente. - Exceções são folhas de locomoção direcional canônica, uma sequência de ação longa contínua, pacotes de props, atlas do tipo tileset e folhas compactas de combate inimigo de baixo risco. Estas ainda precisam de um prompt coerente e QC visual.
- Mantenha projéteis, flashes de boca, impacto, rastros de poeira e FX destacados em folhas separadas, a menos que eles sejam intencionalmente parte da mesma silhueta de ação e permaneçam firmemente anexados.
- Para heróis controláveis e personagens principais, "firmemente anexado" não é suficiente quando o efeito torna a caixa delimitadora da ação muito mais larga ou mais alta do que idle/run. Divida arcos de corte largos, flashes de boca, rastros de arma longos, nuvens de poeira e explosões de impacto em folhas FX separadas por padrão.
Barreira de segurança da grade corporal animada:
1x4e outras folhas brutas de linha única não são padrões válidos para corpos animados. Isso inclui jogadores, heróis controláveis, criaturas, NPCs, inimigos, invocações, props animados e ações de combate anexadas ao corpo.- Use
2x2para ações corporais de 4 quadros. Este é o padrão para idle, ataque curto, corpo de tiro, pulo, ferido, pairar e ações compactas de andar/correr de visão lateral. - Use
2x3para ações corporais de 6 quadros, como lançar feitiço, atacar, invocar, correr, carregar ou transformação. - Use
2x4,3x3,3x4ou4x4para ações corporais mais longas. Prefira uma grade compacta a uma linha longa. - Para caminhada de cima para baixo de 4 direções,
4x4pode permanecer uma forma de geração bruta porque é uma folha de locomoção direcional canônica, não quatro linhas de ação não relacionadas. - Se o runtime final precisar de uma tira de linha, monte-a após o QC a partir dos quadros da grade de várias linhas processados.
- Mantenha o personagem centralizado em cada célula. A linha central do corpo deve permanecer perto do centro da célula, a âncora dos pés/fundo deve permanecer na mesma posição y quando visível, e o sujeito deve ocupar apenas a área segura central com preenchimento magenta generoso.
- Para ataque, tiro, lançamento, carga e outras ações corporais, a altura do corpo deve permanecer próxima à altura do corpo idle/run aceita. Se um runtime de célula fixa estiver sendo usado, rejeite a saída da ação corporal quando o corpo aparecer mais de cerca de 10-15% menor do que idle/run, mesmo se
edge_touch_framesestiver vazio.
Barreira de segurança do pacote de props de mapa:
- Use pacotes de props brutos quadrados
2x2,3x3e4x4apenas para props compactos, como pedras, arbustos, barris, caixotes, luminárias, pequenas placas, vasos, detritos e pequenos ornamentos. - Não use pacotes de props quadrados para objetos de mapa largos ou críticos de colisão: pisos, plataformas, saliências, pedaços de terreno, pontes, trechos de parede, escadas, estradas, trilhos, canos, armadilhas de espinhos longas, portões, portas, edifícios, árvores grandes, pontos de verificação, saídas ou almofadas de construção.
- Use geração um por um para props únicos, grandes, importantes, altos, irregulares ou alinhados por colisão.
- Use tiras
1x3ou1x4para ativos repetíveis de plataforma/piso, com tampa esquerda, repetição do meio, tampa direita e variante opcional de inclinação/canto/fim. - Use células largas personalizadas para múltiplos si
…
[truncado para tradução]