244 个像素特效以代码交付,还能导出 Godot 和 Unity 的精灵表

pixelfx 第一件怪事是:特效是代码。不是精灵图,不是精灵表。是一小段 JavaScript,你给它一个时间值,它画出一帧。
export const fx = {
duration: 0.8,
draw(p, t, o) { /* pixels for second t */ }
}
这个决定会一路渗到别处,也正是即使你对像素画没兴趣也值得看一眼的原因。精灵表是对一件发生过的事的固定录像。函数是对一个问题的回答:在 t = 0.37、这个随机种子、这个角度、镜像的情况下,它长什么样?
Patch 的 pixelfx 交了 244 个——火、爆炸、水、冰、闪电、科幻、近战、命中、飞行物、生成与死亡、奥术、圣光、暗影、状态、自然、天气、UI、拾取、转场,还有小生物。外加十二套完整的「招式」,把特效串成一圈从起手到收招的循环:箭击、冲刺斩、砸地、火球投掷、圣光命中。
MIT 许可。出现之后涨得很快,是这周第二个引起真正关注的编程 agent 风味创意仓库——第一个是个图像模型技能,第二个是这个。
两类特效,区别为什么要紧
读文档,特效干净地分成两半。
纯函数。 第 t 秒的那一帧完全由 t 决定。没有状态,没有累积,可以完美循环。适合任何需要能拖动的场景,也适合在十台机器上渲染同一个特效、拿到十份一模一样的结果。
模拟。 粒子、碎屑、光照按 120 Hz 步进。结果依赖帧率,跟物理引擎一样。适合碎屑该对现场做出反应的那种场景。
多数特效库只给你其中一种,还不说给的是哪种。把区别命名出来,是那种三个月后能省你一下午的事——当有人问为什么同一个特效在预告片里看着不一样。
两类底下都是双缓冲架构:一个颜色缓冲放像素本身,一个光照缓冲放叠在上面的加色光晕。火里的热感来自第二个缓冲,不是来自更亮的像素。这是很多 2D 引擎在用的同一招,也是这些特效读起来像「被照亮」而不是「涂了色」的原因。
一切都是有种子的
让我认真对待这个仓库的是这一句:
所有随机数都来自特效的种子。第 40 帧每次都一样。
可复现对特效不是加分项。它是「能修的 bug」和「复现不了的 bug」之间的差别。如果命中火花在某个构建里不对,有种子的库意味着你可以用种子 4471 渲第 12 帧,然后盯着它看。每次调用都重新播种的库,意味着你只能盯着视频猜。
它也让这个库和今年变得正常的一种工作流兼容:让 agent 生成一个特效、渲染、看渲染、修、再渲染。这个回路只有在渲染是确定的时候才有意义。否则 agent 是在对着噪声优化。

安装与使用
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"]}'
一条从暗到亮的十六进制色阶,在渲染时传进去,就能把火把变成蓝焰,不动源码。对有元素变体的游戏,这就是全部功能。
弄进引擎里
导出分两步,两步都是脚本:
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、循环标记、列数、锚点。这意味着 Godot、Unity、GameMaker、Defold、LÖVE、Bevy 都有现成的导入器能读,Phaser 的图集加载器直接吃。
选 Aseprite 的格式而不是自造一个,是仓库里最不炫、最正确的决定。没人想给你的格式写导入器。
表演层
73 个特效把角色表演烤进去了:角色起手、挥出,命中在一个 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 的灰色小人,搭在一副定长三维骨架上——盆骨、脊椎、肩——用几层平涂色渲染。它是参考,不是美术。但它是正确的参考,因为在矩形上好看的特效,放到身体上就错了。
做自己的
写特效的工具是四条命令:
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 是最有意思的那个。它给特效挑这类代码常犯的四种毛病:画出边界、循环点上有可见接缝、随机数不是从种子来的、帧太慢。这是一套给美术写的测试。
还有一个 Claude Code 插件,agent 可以对着同一套 lint 写特效。README 把方法归功于 Hugo Duprez 那篇用 Claude 做像素特效的文章:代码是泥,相信你的眼睛,给 AI 喂参考。
老实的提醒
像素画是一种风格,这个库忠于一种。如果你的游戏是 3D、是绘画感、或者用矢量美术,这里大部分不适合你——值钱的是架构,不是素材。
README 自己的计数变过(早一版写 299 个,现在这版是 244),说明它在主动精简而不是堆量。这通常是好信号,但也意味着你找到的任何教程都可能提到已经不存在的特效。
许可证有一处例外值得知道:代码和特效是 MIT,但 gallery/fonts 里的 Patch Pixel 字体是作者自己的,不在覆盖范围内。
你真正拿到的,是一个问题的可用答案,而生成浪潮让这个问题变急了:怎么在一条越来越自动化的流水线里保住手工的技艺?Patch 的答案是让技艺变成可执行的——确定、能 lint、能播种、能导出——这样 agent 才能参与进来,而不把它稀释成噪声。
相关文章
十份降级报告,没有一份改了订单数字
十份降级报告都在讲不确定性,没有一份改动订单。真正的变量是 158 美元的恐慌低点和 5.1% 的十年期收益率。
三十三年来第一次,黄仁勋不在电话会上
数字几乎无悬念,真正要看的是克雷斯如何在首次独自主持的电话会上回答指引、Rubin 与毛利率三个问题。
一份社区维护的点击表,关掉了国产 Android 系统里的广告
它不动系统,不解锁,不刷机,只把厂商本来就留出来的开关一个个拨过去。代价是这份名单得一直有人续写。
GPT Image 2.6 守住 token 价格,账单却涨了
GPT Image 2.6 沿用了 2.5 的全部 token 费率,单张图却更贵,因为更多的活现在花在输出 token 上。上线十一天,定价结构说的比排行榜更多。