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 才能参与进来,而不把它稀释成噪声。
相关文章
一份社区维护的点击表,关掉了国产 Android 系统里的广告
它不动系统,不解锁,不刷机,只把厂商本来就留出来的开关一个个拨过去。代价是这份名单得一直有人续写。
GPT Image 2.6 守住 token 价格,账单却涨了
GPT Image 2.6 沿用了 2.5 的全部 token 费率,单张图却更贵,因为更多的活现在花在输出 token 上。上线十一天,定价结构说的比排行榜更多。
有人从外部重建了 IDM,并写下了自己没有碰过的部分
Mister Download Manager 用 Rust 重写了 Internet Download Manager 的下载流程,声称速度快 5 倍、支持 86 种语言。更值得细读的,是它解释如何在不复制任何代码的前提下完成重写的那一段。
Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作
Rune 能无头渲染、导出元素树并接受脚本化输入,这让编码 agent 拿到截图永远给不了的东西,一个可 diff 的信号。这个框架仍是预发布版本,不接受 pull request。