pixelfx 深度指南:244 个代码特效与「演技系统」
游戏开发里最费时间的是什么?刀光、爆炸、火焰、冰冻这些特效。开源项目 pixelfx 把这部分直接打包:244 个代码特效、一套"演技系统",再加一个教会 AI 用特效的 Claude Code Skill。
本文依据
基于 DeepWiki 对 patch-gg/pixelfx 仓库的源码分析与公开报道整理;中文圈对该项目的引介可读 豆芽菜小萌的微信文章。该项目 2026 年 10 月底开源,数量仍在持续增加(截至本文撰写官方 README 为 244 个)。
它是代码,不是图片
pixelfx 最重要的设计决策:每个特效是一小段 JavaScript,不是一张死图。特效以单文件形式放在 src/fx/分类/名称.js,零依赖、可在浏览器游戏里直接运行。官方目录按约 20 个分类整理:火焰、爆炸、水流、冰冻、闪电、科幻、近战、打击、投射物、生成与死亡、奥术、神圣、暗影、状态、自然、天气、UI、拾取物、转场、小生物——营火、燃烧的头骨、瀑布、等离子球、传送门、龙卷风都在其中。
"代码化"带来三个直接好处:在线预览(官方网页版预览器可直接看效果)、颜色与代码解耦(一套特效换一组调色板参数就能衍生无数版本)、左右镜像零成本。想让普通火焰烧成蓝色?不用重画:
node tools/render.mjs fire/torch --gif --opts '{"palette": [...]}'
运行时接口:createFx
网页游戏(canvas、Phaser、PixiJS、three.js)接入只要一条 npm i github:patch-gg/pixelfx。运行时入口是 createFx:传入特效模块与选项(位置、镜像等),然后 update(dt) 驱动、draw(frame, "back"|"front") 分前后层绘制;composite 负责合并颜色与光照缓冲。特效契约分两种:纯函数特效导出 draw(p, t, o);模拟型特效导出 create(o),以 120Hz 步进更新。
「演技系统」:打击感的真正来源
这是比"244 个特效"更有价值的部分。单个特效贴在角色身上,观感就像贴纸;真正让打击感成立的是特效周围的身体动作——起手(wind-up)、命中定格(hit-stop)、目标反应、收招(recovery)。pixelfx 把这套"演技"也做成了数据:61 个特效自带角色,12 套完整连招把多个特效串成攻击组合,代码描述身体何时起手、何时定住、目标如何被击退、震屏怎么加。你要做的只是把 createFx 换成 createAct。
导出:一条命令进 Godot / Unity / GameMaker
node tools/render.mjs ice/frost-nova --sheet
--sheet 会输出透明背景 PNG 精灵图 + Aseprite 格式 JSON(帧矩形、帧时长、FPS、循环、列数、锚点都在 meta.pixelfx 里),Godot 与 Unity 的 Aseprite 导入器可直接读取,GameMaker 则使用精灵图。GIF/MP4 预览依赖 ffmpeg(可选)。渲染器生成索引调色板且不做抖动——像素味保住了。
Claude Code Skill:让 AI 学会造特效
安装就两步:
/plugin marketplace add patch-gg/pixelfx
/plugin install pixelfx@pixelfx
装好后直接对 AI 提需求:"给法师的大招加一个魔法星""给金币拾取做五个火花版本,给我看最好的两个""把命中特效做得更有打击感""把火焰和爆炸分类导出成 Godot 精灵图"。Skill 教 AI 按挑剔像素画师的方式干活:起草 → 渲染 → 自己看 → 再改。造新特效的流程也封装成三条命令,其中检查步骤会揪出溢出、接缝、未设随机种子、掉帧这些问题。也可以直接把 skills/pixelfx 拷进 ~/.claude/skills/。
授权与注意事项
商用前必读
①代码与特效均为 MIT 协议(含商用);②但 NOTICE.md 有例外:特效方法源自 Hugo Duprez 的像素特效方案(Sprite Fusion 改编,同为 MIT),gallery/fonts 里的 Patch 像素字体不在 MIT 范围内,商用需单独留意;③想上 Patch 平台发布游戏,需要一台运行 Patch Desktop 的 Windows 电脑做上线前测试;④AI 生成的效果仍需人工确认。
对掌机玩家的意义
pixelfx 主要面向 canvas/网页游戏——GB/GBA 的 4 色调色板装不下这些效果,这点要诚实。但两件事可以直接搬走:一是调色板解耦的工作流(你的 GB 素材同样该把颜色和形状分开管),二是"AI + 检查清单"的特效生产模式(详见 细粒度迭代)。如果你同时做网页小游戏,它几乎就是现成的特效库;掌机侧则用 GB Studio 出 ROM,两条腿走路。