← Voltar ao blog
Aicerca de 7 min de leitura

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

Publicado 10 de nov. de 2026
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.

A sprite sheet grid of pixel-art explosion frames on a light table

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