244 effetti pixel art, ognuno un piccolo pezzo di codice leggibile

pixelfx è apparso il 30 ottobre e ha raccolto 5.960 stelle in circa una settimana. Non distribuisce pesi né API. Distribuisce 244 file, ognuno con un effetto, ognuno abbastanza breve da leggere in una seduta.
Fuoco, esplosioni, acqua, ghiaccio, fulmini, fantascienza, corpo a corpo, impatti, proiettili, spawn e morte, arcano, sacro, ombra, status, natura, meteo, UI, pickup, transizioni, animaletti e dodici mosse complete. Ognuno vive in `src/fx//.js`.
La distribuzione è voluta: da undici a tredici effetti per categoria, mai cento in un mucchio e due in un altro. Una libreria di quella dimensione si sfoglia. Una libreria da novecento è un problema di ricerca.
Il metodo viene da lontano
Il README lo riconosce. L'approccio è di Hugo Duprez, da un post intitolato «How to make (good) pixel art effects with Claude», e si riduce a tre istruzioni: il codice è argilla, fidati dei tuoi occhi, dai da mangiare ai tuoi riferimenti.
I suoi effetti open source su Sprite Fusion hanno fissato l'asticella, e `src/core/sim.js` in questo repository adatta il suo codice con l'attribuzione in cima ai file che lo fanno. Questo progetto è la stessa idea su scala di libreria, più una skill per portarla avanti.
La ragione per cui il codice funziona come mezzo va detta. Un effetto pixel art è una piccola simulazione: particelle con velocità, gravità e durata, composte su un canvas a bassa risoluzione e poi agganciate a una palette. Scritto come dati più un ciclo, è ispezionabile, regolabile e portabile. Esportato come sprite sheet, è una sequenza fissa di frame e ogni parametro è congelato.
Per questo gli effetti qui suonano dal vivo, si ricolorano, si specchiano e si esportano. Il codice è l'asset e lo sprite sheet è un sottoprodotto.
I personaggi recitano davvero
Il dettaglio che separa questo da un pacchetto di particelle sta nel secondo paragrafo del README: ogni effetto che coinvolge un personaggio è recitato. Carica, rilascia, si blocca al contatto e recupera, e il bersaglio incassa il colpo.
Dodici mosse complete concatenano effetti in attacchi dalla preparazione al recupero: tiro di freccia, colpo in scatto, pestata di terra, lancio di palla di fuoco, schiacciata a terra, punizione sacra, e altre sei.
È artigianato dell'animazione espresso come struttura dati. Un effetto che si limita a partire va bene in una galleria e male in un gioco, perché un gioco ha attesa e conseguenza. La preparazione dice al giocatore che sta arrivando qualcosa. Il blocco al contatto è il colpo che registra. Il recupero è il permesso di agire di nuovo.
Codificare questo come tre fasi per effetto significa che la libreria porta conoscenza di timing oltre ai frame. Significa anche che l'output è compatibile con il modo in cui un loop di gioco sequenzia davvero gli eventi, che è la differenza tra un asset che puoi usare e uno che devi ritimare.
Come se ne usa uno
In un gioco browser, canvas, Phaser, PixiJS, Kaplay o three.js, l'import è diretto e non ci sono dipendenze:
import { createFrame, clearFrame, createFx, composite } from "pixelfx";
import * as frostNova from "pixelfx/fx/ice/frost-nova";
Ogni effetto è un modulo, quindi un bundler porta solo ciò che è importato. Conta più di quanto sembri: una libreria che puoi ridurre a una sola frost nova è una libreria che puoi mettere in un progetto di jam senza pensare al peso.
La galleria su patch-gg.github.io/pixelfx suona tutto insieme, e c'è un catalogo in `docs/CATALOG.md` che elenca tutti i 244 con le categorie. Per i motori che vogliono frame invece di codice, c'è l'export in sprite sheet.
La skill, e che cosa significa «pignolo» qui
L'altra metà del repository è una skill per Claude Code che crea nuovi effetti «come farebbe un pixel artist pignolo»: abbozza, renderizza, guarda, affina.
Quel ciclo è la parte interessante. L'agente scrive un effetto candidato, lo renderizza, guarda il risultato e lo cambia. Il repository fornisce il renderer e la galleria che rendono possibile guardare, che è la precondizione reale. Un agente che non può vedere il proprio output può solo produrre codice che compila.
La nota di metodo nel README, fidati dei tuoi occhi e dai da mangiare ai tuoi riferimenti, è un consiglio per l'umano quanto per il modello. La skill funziona perché il ciclo di feedback è visivo e stretto, non perché il modello abbia buon gusto.
Tre vie d'uscita dalla libreria
L'export è dove una libreria code-first deve dimostrare di essere più di una demo. Il repository offre gli effetti come moduli importabili, come riproduzione dal vivo nella galleria con controlli di ricolorazione e specchiatura, e come sprite sheet per i motori che vogliono frame.
La via dello sprite sheet è la concessione, ed è quella che la maggior parte dei team di gioco userà per prima. Un foglio è una sequenza fissa: nessun parametro, nessun costo a runtime, nessun modo di variare il flash di un colpo al momento dell'impatto. È anche ciò di cui ha bisogno un motore non JavaScript, e ciò di cui ha bisogno un artista prima di decidere se un effetto valga l'adattamento.
Ricolorazione e specchiatura contano più di quanto sembri per una libreria da 244 effetti. Un solo effetto di ghiaccio ricolorato in quattro modi e specchiato due volte sono otto asset da un file, ed è così che una libreria piccola copre un gioco grande.
Perché una libreria conta ancora nell'era degli agenti
L'obiezione ovvia: se un agente può scrivere qualsiasi effetto su richiesta, perché scaricarne 244?
Due ragioni, entrambe visibili in come è strutturato il repository.
La prima è un pavimento. Un agente a cui chiedi una palla di fuoco produrrà una palla di fuoco. Un agente con davanti 244 implementazioni di riferimento, ognuna scritta con le stesse convenzioni e la stessa struttura in fasi, produrrà qualcosa che sta nella libreria. Le convenzioni sono la parte costosa di un codice condiviso, e un corpus di esempi coerenti è come si trasmettono.
La seconda è che parte della conoscenza non sta nel prompt. La catena da dodici mosse con preparazione, blocco al contatto e recupero è una decisione di design sul game feel. Puoi descriverla in una frase, ma il valore sta nell'averla applicata 244 volte, così che ogni effetto obbedisca alla stessa grammatica di timing.
Questo è una libreria: non un mucchio di asset, un insieme di decisioni già prese in modo coerente.
La licenza e la forma della cosa
MIT. Autore patch-gg, adattato in parte dal lavoro open source di Duprez con attribuzione, e onesto su quali parti sono prese in prestito.
Il repository ha una settimana di vita ed è il tipo di progetto che tende a continuare a crescere, perché la skill rende economico aggiungere l'effetto 245. Se crescerà, il numero interessante non sarà quello delle stelle. Sarà se il 250esimo effetto somiglia ai primi 244, che è l'unica prova reale che le convenzioni siano state trasmesse o solo che i file sono stati copiati.
Per ora il repository è una buona risposta a una domanda che salta fuori ogni volta che qualcuno dice che il codice è il nuovo formato di asset. Qui è un caso in cui lo è evidentemente: 244 effetti, ognuno un file che puoi leggere, ognuno una simulazione che puoi ritarare, tutto abbastanza piccolo da tenere in testa un effetto alla volta.
Articoli correlati
Gli agenti si spostano nel cloud: il task continua quando chiudi il portatile
Il task continua in una VM cloud dopo che hai chiuso il portatile, ma perdi il tooling interno e resta aperto chi approva le azioni irreversibili.
NVIDIA rilascia quattro modelli del mondo da 16 miliardi e un decoder 25 volte più veloce sulla geometria
Quattro generatori del mondo da 16 miliardi con le ricette di training, e un framework di decoding che emette geometria in un colpo. La valutazione manca.
Le skill occupano un quarto dei trend di GitHub, e ognuna si installa a modo suo
Una skill è una cartella di istruzioni, ma installarla ha quattro strade diverse e la copia locale non ha ancora un lockfile.
Un modello da 594 miliardi in cima alle classifiche. I pesi, però, non ci sono
Un modello forte, numeri buoni e una ricetta da leggere, ma i pesi che renderebbero verificabile la dichiarazione non sono ancora usciti.