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

244個のピクセルアートエフェクト、どれも読めるコード1ファイル

公開日 2026年11月11日
244個のピクセルアートエフェクト、どれも読めるコード1ファイル

pixelfxは10月30日に現れ、1週間ほどで5,960スターを集めた。重みもAPIも出荷しない。244のファイルを出荷し、それぞれが1つのエフェクトを含み、どれも一息で読める長さだ。

火、爆発、水、氷、雷、SF、近接、衝撃、飛翔体、スポーンと死亡、秘術、聖、影、状態、自然、天候、UI、拾い物、トランジション、小動物、そして12のムーブ全体。すべて `src/fx//.js` にある。

配分は意図的だ。1カテゴリ11〜13個で、片方に100、片方に2、ということはない。その規模のライブラリは眺められる。900のライブラリは検索問題だ。

手法には出どころがある

READMEがクレジットしている。アプローチはHugo Duprezのもので、「How to make (good) pixel art effects with Claude」という記事に由来し、3つの指示に要約される。コードは粘土、目を信じる、参照を食わせる。

Sprite Fusionでの彼のオープンソースのエフェクトが水準を定め、このリポジトリの `src/core/sim.js` はそのコードを、該当ファイル冒頭の帰属表示付きで取り込んでいる。このプロジェクトは同じ発想をライブラリの規模にしたもので、続けるためのスキルも付いている。

コードがこの用途の媒体として機能する理由は書く価値がある。ピクセルアートのエフェクトは小さなシミュレーションだ。速度、重力、寿命を持つ粒子を低解像度のキャンバスに合成し、パレットに寄せる。データとループとして書けば、検査でき、調整でき、移植できる。スプライトシートとして書き出せば、固定されたフレーム列になり、すべてのパラメータが凍る。

だからここのエフェクトはライブで再生し、色を変え、反転し、書き出せる。コードが資産で、スプライトシートは副産物だ。

キャラクターが実際に演技する

粒子パックとこれを分ける細部はREADMEの2段落目にある。キャラクターが関わるエフェクトはすべて演技される。タメを作り、放ち、接触で止まり、戻る。対象は打撃を受ける。

12のムーブ全体が、エフェクトをタメから戻りまでの攻撃に連ねる。矢、ダッシュ斬り、地団駄、火球投げ、グラウンドパウンド、ホーリースマイト、あと6つ。

これはデータ構造として表現されたアニメーションの技だ。ただ再生されるエフェクトはギャラリーでは美しく見え、ゲームでは間違って見える。ゲームには予備動作と結果があるからだ。タメは何かが来ると伝える。接触での停止はヒットの記録だ。戻りはもう一度動いてよいという許可だ。

エフェクトごとに3つの位相として符号化することは、ライブラリがフレームだけでなくタイミングの知識を運ぶということだ。ゲームループが実際にイベントを並べる方法と互換になるということでもあり、そのまま使える資産と、時間を合わせ直す資産の差になる。

1つ使う

ブラウザゲーム、canvas、Phaser、PixiJS、Kaplay、three.jsで、インポートは直接的で依存はない:

import { createFrame, clearFrame, createFx, composite } from "pixelfx";
import * as frostNova from "pixelfx/fx/ice/frost-nova";

各エフェクトはモジュールなので、バンドラはインポートされたものだけを出す。これは聞こえ以上に重要だ。フロストノヴァ1つにツリーシェイクできるライブラリは、重さを気にせずジャムプロジェクトに入れられるライブラリだ。

patch-gg.github.io/pixelfx のギャラリーは全部を同時に再生し、`docs/CATALOG.md` に244個すべてをカテゴリ付きで並べたカタログがある。コードではなくフレームを欲しがるエンジンには、スプライトシートの書き出しがある。

スキルと、ここでの「細かい」の意味

リポジトリのもう半分はClaude Codeのスキルで、新しいエフェクトを「細かいピクセルアーティストならこうする」やり方で作る。下書きし、レンダリングし、見て、磨く。

このループが面白い部分だ。エージェントが候補のエフェクトを書き、レンダリングし、結果を見て、変える。リポジトリはレンダラとギャラリーを提供し、見ることを可能にする。それが実際の前提条件だ。自分の出力を見られないエージェントは、コンパイルが通るコードしか作れない。

READMEの手法メモ、目を信じ参照を食わせる、はモデルと同じくらい人間への助言だ。スキルが機能するのは、フィードバックループが視覚的で間隔が短いからで、モデルに良い趣味があるからではない。

ライブラリから出る3つの道

書き出しは、コード優先のライブラリがデモ以上であることを証明しなければならない場所だ。リポジトリはエフェクトを、インポート可能なモジュールとして、ギャラリーでの色変更と反転付きのライブ再生として、フレームを欲しがるエンジン向けのスプライトシートとして提供する。

スプライトシートの道は譲歩で、大半のゲームチームが最初に使うものだ。シートは固定された列で、パラメータもなく、実行時コストもなく、当たった瞬間にヒットフラッシュを変える方法もない。JavaScript以外のエンジンが必要とするものでもあり、アーティストがエフェクトを移植する価値があるか決める前に必要なものでもある。

色変更と反転は、244個のライブラリでは聞こえ以上に効く。1つの氷エフェクトを4通りに染め、2回反転すれば、1ファイルから8つの資産になる。小さなライブラリが大きなゲームを覆う方法だ。

エージェント時代にライブラリがまだ意味を持つ理由

明らかな反論がある。エージェントがオンデマンドでどんなエフェクトも書けるなら、なぜ244個もダウンロードするのか。

理由は2つあり、どちらもこのリポジトリの構造に見えている。

1つ目は下限だ。火球を求められたエージェントは火球を作る。目の前に244の参照実装があり、どれも同じ規約と同じ位相構造で書かれていれば、ライブラリに合うものを作る。規約は共有コードベースで最も高価な部分で、一貫した例のコーパスがそれを伝える方法だ。

2つ目は、知識の一部がプロンプトに入らないことだ。タメ、接触での停止、戻りからなる12のムーブの連鎖は、ゲームの手触りについての設計判断だ。一文で説明はできるが、価値はそれが244回適用され、すべてのエフェクトが同じタイミングの文法に従うことにある。

ライブラリとはそういうものだ。資産の山ではなく、すでに一貫して下された判断の集合。

ライセンスと、この物体の形

MIT。作者はpatch-ggで、一部はDuprezのオープンソース作品から帰属表示付きで改変して取り込み、どこが借り物かを正直に書いている。

リポジトリは1週間もので、スキルが245個目を安く足せるので、成長し続ける種類のプロジェクトだ。成長するなら、面白い数字はスター数ではない。250個目が最初の244個のように見えるかどうかで、それが規約が伝わったのか、ファイルがコピーされただけなのかの唯一の本当のテストだ。

今のところ、コードが新しい資産形式だと言うたびに出る問いへの良い答えになっている。ここでは明らかにそうだ。244のエフェクト、どれも読める1ファイル、どれも調整できる1つのシミュレーション、全体が1つずつ頭に置けるほど小さい。

関連記事