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

244 个像素特效,一个特效一个文件,一周 5960 星

发布于 2026年11月11日
244 个像素特效,一个特效一个文件,一周 5960 星

pixelfx 10 月 30 日出现,一周左右 5960 星。它不带权重,不带 API。它带 244 个文件,每个装一个特效,每个短到一次坐下就能读完。

火、爆炸、水、冰、闪电、科幻、近战、命中、投射物、生成与死亡、奥术、神圣、暗影、状态、自然、天气、UI、拾取、转场、小生物,再加十二个完整招式。全在 `src/fx//.js`。

分布是刻意的:每类十一到十三个,绝不让一堆一百个、另一堆两个。这个体量的库可以翻。九百个的库是个搜索问题。

方法有出处

README 写了出处。做法来自 Hugo Duprez,文章标题是「How to make (good) pixel art effects with Claude」,归结成三句:代码是黏土,相信眼睛,喂参考。

他在 Sprite Fusion 上的开源特效立了标准,本仓库的 `src/core/sim.js` 改编自他的代码,相关文件顶部有署名。这个项目是把同一套想法做到库的规模,再加一个技能让它继续长。

代码能当这种媒介,理由值得说。一个像素特效是一个小模拟:粒子带速度、重力、寿命,在低分辨率画布上混合,再吸附到调色板。写成数据加循环,它可以检查、可以调、可以移植。导出成精灵图,它就是一段固定帧序列,每个参数都被冻住。

所以这里的特效可以实时播放、改色、镜像、导出。代码是资产,精灵图是副产品。

角色真的在表演

让它不同于一个粒子包的细节在 README 第二段:每个涉及角色的特效都是演出来的。蓄力、出手、命中定格、收招,目标吃下这一下。

十二个完整招式把特效串成从蓄力到收招的攻击:射箭、冲刺斩、踏地、掷火球、地面重击、神圣惩击,还有六个。

这是把动画手艺表达成数据结构。只播一遍的特效在画廊里没问题,在游戏里就不对,因为游戏有预备和结果。蓄力告诉玩家有东西要来。命中定格是这一下打到了。收招是允许你再次行动。

把每个特效编成三个阶段,意味着这个库带的不只是帧,还有时间感。也意味着输出和游戏循环真正排事件的方式兼容——这是能用的资产和必须重新对时的资产之间的差别。

用其中一个

在浏览器游戏里,canvas、Phaser、PixiJS、Kaplay 或 three.js,直接 import,没有依赖:

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

每个特效是一个模块,打包器只带被 import 的。这比听起来重要:一个能被 tree-shake 到只剩一个霜星的库,是可以不做重量考虑就丢进 game jam 项目的库。

patch-gg.github.io/pixelfx 的画廊一次播全部,`docs/CATALOG.md` 有 244 个的完整目录和分类。要帧而不是要代码的引擎,走精灵图导出。

那个技能,以及「挑剔」指什么

仓库的另一半是一个 Claude Code 技能,让新特效按挑剔的像素画师的方式做出来:起草、渲染、看、改。

这个循环才是有意思的部分。代理写一个候选特效,渲染,看结果,再改。仓库提供渲染器和画廊,让「看」成为可能,这才是真正的前提。看不见自己输出的代理,只能产出能编译的代码。

README 里那句方法提示——相信眼睛、喂参考——既是给人的建议,也是给模型的。技能能工作,是因为反馈闭环是视觉的、紧的,不是因为模型品味好。

三种出库方式

导出是代码优先的库必须证明自己不只是演示的地方。仓库提供三种:可 import 的模块;画廊里带改色和镜像控制的实时播放;给要帧的引擎用的精灵图。

精灵图这条路是妥协,也是多数游戏团队会先用的一种。一张图是固定序列:没有参数,没有运行时开销,也没法在命中那一刻改闪光颜色。它也是非 JavaScript 引擎需要的,以及美术在判断一个特效值不值得改造之前需要的。

对一个 244 个特效的库,改色和镜像比听起来重要。一个冰系特效改四种色、镜像两次,就是一个文件出八个资产——小库覆盖大游戏靠的就是这个。

代理时代为什么还需要一个库

明显的反驳是:代理能按需写任何特效,为什么还要下 244 个。

两个理由,都在仓库的结构里看得见。

第一个是下限。让代理做一个火球,它会做出一个火球。让一个面前摆着 244 个参考实现的代理做,每一个都按同样的约定、同样的阶段结构写的,它做出的东西会融进这个库。约定是共享代码库里最贵的部分,而一批一致的样例是把约定传下去的方式。

第二个是有些知识不在提示词里。带蓄力、命中定格、收招的十二招链,是关于手感的决定。你可以用一句话描述它,但价值在于它被应用了 244 次,让每个特效遵守同一套时间语法。

库就是这个:不是一堆资产,是一组已经一致做过的决定。

许可证和这个东西的形状

MIT。作者 patch-gg,部分改编自 Duprez 的开源工作并署名,也老实说明哪部分是借的。

仓库才一周,属于那种会继续长的项目,因为技能让加第 245 个特效变得很便宜。如果它真的长起来,有意思的数字不是星数。是第 250 个特效看起来像不像前 244 个——这是约定被传下去、还是只复制了文件的唯一真检验。

眼下,这个仓库很好地回答了一个每当有人说「代码是新的资产格式」就会冒出来的问题。这里有个例子它确实是:244 个特效,每个是一个能读的文件,每个是一个能重调的模拟,全都小到可以一次在脑子里装一个。

相关文章