pixelfx: 244 efeitos de pixel art que são código, não sprites

A primeira coisa estranha no pixelfx é que os efeitos são código. Não sprites. Não sprite sheets. Pequenos arquivos JavaScript que desenham um frame quando você entrega um valor de tempo.
export const fx = {
duration: 0.8,
draw(p, t, o) { /* pixels for second t */ }
}
Essa decisão de design se espalha por todo o resto, e é o motivo de a biblioteca merecer uma olhada mesmo para quem não tem interesse em pixel art. Um sprite sheet é o registro fixo de algo que aconteceu uma vez. Uma função é a resposta a uma pergunta: como isso fica em t = 0.37, com esta seed, neste ângulo, espelhado?
O pixelfx do Patch traz 244 deles — fogo, explosões, água, gelo, raio, ficção científica, corpo a corpo, impactos, projéteis, spawn e morte, arcano, sagrado, sombra, status, natureza, clima, UI, coletáveis, transições e criaturas. Mais doze “golpes” completos que encadeiam efeitos numa rotação de preparação até recuperação: flechada, corte com avanço, impacto no chão, arremesso de bola de fogo, golpe de luz sagrada.
Licença MIT. Vem subindo rápido desde que apareceu, e é o segundo dos repositórios criativos com sabor de agente de código desta semana a chamar atenção de verdade — o primeiro foi uma skill de modelo de imagem, o segundo é este.
Dois tipos de efeito, e por que a diferença importa
Lendo a documentação, os efeitos se dividem limpo em dois.
Funções puras. O frame no segundo t é inteiramente determinado por t. Sem estado, sem acumulação, perfeitamente loopável. Bom para qualquer coisa que precise ser scrubável, ou para renderizar o mesmo efeito em dez máquinas e obter dez resultados idênticos.
Simulações. Partículas, detritos e luz avançam a 120 Hz. O resultado depende do frame rate do mesmo jeito que um motor de física. Bom para qualquer coisa em que os detritos devam reagir ao que está acontecendo.
A maioria das bibliotecas de efeito entrega um ou outro sem dizer qual. Nomear a diferença é o tipo de coisa que economiza uma tarde três meses depois, quando alguém pergunta por que o mesmo efeito parece diferente no trailer.
Por baixo dos dois existe uma arquitetura de buffer duplo: um buffer de cor para os pixels e um buffer de luz para o brilho aditivo por cima. O calor de um efeito de fogo vem do segundo buffer, não de pixels mais claros. É o mesmo truque usado em muitos motores 2D, e é o motivo de esses efeitos parecerem “iluminados” e não “coloridos”.
Tudo tem seed
Foi esta linha que me fez levar o repositório a sério:
Todos os números aleatórios vêm da seed do efeito. O frame 40 é o mesmo toda vez.
Reprodutibilidade não é luxo em efeitos. É a diferença entre um bug que você corrige e um bug que você não reproduz. Se a faísca do seu impacto parece errada numa build, uma biblioteca com seed permite renderizar o frame 12 com seed 4471 e olhar. Uma biblioteca que reseeda a cada chamada faz você encarar um vídeo e adivinhar.
Isso também torna a biblioteca compatível com um fluxo que virou normal neste ano: um agente gera um efeito, renderiza, olha o render, corrige, renderiza de novo. Esse ciclo só faz sentido se o render for determinístico. Caso contrário o agente está otimizando contra ruído.

