← 返回部落格
Ai預計閱讀 8 分鐘

pixelfx 的 244 個特效是程式碼:可重現、可 lint 的像素美術

發布於 2026年11月10日
pixelfx 的 244 個特效是程式碼:可重現、可 lint 的像素美術

pixelfx 第一件奇怪的事,是特效本身就是程式碼。不是 sprite,不是 sprite sheet。是小小的 JavaScript 檔案,你給它一個時間值,它就畫出一格。

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

這個設計決定會一路延伸到其他所有地方,也是這個函式庫值得一看的原因,即使你對像素美術沒興趣。sprite sheet 是某件發生過的事的固定錄影。函式則是對一個問題的回答:在 t = 0.37、用這個 seed、這個角度、翻轉過的情況下,它長什麼樣?

Patch 的 pixelfx 附了 244 個——火焰、爆炸、水、冰、閃電、科幻、近戰、打擊、投射物、生成與死亡、秘法、神聖、暗影、狀態、自然、天氣、UI、拾取物、轉場,還有小生物。外加十二組完整的「招式」,把特效串成從蓄力到收招的一輪動作:箭擊、衝刺斬、地面重擊、火球投擲、聖光打擊。

MIT 授權。它出現後星數爬得很快,是本週第二個引起真正注意的 coding-agent 風格創意 repo——第一個是一個圖像模型技能,第二個就是這個。

兩種特效,以及差別為何重要

讀文件,特效乾淨地分成兩類。

純函式。 第 t 秒的影格完全由 t 決定。沒有 state、沒有累積,可以完美循環。適合任何需要能被拖曳 scrub 的東西,也適合在十台機器上算同一個特效、得到十個一樣的結果。

模擬。 粒子、碎片和光以 120 Hz 推進。結果取決於影格率,就像物理引擎一樣。適合碎片應該對正在發生的事做出反應的場合。

大多數特效庫只給你其中一種,而且不告訴你是哪一種。把差別命名出來,是三個月後有人問「為什麼同一個特效在預告裡看起來不一樣」時,能幫你省下一個下午的那種事。

兩者底下是雙緩衝架構:一個顏色緩衝放像素本身,一個光緩衝放疊在上面的加色光暈。火焰的熱度來自第二個緩衝,不是來自更亮的像素。這跟很多 2D 引擎用的是同一個把戲,也是這些特效讀起來像「打光」而不是「塗色」的原因。

一切都是種子化的

是這一行讓我認真看待這個 repo:

所有隨機數都來自特效的 seed。第 40 格每次都長一樣。

可重現性對特效不是加分項。它是「修得好的 bug」和「重現不了的 bug」之間的差別。如果你的打擊火花在某個 build 裡看起來不對,種子化的函式庫讓你可以在 seed 4471 下算第 12 格,然後看它。一個每次呼叫都重新播種的函式庫,只會讓你盯著影片猜。

它也讓這個函式庫相容於今年變得正常的一種工作流:讓 agent 生成一個特效、算圖、看圖、修、再算。這個迴圈只有在算圖是確定性的時候才有意義。否則 agent 是在對著雜訊最佳化。

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" 兩個 pass。特效會畫在角色後面與前面,那就是「角色站在火球裡」和「角色拿著火球」的差別。

選項包含 flip、angle、seed、palette 和 light。palette 這個比聽起來有用:

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

一組從暗到亮的 hex 漸層,在算圖時傳進去,就能把火把變成藍焰,完全不用動原始碼。對一個有元素變體的遊戲來說,這就是整個功能。

放進引擎

匯出是兩步,兩步都有對應腳本:

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

JSON 是 Aseprite 的格式——影格矩形、長度,加上一個 meta.pixelfx 區塊,裡面有 fps、loop 旗標、欄數和 anchor。意思是 Godot、Unity、GameMaker、Defold、LÖVE 和 Bevy 都已經有現成的匯入器可以讀,Phaser 的 atlas loader 也能直接吃。

選 Aseprite 的格式而不是自訂格式,是這個 repo 裡最不炫、最正確的決定。沒有人想為你的格式寫匯入器。

演出層

有七十三個特效把角色演出一起烘進去了:角色蓄力、揮擊、命中停格在 snap 影格、目標震動並被推開。資料結構是一串帶時間的姿勢,加上命中事件:

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 那筆帶著凍結時間、震動幅度和推開距離。手調過 hitstop 的人都知道,「打擊感」有多少住在這四個數字裡。

內建的假人是 24×38 的灰色人形,建在固定長度的 3D 骨架上——骨盆、脊椎、肩膀——用幾階平塗的色階算圖。它是參考,不是美術。但它是對的參考,因為在一個長方形上好看的特效,放到身體上就是錯的。

做自己的特效

用來製作特效用的是四行指令:

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 才是有意思的那個。它對特效做 lint,檢查這類程式碼常壞的四種方式:畫出自己的邊界、循環點上看得見的接縫、不是來自 seed 的隨機數,以及太慢的影格。那是給美術用的測試套件。

另外還有一個 Claude Code 外掛,所以 agent 可以照同一套 lint 來做特效。README 把方法歸功於 Hugo Duprez 那篇用 Claude 做像素特效的文章:程式碼是黏土,相信你的眼睛,餵參考給 AI。

老實的但書

像素美術是一種風格,而這個函式庫只押一種。如果你的遊戲是 3D、是繪畫風、或用向量美術,這裡大部分不適合你——價值在架構,不在素材。

README 自己的數字變過(早期版本寫 299 個特效,現在是 244),這說明是主動刪減而不是堆積。那通常是好跡象,但也意味著你找到的任何教學都可能引用已經不存在的特效。

授權有一個例外條款值得知道:程式碼和特效都是 MIT,除了 gallery/fonts 裡的 Patch Pixel 字型,那是作者自己的,不在授權範圍內。

你真正拿到的,是對一個生成浪潮讓它變急迫的問題的可行答案:在一條越來越自動化的 pipeline 裡,怎麼保住手工的技藝?Patch 的答案是讓技藝變成可執行的——確定性、可 lint、可種子化、可匯出——這樣 agent 可以參與其中,而不會把它溶成雜訊。

相關文章