← Zurück zum Blog
Aica. 7 Min. Lesezeit

pixelfx liefert 244 Pixeleffekte als JavaScript-Funktionen

Veröffentlicht 10. Nov. 2026
pixelfx liefert 244 Pixeleffekte als JavaScript-Funktionen

Das Erste, was an pixelfx befremdlich wirkt: Die Effekte sind Code. Keine Sprites. Keine Sprite-Sheets. Kleine JavaScript-Dateien, die ein Frame zeichnen, wenn man ihnen einen Zeitwert gibt.

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

Diese Designentscheidung zieht sich durch alles Weitere, und sie ist der Grund, warum die Bibliothek einen Blick wert ist, auch ohne Interesse an Pixel-Art. Ein Sprite-Sheet ist eine feste Aufzeichnung von etwas, das einmal passiert ist. Eine Funktion ist eine Antwort auf eine Frage: Wie sieht das aus bei t = 0.37, mit diesem Seed, aus diesem Winkel, gespiegelt?

Patchs pixelfx liefert 244 davon – Feuer, Explosionen, Wasser, Eis, Blitze, Science-Fiction, Nahkampf, Treffer, Projektile, Spawn und Tod, Arkan, Heilig, Schatten, Status, Natur, Wetter, UI, Pickups, Übergänge und Kreaturen. Dazu zwölf komplette „Moves“, die Effekte zu einer Rotation von Ausholen bis Erholen verketten: Pfeilschlag, Dash-Slash, Ground Slam, Feuerballwurf, Holy-Light-Treffer.

MIT-Lizenz. Seit dem Erscheinen steigt es schnell, und es ist das zweite der kreativen Repos dieser Woche mit Coding-Agenten-Einschlag, das echte Aufmerksamkeit zieht – das erste war ein Bildmodell-Skill, das zweite ist dieses.

Zwei Arten von Effekt, und warum der Unterschied zählt

Liest man die Doku, teilen sich die Effekte sauber in zwei Gruppen.

Reine Funktionen. Das Frame zur Sekunde t ist vollständig durch t bestimmt. Kein Zustand, keine Akkumulation, perfekt loopbar. Gut für alles, was scrubbar sein muss, oder um denselben Effekt auf zehn Maschinen zu rendern und zehn identische Ergebnisse zu bekommen.

Simulationen. Partikel, Trümmer und Licht laufen mit 120 Hz. Das Ergebnis hängt von der Bildrate ab, so wie bei einer Physik-Engine. Gut für alles, wo die Trümmer auf das Geschehen reagieren sollen.

Die meisten Effektbibliotheken liefern das eine oder das andere, ohne zu sagen, welches. Den Unterschied zu benennen ist die Sorte Entscheidung, die drei Monate später einen Nachmittag rettet, wenn jemand fragt, warum derselbe Effekt im Trailer anders aussieht.

Darunter liegt eine Doppelpuffer-Architektur: ein Farbpuffer für die Pixel selbst und ein Lichtpuffer für den additiven Schein darüber. Die Hitze in einem Feuereffekt kommt aus dem zweiten Puffer, nicht aus helleren Pixeln. Derselbe Trick steckt in vielen 2D-Engines, und er ist der Grund, warum diese Effekte „beleuchtet“ wirken statt „ausgemalt“.

Alles ist geseedet

Diese Zeile hat mich das Repo ernst nehmen lassen:

Alle Zufallszahlen kommen aus dem Seed des Effekts. Frame 40 sieht jedes Mal gleich aus.

Reproduzierbarkeit ist bei Effekten kein Nice-to-have. Sie ist der Unterschied zwischen einem Bug, den man beheben kann, und einem, den man nicht reproduziert. Sieht der Trefferfunke in einem Build falsch aus, kann man mit einer geseedeten Bibliothek Frame 12 mit Seed 4471 rendern und hinsehen. Eine Bibliothek, die bei jedem Aufruf neu seedet, lässt einen auf ein Video starren und raten.

Es macht die Bibliothek außerdem kompatibel mit einem Workflow, der dieses Jahr normal geworden ist: Ein Agent erzeugt einen Effekt, rendert ihn, sieht sich das Rendering an, korrigiert, rendert erneut. Diese Schleife ist nur sinnvoll, wenn das Rendering deterministisch ist. Sonst optimiert der Agent gegen Rauschen.

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

Installieren und benutzen

npm i github:patch-gg/pixelfx

Oder src/core plus die gewünschten Effekte kopieren, wenn man keine Abhängigkeit will.

