← Retour au blog
AiEnviron 8 min de lecture

pixelfx : 244 effets de pixel art qui sont du code, pas des sprites

Publié le 10 nov. 2026
pixelfx : 244 effets de pixel art qui sont du code, pas des sprites

La première chose étrange dans pixelfx, c'est que les effets sont du code. Pas des sprites. Pas des planches de sprites. De petits fichiers JavaScript qui dessinent une image quand vous leur donnez une valeur de temps.

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

Cette décision de conception se répercute sur tout le reste, et c'est la raison de regarder la bibliothèque même si le pixel art ne vous intéresse pas. Une planche de sprites est l'enregistrement figé de quelque chose qui a eu lieu une fois. Une fonction est une réponse à une question : à quoi ça ressemble à t = 0.37, avec cette graine, sous cet angle, retourné ?

Le pixelfx de Patch en livre 244 — feu, explosions, eau, glace, foudre, science-fiction, corps à corps, impacts, projectiles, apparitions et morts, arcanique, sacré, ombre, états, nature, météo, interface, objets à ramasser, transitions et bestioles. Plus douze « mouvements » complets qui enchaînent les effets en une rotation, de l'armé à la récupération : frappe de flèche, tranche-élan, coup au sol, lancer de boule de feu, impact de lumière sacrée.

Sous licence MIT. La popularité grimpe vite depuis son apparition, et c'est le deuxième dépôt créatif de la semaine orienté agent de code à attirer une vraie attention — le premier étant une compétence pour modèle d'image, le second celui-ci.

Deux familles d'effets, et pourquoi la distinction compte

Lisez la doc et les effets se séparent proprement en deux.

Fonctions pures. L'image à la seconde t est entièrement déterminée par t. Pas d'état, pas d'accumulation, parfaitement bouclable. Bon pour tout ce qui doit être scrubbable, ou pour rendre le même effet sur dix machines et obtenir dix résultats identiques.

Simulations. Particules, débris et lumière avancent à 120 Hz. Le résultat dépend de la fréquence d'images comme celui d'un moteur physique. Bon pour tout ce où les débris doivent réagir à ce qui se passe.

La plupart des bibliothèques d'effets vous donnent l'un ou l'autre sans dire lequel. Nommer la différence, c'est le genre de chose qui vous épargne un après-midi trois mois plus tard, quand quelqu'un demande pourquoi le même effet ne rend pas pareil dans la bande-annonce.

Sous les deux, il y a une architecture à double tampon : un tampon de couleur pour les pixels eux-mêmes, et un tampon de lumière pour le halo additif posé par-dessus. La chaleur d'un effet de feu vient du second tampon, pas de pixels plus clairs. C'est la même astuce que dans beaucoup de moteurs 2D, et c'est ce qui fait lire ces effets comme « éclairés » plutôt que « coloriés ».

Tout est semé

C'est la phrase qui m'a fait prendre le dépôt au sérieux :

Tous les nombres aléatoires viennent de la graine de l'effet. L'image 40 est la même à chaque fois.

La reproductibilité n'est pas un confort pour des effets. C'est la différence entre un bug qu'on peut corriger et un bug qu'on ne peut pas reproduire. Si votre étincelle d'impact rend mal dans un build, une bibliothèque semée vous permet de rendre l'image 12 avec la graine 4471 et de la regarder. Une bibliothèque qui re-sème à chaque appel vous laisse devant une vidéo, à deviner.

Cela rend aussi la bibliothèque compatible avec un workflow devenu normal cette année : faire générer un effet par un agent, le rendre, regarder le rendu, corriger, rendre à nouveau. Cette boucle n'a de sens que si le rendu est déterministe. Sinon l'agent optimise contre du bruit.

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

Installation et usage

npm i github:patch-gg/pixelfx

Ou copiez src/core plus les effets qui vous intéressent, si vous préférez éviter une dépendance.

Le runtime est sans dépendance et fonctionne avec canvas, Phaser, PixiJS, Kaplay et 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);
}