Instalar e usar
npm i github:patch-gg/pixelfx
Ou copie src/core mais os efeitos que quiser, se preferir não pegar uma dependência.
O runtime não tem dependências e funciona com canvas, Phaser, PixiJS, Kaplay e three.js:
import { createFrame, clearFrame, createFx, composite } from "pixelfx";
import * as frostNova from "pixelfx/fx/ice/frost-nova";
const frame = createFrame(320, 180);
const fx = createFx(frostNova, { x: 160, y: 140 });
function tick(dt) {
fx.update(dt);
clearFrame(frame);
fx.draw(frame, "back");
drawCharacters();
fx.draw(frame, "front");
composite(frame, img.data, backgroundColor);
ctx.putImageData(img, 0, 0);
}
Repare nos passes "back" e "front". Os efeitos desenham atrás e na frente do personagem, e é a diferença entre uma bola de fogo em que o personagem está dentro e uma bola de fogo que ele segura.
As opções incluem flip, angle, seed, palette e light. A de paleta é mais útil do que parece:
node tools/render.mjs fire/torch --gif --opts '{"palette": ["#102","#215","#43a","#8cf","#cff","#fff"]}'
Uma rampa hex de escuro para claro, passada na hora do render, transforma uma tocha em chama azul sem tocar na fonte. Para um jogo com variantes elementais, isso é o recurso inteiro.
Colocando numa engine
Exportar é em duas etapas, e as duas existem como script:
node tools/render.mjs ice/frost-nova --sheet # one effect: PNG grid + JSON
node tools/sheets.mjs # the whole library into sheets/
O JSON tem formato Aseprite — retângulos de frame, durações, mais um bloco meta.pixelfx com fps, flags de loop, contagem de colunas e âncora. Isso significa que Godot, Unity, GameMaker, Defold, LÖVE e Bevy têm importador existente que lê, e o loader de atlas do Phaser pega direto.
Escolher o formato do Aseprite em vez de um formato próprio é a decisão menos glamourosa e mais correta do repositório. Ninguém quer escrever importador para o seu formato.
A camada de atuação
Setenta e três dos efeitos têm atuação de personagem embutida: o personagem se prepara, golpeia, o impacto congela num frame de snap, o alvo treme e recua. A estrutura de dados é uma lista de poses com tempos, mais eventos de impacto:
export const act = {
target: { x: 58 },
poses: [
[-0.55, GUARD],
[-0.3, WIND_UP],
[0, CUT, "snap"],
[0.06, FOLLOW_THROUGH, "snap"],
[0.86, GUARD],
],
hits: [{ t: 0.06, stop: 0.14, shake: 0.18, amp: 2, push: 2.8, straw: 18 }],
};
Tempos negativos significam que o personagem começa a se mover antes do efeito começar, que é como funciona a antecipação. A entrada hits carrega duração de congelamento, amplitude de tremor e distância de empurrão. Quem já ajustou hitstop na mão sabe quanto de “game feel” mora nesses quatro números.
O boneco padrão é uma figura cinza de 24×38 construída sobre um esqueleto 3D de comprimento fixo — pelve, coluna, ombros — renderizada em poucos tons chapados. É referência, não arte. Mas é a referência certa, porque efeito que fica bom num retângulo fica errado num corpo.
Fazendo o seu
O kit de autoria são quatro comandos:
node tools/new.mjs arcane/my-spell # starter template (--loop for loops)
node tools/render.mjs arcane/my-spell # contact sheet, look at it
node tools/check.mjs arcane/my-spell # overflow, seams, unseeded randoms, slow frames
node tools/act.mjs arcane/my-spell # watch the performance at 12fps
check.mjs é o interessante. Ele faz lint de um efeito pelas quatro maneiras como esse tipo de código costuma quebrar: desenhar fora dos limites, emendas visíveis no ponto de loop, números aleatórios que não vieram da seed e frames lentos demais. É uma suíte de testes para arte.
Há também um plugin para Claude Code, para um agente autorar efeitos contra o mesmo lint. O README credita o ensaio de Hugo Duprez sobre fazer efeitos de pixel art com Claude pelo método: código é argila, confie nos olhos, alimente a IA com referências.
As ressalvas honestas
Pixel art é um estilo, e esta biblioteca é comprometida com um. Se o seu jogo é 3D, pictórico ou usa arte vetorial, a maior parte disso não é para você — o valor é a arquitetura, não os assets.
A contagem do próprio README mudou (uma revisão anterior falava em 299 efeitos, a build atual tem 244), o que sugere poda ativa em vez de acúmulo. Normalmente é bom sinal, mas significa que qualquer tutorial que você encontrar pode citar efeitos que não existem mais.
E a licença tem uma exceção que vale saber: MIT no código e nos efeitos, exceto a fonte Patch Pixel em gallery/fonts, que é do autor e não está coberta.
O que você recebe de fato é uma resposta funcional a uma pergunta que a onda generativa tornou urgente: como manter o ofício autoral num pipeline cada vez mais automatizado? A resposta do Patch é tornar o ofício executável — determinístico, lintável, com seed, exportável — para que um agente possa participar sem dissolvê-lo em ruído.
Artigos relacionados
Uma planilha comunitária de toques que desliga os anúncios dos Android chineses
Não mexe no sistema, não desbloqueia nada, não faz flash de nada. Só vira os botões que os fabricantes já deixaram à mostra. O preço é uma lista que alguém precisa continuar escrevendo.
GPT Image 2.6 manteve o preço por token e elevou a fatura
O GPT Image 2.6 mantém cada tarifa por token do 2.5 e mesmo assim custa mais por imagem, porque boa parte do trabalho acontece agora nos tokens de saída. Onze dias após o lançamento, a estrutura de preços diz mais que o ranking.
Alguém reconstruiu o IDM por fora e anotou o que não tocou
Uma reimplementação em Rust do Internet Download Manager promete 5 vezes a velocidade e 86 idiomas. O documento mais interessante é o parágrafo que explica como ela foi feita sem copiar nada.
Rune é um framework de UI em Rust feito para que um agente possa verificar o próprio trabalho
Rune renderiza sem interface, despeja sua árvore de elementos e aceita entrada roteirizada, o que dá a um agente de código um sinal diffável que um screenshot nunca oferece. O framework está em pré-lançamento e não aceita pull requests.