← 返回博客
Ai预计阅读 8 分钟

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

发布于 2026年11月10日
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 是在对着噪声优化。

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"]}'

一条从暗到亮的十六进制色阶,在渲染时传进去,就能把火把变成蓝焰,不动源码。对有元素变体的游戏,这就是全部功能。

弄进引擎里

导出分两步,两步都是脚本:

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 才能参与进来,而不把它稀释成噪声。

相关文章