← ブログに戻る
Ai読了目安 13 分

ピクセルアートのエフェクト244本をコードとして配るpixelfx

公開日 2026年11月10日
ピクセルアートのエフェクト244本をコードとして配るpixelfx

pixelfxでまず奇妙なのは、エフェクトがコードであることです。スプライトではありません。スプライトシートでもありません。時刻の値を渡すと1フレームを描く、小さなJavaScriptファイルです。

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

この設計判断は他のすべてに波及します。ピクセルアートに興味がなくても、このライブラリを一度見る価値がある理由もそこです。スプライトシートは、一度起きたことの固定された記録です。関数は問いへの答えです。t = 0.37で、このシードで、この角度で、反転していたら、これはどう見えるか。

Patchのpixelfxには244本入っています。炎、爆発、水、氷、雷、SF、近接、ヒット、飛び道具、出現と死亡、魔法、聖、影、状態異常、自然、天候、UI、拾い物、トランジション、そして小動物。さらに、予備動作から硬直までを1つのローテーションとして繋いだ12本の「ムーブ」も付いてきます。アローストライク、ダッシュスラッシュ、グラウンドスラム、ファイアボールスロー、ホーリーライトヒット。

MITライセンス。登場から急速に伸びていて、今週のコーディングエージェント系クリエイティブリポジトリで2番目に注目を集めたものです。1つ目は画像モデルのスキル、2つ目がこれ。

2種類のエフェクトと、その違いが効く理由

ドキュメントを読むと、エフェクトはきれいに2つに分かれます。

純粋関数。 t秒のフレームはtだけで完全に決まります。状態も蓄積もなく、完全にループ可能。スクラブできる必要があるもの、あるいは同じエフェクトを10台のマシンで描いて10個の同一結果が欲しい場合に向きます。

シミュレーション。 パーティクル、破片、光が120Hzで進みます。結果は物理エンジンと同じ意味でフレームレートに依存します。破片が起きていることに反応すべき場面に向きます。

エフェクトライブラリの多くは、どちらかを、どちらかと言わずに渡してきます。違いに名前を付けておくのは、3カ月後に「同じエフェクトがトレーラーで違って見えるのはなぜ」と聞かれたとき、午後を1つ節約する類の仕事です。

両者の下にはデュアルバッファの構造があります。ピクセルそのものを入れる色バッファと、その上に重ねる加算発光のための光バッファ。炎の熱は、ピクセルを明るくすることでなく、2つ目のバッファから来ています。2Dエンジンの多くが使っているのと同じ手で、このエフェクトが「塗られた」ではなく「光っている」ように見える理由です。

すべてにシードがある

このリポジトリを真面目に見る気にさせた一文です。

すべての乱数はエフェクトのシードから来る。40フレーム目は毎回同じ。

再現性はエフェクトにとって「あれば嬉しい」ものではありません。直せるバグと、再現できないバグの差です。あるビルドでヒットの火花がおかしいなら、シード付きのライブラリならシード4471の12フレーム目を描いて見ればいい。呼び出しごとにシードを切り直すライブラリでは、動画を眺めて推測するしかありません。

今年は当たり前になったワークフローとも噛み合います。エージェントにエフェクトを書かせ、描画し、描画を見て、直し、また描画する。このループは描画が決定的でなければ意味を持ちません。そうでなければ、エージェントはノイズに対して最適化しているだけです。

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

導入と使い方

npm i github:patch-gg/pixelfx

依存を増やしたくないなら、src/coreと使いたいエフェクトをコピーしても構いません。

ランタイムは依存なしで、canvas、Phaser、PixiJS、Kaplay、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);
}

"back"と"front"のパスに注目してください。エフェクトはキャラクターの後ろと前に描かれます。キャラクターが立っている火球と、キャラクターが持っている火球の違いはここです。

オプションにはflip、angle、seed、palette、lightがあります。パレットは聞こえより便利です。

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

暗から明への16進カラーランプを描画時に渡すだけで、ソースに触らず松明が青い炎になります。属性違いのバリエーションを持つゲームなら、これが機能の全部です。

エンジンに持ち込む

書き出しは2段階で、どちらもスクリプトになっています。

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

JSONはAsepriteの形をしています。フレームの矩形、再生時間、そしてfps、ループフラグ、列数、アンカーを持つmeta.pixelfxブロック。つまりGodot、Unity、GameMaker、Defold、LÖVE、Bevyには既存のインポータがあり、Phaserのアトラスローダーはそのまま読みます。

独自形式ではなくAsepriteの形式を選んだのは、リポジトリで最も地味で最も正しい判断です。あなたの形式のためにインポータを書きたい人はいません。

演技のレイヤー

244本のうち73本にはキャラクターの演技が組み込まれています。キャラクターが構え、振り、ヒットがスナップのフレームで止まり、対象が揺れて押し戻される。データ構造は時刻付きのポーズのリストとヒットイベントです。

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

負の時刻は、エフェクトが始まる前にキャラクターが動き出すことを意味します。予備動作はこうやって作ります。hitsの項目は硬直の長さ、揺れの振幅、押し出し距離を持っています。ヒットストップの値を手で詰めたことがある人なら、「ゲームの手触り」のどれだけがこの4つの数字に宿っているか分かるでしょう。

同梱のダミーは24×38の灰色の人物で、固定長の3Dスケルトン(骨盤、脊椎、肩)の上に、いくつかの平坦な階調で描かれています。アートではなく参照用です。ただし正しい参照です。矩形の上では良く見えるエフェクトが、身体の上では間違って見えるからです。

自分で作る

制作のためのツールキットは4つのコマンドです。

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が面白いところ。この種のコードが壊れる4つの型を検査します。境界の外に描いていないか、ループ点に継ぎ目が見えないか、シードから来ていない乱数がないか、フレームが重すぎないか。アートのためのテストスイートです。

Claude Codeのプラグインもあり、エージェントは同じlintに照らしてエフェクトを書けます。READMEは、Claudeでピクセルアートのエフェクトを作る方法についてのHugo Duprezの文章を手法として挙げています。コードは粘土、目を信じる、AIに参照を渡す。

正直な注意点

ピクセルアートは様式で、このライブラリは1つの様式に絞っています。ゲームが3Dだったり、絵画調だったり、ベクターアートだったりするなら、大半はあなた向けではありません。価値は資産ではなく構造にあります。

READMEの本数は動いています。以前の版は299本と書いていて、現在のビルドは244本です。積み上げではなく削っている証拠で、ふつうは良い兆候ですが、見つけたチュートリアルがもう存在しないエフェクトを参照している可能性もあります。

ライセンスには1つ切り離された部分があります。コードとエフェクトはMITですが、gallery/fontsにあるPatch Pixelフォントは作者自身のもので対象外です。

手に入るのは、生成の波が緊急にした問いへの実用的な答えです。どんどん自動化されるパイプラインの中で、職人の手仕事をどう残すのか。Patchの答えは、手仕事を実行可能にすることでした。決定的で、lintできて、シードを与えられ、書き出せる。そうすればエージェントは、それをノイズに溶かさずに参加できます。

関連記事