← Torna al blog
Aicirca 7 min di lettura

pixelfx: 244 effetti pixel art che sono codice, non sprite

Pubblicato 10 nov 2026
pixelfx: 244 effetti pixel art che sono codice, non sprite

La prima cosa strana di pixelfx è che gli effetti sono codice. Non sprite. Non sprite sheet. Piccoli file JavaScript che disegnano un fotogramma quando gli passate un valore di tempo.

export const fx = {
  duration: 0.8,
  draw(p, t, o) { /* pixels for second t */ }
}

Quella decisione di design si propaga a tutto il resto, ed è il motivo per cui vale la pena dare un'occhiata alla libreria anche se la pixel art non vi interessa. Uno sprite sheet è la registrazione fissa di qualcosa che è accaduto una volta. Una funzione è la risposta a una domanda: che aspetto ha questo a t = 0.37, con questo seed, a quest'angolo, ribaltato?

pixelfx di Patch ne contiene 244: fuoco, esplosioni, acqua, ghiaccio, fulmine, fantascienza, mischia, impatti, proiettili, comparsa e morte, arcano, sacro, ombra, stati, natura, meteo, interfaccia, oggetti raccoglibili, transizioni e animaletti. Più dodici «mosse» complete che incatenano effetti in una rotazione dal caricamento al recupero: freccia perforante, fendente in scatto, colpo a terra, lancio di palla di fuoco, colpo di luce sacra.

Licenza MIT. Sta salendo in fretta da quando è comparsa, ed è il secondo repo creativo in stile agente di coding di questa settimana a richiamare attenzione vera: il primo era una skill per modelli di immagine, il secondo è questo.

Due tipi di effetto, e perché la differenza conta

Leggendo la documentazione, gli effetti si dividono in due gruppi netti.

Funzioni pure. Il fotogramma al secondo t è determinato interamente da t. Nessuno stato, nessun accumulo, perfettamente ciclabile. Buono per tutto ciò che deve poter essere scorso avanti e indietro, o per renderizzare lo stesso effetto su dieci macchine e ottenere dieci risultati identici.

Simulazioni. Particelle, detriti e luce avanzano a 120 Hz. Il risultato dipende dal frame rate come in un motore fisico. Buono per tutto ciò in cui i detriti dovrebbero reagire a quello che succede.

Quasi tutte le librerie di effetti vi danno l'uno o l'altro senza dire quale. Dare un nome alla differenza è il genere di cosa che vi risparmia un pomeriggio tre mesi dopo, quando qualcuno chiede perché lo stesso effetto nel trailer sembra diverso.

Sotto entrambi c'è un'architettura a doppio buffer: un buffer di colore per i pixel veri e propri e un buffer di luce per il bagliore additivo sovrapposto. Il calore in un effetto di fuoco viene dal secondo buffer, non da pixel più chiari. È lo stesso trucco usato in parecchi motori 2D, ed è il motivo per cui questi effetti si leggono come «illuminati» invece che «colorati dentro».

Tutto è seedato

È la riga che mi ha fatto prendere sul serio il repo:

Tutti i numeri casuali vengono dal seed dell'effetto. Il fotogramma 40 è identico ogni volta.

La riproducibilità per gli effetti non è un extra. È la differenza tra un bug che potete correggere e un bug che non riuscite a riprodurre. Se la scintilla del vostro impatto è sbagliata in una build, una libreria con seed vi permette di renderizzare il fotogramma 12 con seed 4471 e guardarlo. Una libreria che ri-genera il seed a ogni chiamata vi lascia a fissare un video e a tirare a indovinare.

Rende anche la libreria compatibile con un flusso diventato normale quest'anno: fate generare un effetto a un agente, renderizzatelo, guardate il render, correggete, renderizzate di nuovo. Quel ciclo ha senso solo se il render è deterministico. Altrimenti l'agente sta ottimizzando contro il rumore.

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

Installarla e usarla

npm i github:patch-gg/pixelfx

Oppure copiate src/core più gli effetti che vi servono, se preferite non prendere una dipendenza.

Il runtime non ha dipendenze e funziona con 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);
}

