pixelfx: 244 efectos de pixel art que son código, no sprites

Lo primero raro de pixelfx es que los efectos son código. No sprites. No hojas de sprites. Pequeños archivos de JavaScript que dibujan un fotograma cuando les pasas un valor de tiempo.
export const fx = {
duration: 0.8,
draw(p, t, o) { /* pixels for second t */ }
}
Esa decisión de diseño se ramifica en todo lo demás, y es la razón por la que la librería merece un vistazo aunque el pixel art no te interese lo más mínimo. Una hoja de sprites es una grabación fija de algo que ocurrió una vez. Una función es una respuesta a una pregunta: ¿cómo se ve esto en t = 0.37, con esta semilla, en este ángulo, volteado?
pixelfx, de Patch, incluye 244: fuego, explosiones, agua, hielo, rayos, ciencia ficción, cuerpo a cuerpo, impactos, proyectiles, aparición y muerte, arcano, sagrado, sombra, estados, naturaleza, clima, interfaz, objetos recogibles, transiciones y criaturas. Además, doce «movimientos» completos que encadenan efectos en una rotación desde el armado hasta la recuperación: flechazo, tajo con dash, golpe al suelo, lanzamiento de bola de fuego, impacto de luz sagrada.
Licencia MIT. Lleva subiendo rápido desde que apareció, y es el segundo repositorio creativo con sabor a agente de código que atrae atención real esta semana: el primero fue un skill de modelos de imagen, el segundo es este.
Dos clases de efecto, y por qué la diferencia importa
Lee la documentación y los efectos se dividen limpiamente en dos.
Funciones puras. El fotograma en el segundo t está determinado por completo por t. Sin estado, sin acumulación, perfectamente reproducible en bucle. Sirve para todo lo que tenga que poder recorrerse fotograma a fotograma, o para renderizar el mismo efecto en diez máquinas y obtener diez resultados idénticos.
Simulaciones. Partículas, escombros y luz avanzan a 120 Hz. El resultado depende de la tasa de fotogramas igual que un motor de física. Sirve para todo aquello en lo que los escombros deban reaccionar a lo que está pasando.
Casi todas las librerías de efectos te dan una cosa o la otra sin decir cuál. Nombrar la diferencia es de esas cosas que te ahorran una tarde tres meses después, cuando alguien pregunta por qué el mismo efecto se ve distinto en el tráiler.
Debajo de ambos hay una arquitectura de doble búfer: un búfer de color para los píxeles y un búfer de luz para el resplandor aditivo que se superpone. El calor de un efecto de fuego sale del segundo búfer, no de píxeles más brillantes. Es el mismo truco que usan muchos motores 2D y la razón de que estos efectos se lean como «iluminados» y no como «coloreados».
Todo lleva semilla
Esta es la línea que me hizo tomarme el repositorio en serio:
Todos los números aleatorios salen de la semilla del efecto. El fotograma 40 se ve igual siempre.
La reproducibilidad no es un extra en los efectos. Es la diferencia entre un fallo que puedes arreglar y un fallo que no puedes reproducir. Si la chispa de tu impacto se ve mal en una compilación, una librería con semilla te deja renderizar el fotograma 12 con la semilla 4471 y mirarlo. Una librería que vuelve a sembrar en cada llamada te deja delante de un vídeo, adivinando.
También hace que la librería encaje con un flujo que se ha vuelto normal este año: que un agente genere un efecto, lo renderice, mire el render, lo arregle y vuelva a renderizar. Ese bucle solo tiene sentido si el render es determinista. Si no, el agente está optimizando contra el ruido.