Notez les passes "back" et "front". Les effets se dessinent derrière et devant le personnage, ce qui fait la différence entre une boule de feu dans laquelle le personnage se tient et une boule de feu qu'il tient.

Les options incluent flip, angle, seed, palette et light. Celle de palette est plus utile qu'elle n'en a l'air :

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

Une rampe hexadécimale du sombre vers le clair, passée au moment du rendu, transforme une torche en flamme bleue sans toucher à la source. Pour un jeu avec des variantes élémentaires, c'est toute la fonctionnalité.

L'intégrer à un moteur

L'export se fait en deux temps, et les deux existent en scripts :

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

Le JSON a la forme d'Aseprite — rectangles d'images, durées, plus un bloc meta.pixelfx avec fps, drapeaux de boucle, nombre de colonnes et ancre. Ce qui veut dire que Godot, Unity, GameMaker, Defold, LÖVE et Bevy ont tous un importateur existant qui le lira, et que le chargeur d'atlas de Phaser le prendra directement.

Choisir le format d'Aseprite plutôt qu'un format maison est la décision la moins glamour et la plus juste du dépôt. Personne n'a envie d'écrire un importateur pour votre format.

La couche de jeu d'acteur

73 des effets intègrent le jeu d'acteur du personnage : il s'arme, frappe, l'impact se fige sur une image de rupture, la cible tremble et recule. La structure de données est une liste de poses avec des temps, plus des événements d'impact :

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

Les temps négatifs signifient que le personnage commence à bouger avant que l'effet ne démarre, c'est ainsi que fonctionne l'anticipation. L'entrée hits porte une durée de gel, une amplitude de tremblement et une distance de recul. Quiconque a réglé à la main une valeur de hitstop sait quelle part du « game feel » tient dans ces quatre nombres.

Le mannequin fourni est une silhouette grise de 24×38 bâtie sur un squelette 3D de longueur fixe — bassin, colonne, épaules — rendue en quelques teintes plates. C'est une référence, pas de l'art. Mais c'est la bonne référence, parce qu'un effet qui rend bien sur un rectangle rend mal sur un corps.

Créer les vôtres

La boîte à outils d'authoring tient en quatre commandes :

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 est la plus intéressante. Elle lint un effet sur les quatre façons dont ce genre de code casse d'habitude : dessiner hors de ses bornes, coutures visibles au point de bouclage, nombres aléatoires qui ne viennent pas de la graine, et images trop lentes. C'est une suite de tests pour de l'art.

Il existe aussi un plugin Claude Code, pour qu'un agent puisse écrire des effets contre le même lint. Le README crédite l'essai de Hugo Duprez sur la création d'effets de pixel art avec Claude pour la méthode : le code est de l'argile, faites confiance à vos yeux, donnez des références à l'IA.

Les réserves honnêtes

Le pixel art est un style, et cette bibliothèque s'y tient. Si votre jeu est en 3D, pictural, ou en vectoriel, l'essentiel ne vous servira pas — la valeur est dans l'architecture, pas dans les assets.

Le compte du README a bougé (une révision antérieure annonçait 299 effets, la version actuelle en a 244), ce qui suggère un élagage actif plutôt qu'une accumulation. C'est généralement bon signe, mais cela veut dire que tout tutoriel que vous trouverez peut référencer des effets qui n'existent plus.

Et la licence comporte une exception à connaître : MIT sur le code et les effets, sauf la police Patch Pixel dans gallery/fonts, qui appartient à l'auteur et n'est pas couverte.

Ce que vous obtenez vraiment, c'est une réponse fonctionnelle à une question que la vague générative a rendue urgente : comment garder un artisanat d'auteur dans un pipeline de plus en plus automatisé ? La réponse de Patch est de rendre l'artisanat exécutable — déterministe, lintable, semable, exportable — pour qu'un agent puisse y participer sans le dissoudre en bruit.

Articles associés