Notate le passate "back" e "front". Gli effetti disegnano dietro e davanti al personaggio, che è la differenza tra una palla di fuoco in cui il personaggio sta dentro e una palla di fuoco che il personaggio tiene in mano.

Le opzioni includono flip, angle, seed, palette e light. Quella della palette è più utile di quanto suoni:

node tools/render.mjs fire/torch --gif --opts '{"palette": ["#102","#215","#43a","#8cf","#cff","#fff"]}'

Una rampa esadecimale dal buio alla luce, passata al momento del render, trasforma una torcia in una fiamma blu senza toccare il sorgente. Per un gioco con varianti elementali, è l'intera funzione.

Portarla dentro un motore

L'esportazione è in due passi, ed entrambi esistono come script:

node tools/render.mjs ice/frost-nova --sheet   # one effect: PNG grid + JSON
node tools/sheets.mjs                          # the whole library into sheets/

Il JSON ha la forma di Aseprite: rettangoli dei fotogrammi, durate, più un blocco meta.pixelfx con fps, flag di loop, numero di colonne e ancora. Significa che Godot, Unity, GameMaker, Defold, LÖVE e Bevy hanno già un importer che lo legge, e il loader di atlas di Phaser lo prende direttamente.

Scegliere il formato di Aseprite invece di uno fatto in casa è la decisione meno glamour e più corretta del repo. Nessuno ha voglia di scrivere un importer per il vostro formato.

Lo strato di recitazione

Settantatré effetti hanno la recitazione del personaggio incorporata: il personaggio carica, colpisce, l'impatto si blocca su un fotogramma di scatto, il bersaglio trema e viene respinto. La struttura dati è una lista di pose con i tempi, più gli eventi di impatto:

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 }],
};

I tempi negativi significano che il personaggio comincia a muoversi prima che l'effetto parta, che è come funziona l'anticipazione. La voce hits porta durata del congelamento, ampiezza della scossa e distanza di spinta. Chi ha regolato a mano un valore di hitstop sa quanta parte del «game feel» viva in quei quattro numeri.

Il manichino in dotazione è una figura grigia di 24×38 costruita su uno scheletro 3D a lunghezza fissa — bacino, colonna, spalle — resa con poche tinte piatte. È un riferimento, non arte. Ma è il riferimento giusto, perché gli effetti che stanno bene su un rettangolo stanno male su un corpo.

Farsene una

Il kit per creare effetti è di quattro comandi:

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 è quello interessante. Fa il lint di un effetto sui quattro modi in cui questo tipo di codice di solito si rompe: disegno fuori dai limiti, cuciture visibili nel punto di loop, numeri casuali che non vengono dal seed e fotogrammi troppo lenti. È una suite di test per l'arte.

C'è anche un plugin per Claude Code, così un agente può creare effetti contro lo stesso lint. Il README attribuisce il metodo al saggio di Hugo Duprez sugli effetti pixel art realizzati con Claude: il codice è argilla, fidatevi dei vostri occhi, date riferimenti all'AI.

Le avvertenze oneste

La pixel art è uno stile, e questa libreria ne ha scelto uno. Se il vostro gioco è 3D, o pittorico, o usa arte vettoriale, quasi tutto questo non fa per voi: il valore è l'architettura, non gli asset.

Il conteggio nel README si è mosso (una revisione precedente parlava di 299 effetti, la build attuale è 244), il che suggerisce potatura attiva più che accumulo. Di solito è un buon segno, ma significa che qualsiasi tutorial troviate può citare effetti che non esistono più.

E la licenza ha una deroga da conoscere: MIT su codice ed effetti, tranne il font Patch Pixel in gallery/fonts, che è dell'autore e non è coperto.

Quello che vi portate a casa è una risposta funzionante a una domanda che l'ondata generativa ha reso urgente: come si tiene il mestiere artigianale dentro una pipeline sempre più automatizzata? La risposta di Patch è rendere il mestiere eseguibile — deterministico, verificabile con un lint, seedabile, esportabile — così un agente può parteciparvi senza dissolverlo nel rumore.

Articoli correlati