Instalación y uso
npm i github:patch-gg/pixelfx
O copia src/core y los efectos que quieras, si prefieres no añadir una dependencia.
El runtime no tiene dependencias y funciona con canvas, Phaser, PixiJS, Kaplay y 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);
}
Fíjate en las pasadas "back" y "front". Los efectos se dibujan detrás y delante del personaje, que es la diferencia entre una bola de fuego en la que el personaje está metido y una bola de fuego que el personaje sostiene en la mano.
Las opciones incluyen flip, angle, seed, palette y light. La de la paleta es más útil de lo que suena:
node tools/render.mjs fire/torch --gif --opts '{"palette": ["#102","#215","#43a","#8cf","#cff","#fff"]}'
Una rampa hex de oscuro a claro, pasada en el momento del render, convierte una antorcha en una llama azul sin tocar el código fuente. Para un juego con variantes elementales, esa es la función completa.
Meterlo en un motor
La exportación va en dos pasos, y los dos existen como scripts:
node tools/render.mjs ice/frost-nova --sheet # one effect: PNG grid + JSON
node tools/sheets.mjs # the whole library into sheets/
El JSON tiene forma de Aseprite: rectángulos de fotograma, duraciones y un bloque meta.pixelfx con fps, banderas de bucle, número de columnas y ancla. Eso significa que Godot, Unity, GameMaker, Defold, LÖVE y Bevy ya tienen un importador que lo leerá, y que el cargador de atlas de Phaser lo acepta directamente.
Elegir el formato de Aseprite en lugar de uno propio es la decisión menos glamurosa y más correcta del repositorio. Nadie quiere escribir un importador para tu formato.
La capa de actuación
Setenta y tres de los efectos llevan la actuación del personaje incorporada: el personaje arma el golpe, lo lanza, el impacto se congela en un fotograma de golpe, el objetivo tiembla y retrocede. La estructura de datos es una lista de poses con tiempos, más 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 }],
};
Los tiempos negativos hacen que el personaje empiece a moverse antes de que arranque el efecto, que es como funciona la anticipación. La entrada hits lleva duración del congelado, amplitud del temblor y distancia de empuje. Quien haya ajustado a mano un valor de hitstop sabe cuánto de la «sensación de juego» vive en esos cuatro números.
El muñeco de serie es una figura gris de 24×38 montada sobre un esqueleto 3D de longitud fija —pelvis, columna, hombros— renderizada en unos pocos tonos planos. Es una referencia, no arte. Pero es la referencia correcta, porque los efectos que quedan bien sobre un rectángulo quedan mal sobre un cuerpo.
Hacer los tuyos
El kit para crear efectos son cuatro 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 es el interesante. Analiza un efecto buscando las cuatro formas en que este tipo de código suele romperse: dibujo fuera de sus límites, costuras visibles en el punto de bucle, números aleatorios que no vienen de la semilla y fotogramas demasiado lentos. Es una batería de pruebas para arte.
También hay un plugin de Claude Code, para que un agente pueda crear efectos contra ese mismo análisis. El README atribuye el método al ensayo de Hugo Duprez sobre hacer efectos de pixel art con Claude: el código es arcilla, fíate de tus ojos, dale referencias a la IA.
Las advertencias honestas
El pixel art es un estilo, y esta librería se compromete con uno. Si tu juego es 3D, o pictórico, o usa arte vectorial, casi todo esto no es para ti: el valor está en la arquitectura, no en los recursos.
El recuento del propio README se ha movido (una revisión anterior decía 299 efectos, la versión actual son 244), lo que sugiere una poda activa más que acumulación. Suele ser buena señal, pero significa que cualquier tutorial que encuentres puede referirse a efectos que ya no existen.
Y la licencia tiene una excepción que conviene conocer: MIT en el código y los efectos, salvo la fuente Patch Pixel en gallery/fonts, que es del propio autor y no está cubierta.
Lo que te llevas es una respuesta que funciona a una pregunta que la ola generativa ha vuelto urgente: ¿cómo mantener el oficio de autor en un pipeline cada vez más automatizado? La respuesta de Patch es hacer ejecutable el oficio —determinista, analizable, con semilla, exportable— para que un agente pueda participar en él sin disolverlo en ruido.
Artículos relacionados
Una hoja de cálculo comunitaria de toques que apaga la publicidad de los Android chinos
No toca el sistema, no desbloquea nada, no flashea nada. Solo mueve los interruptores que los fabricantes ya dejaron a la vista. El precio es una lista que alguien tiene que seguir escribiendo.
GPT Image 2.6 mantuvo el precio por token y subió la factura
GPT Image 2.6 mantiene cada tarifa por token de 2.5 y aun así cuesta más por imagen, porque buena parte del trabajo ocurre ahora en tokens de salida. Once días después del lanzamiento, la estructura de precios dice más que el ranking.
Alguien reconstruyó IDM desde fuera y anotó lo que no tocó
Una reimplementación en Rust de Internet Download Manager promete 5 veces la velocidad y 86 idiomas. El documento más interesante es el párrafo que explica cómo se construyó sin copiar nada.
Rune es un framework de UI en Rust creado para que un agente pueda comprobar su propio trabajo
Rune renderiza sin interfaz, vuelca su árbol de elementos y acepta entrada programada, lo que da a un agente de código una señal diffeable que una captura nunca ofrece. El framework está en prelanzamiento y no acepta pull requests.