Die Laufzeit ist abhängigkeitsfrei und funktioniert mit canvas, Phaser, PixiJS, Kaplay und 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);
}

Beachten Sie die Pässe "back" und "front". Effekte zeichnen hinter und vor der Figur, und das ist der Unterschied zwischen einem Feuerball, in dem die Figur steht, und einem, den sie in der Hand hält.

Zu den Optionen gehören flip, angle, seed, palette und light. Die Palette ist nützlicher, als sie klingt:

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

Eine Hex-Rampe von dunkel nach hell, zur Renderzeit übergeben, macht aus einer Fackel eine blaue Flamme, ohne die Quelle anzufassen. Für ein Spiel mit Elementarvarianten ist das das ganze Feature.

In eine Engine bringen

Der Export ist zweistufig, und beide Stufen existieren als Skript:

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

Das JSON hat Aseprite-Form – Frame-Rects, Dauern, plus einen meta.pixelfx-Block mit fps, Loop-Flags, Spaltenzahl und Anker. Damit haben Godot, Unity, GameMaker, Defold, LÖVE und Bevy einen vorhandenen Importer, der es liest, und der Atlas-Loader von Phaser nimmt es direkt.

Aseprates Format zu wählen statt eines eigenen ist die unglamouröseste und richtigste Entscheidung im Repo. Niemand will einen Importer für dein Format schreiben.

Die schauspielerische Ebene

Dreiundsiebzig der Effekte haben Charakter-Acting eingebaut: Die Figur holt aus, schlägt zu, der Treffer friert auf einem Snap-Frame ein, das Ziel zittert und wird zurückgeschoben. Die Datenstruktur ist eine Liste von Posen mit Zeiten plus Trefferereignissen:

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

Negative Zeiten bedeuten, dass die Figur sich bewegt, bevor der Effekt beginnt – so funktioniert Antizipation. Der hits-Eintrag trägt eine Freeze-Dauer, Zittern-Amplitude und Schubdistanz. Wer je einen Hitstop-Wert von Hand eingestellt hat, weiß, wie viel „Game Feel“ in diesen vier Zahlen steckt.

Die mitgelieferte Dummy-Figur ist eine 24×38 graue Gestalt auf einem Skelett mit fester Länge – Becken, Wirbelsäule, Schultern –, gerendert in wenigen flachen Stufen. Sie ist eine Referenz, keine Kunst. Aber die richtige Referenz, weil Effekte, die auf einem Rechteck gut aussehen, auf einem Körper falsch wirken.

Eigene Effekte bauen

Das Autoren-Toolkit sind vier Befehle:

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 ist der interessante. Es lintet einen Effekt auf die vier Arten, wie diese Art Code üblicherweise bricht: Zeichnen außerhalb der Grenzen, sichtbare Nähte am Loop-Punkt, Zufallszahlen, die nicht aus dem Seed kommen, und Frames, die zu langsam sind. Das ist eine Testsuite für Kunst.

Es gibt außerdem ein Claude-Code-Plugin, damit ein Agent Effekte gegen denselben Lint schreiben kann. Die README schreibt die Methode Hugo Duprez' Essay über Pixel-Art-Effekte mit Claude zu: Code ist Ton, den Augen trauen, der KI Referenzen geben.

Die ehrlichen Einschränkungen

Pixel-Art ist ein Stil, und diese Bibliothek ist auf einen festgelegt. Ist das Spiel 3D, malerisch oder vektorbasiert, ist das meiste nichts für Sie – der Wert liegt in der Architektur, nicht in den Assets.

Die Zählung in der README hat sich verschoben (eine frühere Fassung nannte 299 Effekte, der aktuelle Stand ist 244), was auf aktives Ausdünnen statt Anhäufen hindeutet. Meist ein gutes Zeichen, aber es heißt, dass jedes Tutorial, das man findet, Effekte nennen kann, die es nicht mehr gibt.

Und die Lizenz hat eine Ausnahme, die man kennen sollte: MIT für Code und Effekte, außer der Schrift Patch Pixel in gallery/fonts, die vom Autor selbst stammt und nicht abgedeckt ist.

Was man wirklich bekommt, ist eine funktionierende Antwort auf eine Frage, die die generative Welle dringlich gemacht hat: Wie hält man handgemachtes Können in einer Pipeline, die zunehmend automatisiert ist? Patchs Antwort: das Können ausführbar machen – deterministisch, lintbar, seedbar, exportierbar –, damit ein Agent daran teilnehmen kann, ohne es in Rauschen aufzulösen.

Verwandte Artikel