1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pixelfx |
| 作者/维护者 | patch.gg(组织,patch.gg) |
| 来源链接 | https://github.com/patch-gg/pixelfx |
| 许可证 | MIT(NOTICE 注明部分特效改编自 Hugo Duprez 的开源作品) |
| GitHub Stars / Forks | 1,370 / 159(GitHub API,2026-11-01 读取) |
| 最新版本 | 0.3.0;主分支最近一次提交 2026-10-31 |
| 安装方式 | Claude Code 插件市场安装,或把 skills/pixelfx 复制进 ~/.claude/skills/;工具需要一份仓库检出与 Node 18+ |
数据来源:上述数字取自 GitHub API;功能与评分依据来自仓库文档、SKILL.md 与工具源码。
2. 功能介绍与亮点
一句话:它把像素游戏特效变成一段段可读的代码——仓库里有 244 个现成特效,技能负责帮你找到、改好、导出,或按同一套方法造新的。
- 现成特效库:火焰、爆炸、水、冰、闪电、科幻、近战、命中、弹道、生成与死亡、奥术、神圣、暗影、状态、自然、天气、UI、拾取、转场、生物,按类别分文件,每个都是一小段 JS。
- 会「演」的特效:涉及角色的特效按起手、命中定格、收势来画,目标还会做出受击反应;12 个招式可以串成从起手到收招的连招。
- 可调可导出:调色板、随机种子、左右翻转、角度、辉光强度都是参数;可以导出 sprite sheet 给 Godot、Unity、Phaser 或任意引擎。
- 创作回路:技能把「起草 → 渲染 → 看图 → 再改」固化成流程,并强调先找现成的、再改参数、最后才写新的——这正是手工特效好看的原因。
3. 适用场景
所属分类:前端与设计(产出物是像素视觉特效与精灵动画)。
- 用 Claude Code 做浏览器小游戏、Godot/Unity 像素游戏的独立开发者;
- 需要一套现成 VFX 快速把战斗手感做出来的程序或美术;
- 想把特效批量导出成 sprite sheet 交给引擎的团队;
- 想学习「代码即素材」这套像素特效工作流的作者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 插件市场直接安装,技能按 SKILL.md 触发 |
| Codex | 需适配 | 工具是本地 Node 脚本,任何 agent 都能调用;插件安装方式需换成复制技能目录 |
| OpenClaw | 需适配 | 同上,需要平台支持技能目录并允许执行本地命令 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
它把像素特效从「找素材、拼图集」变成「写代码、看效果、再迭代」:244 个现成特效给了起点,技能给了可复用的创作方法,导出又直接对接引擎。对做像素游戏的人来说,这是一条从想法到可用素材的短路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 建仓两天 1,370 stars、159 forks;画廊可在线试玩,传播集中在游戏与像素美术社区 |
| 可用性 | 8 | 插件一行安装,工具零依赖只需 Node 18+;要真正改特效仍需检出仓库、会看图 |
| 安全性 | 8 | 见下方清单;本地 Node 工具,不联网、不需要任何密钥 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 渲染、搜索、导出、本地预览都是仓库内的 Node 脚本,作用域限于读写本仓库与输出文件,无提权 |
| ② 联网外发 | 工具本身不联网;画廊是静态页面,特效在浏览器本地绘制 |
| ③ 凭据 | 不需要任何 API key 或账号凭据 |
| ④ 可疑指令 | 未见注入或夹带推广;SKILL.md 强调先找现成、看图再改,没有诱导外发的内容 |
| ⑤ 作者信誉 | patch.gg 是公开组织,有官网与多个公开仓库;未见刷星证据 |
| ⑥ License | MIT,NOTICE 写清了改编来源 |
| ⑦ 维护时间 | 2026-10-30 建仓,10-31 仍发版 0.3.0 |
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| rossark-motion-skill | 让任意手绘动起来,偏通用动效与角色表演 | 不产出像素素材,也不导出 sprite sheet;pixelfx 专攻像素游戏特效 |
| adu-motion-video | 用模板做 AI 剪辑与短视频 | 产出是视频,不是可进引擎的逐帧素材 |
| blender-skills | Blender 3D 建模与渲染工作流 | 走 3D 管线;pixelfx 是纯代码的 2D 像素路线,零依赖 |
核心差异:同类多在「让画面动起来」,pixelfx 在「产出可直接进游戏的像素特效素材」,并且把创作方法本身做成了技能。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价,仓库 issues 当前为空(2026-11-01)。
9. 其他补充
- 方法源自 Hugo Duprez 的文章《How to make (good) pixel art effects with Claude》与 Sprite Fusion 的开源特效,仓库在 NOTICE 里保留了出处。
- 特效是代码而非图片,改色、换种子、换角度都是改参数,不需要重新画。
10. 安装使用方式
# Claude Code 插件市场
/plugin marketplace add patch-gg/pixelfx
/plugin install pixelfx@pixelfx
或复制技能目录:
git clone https://github.com/patch-gg/pixelfx
cp -r pixelfx/skills/pixelfx ~/.claude/skills/
装好后可以说「给我的法师大招加一个冰霜新星」「把火焰和爆炸两类导出成 Godot 用的 sprite sheet」「这个命中特效太飘了,让它更有打击感」。
11. 注意事项
- 工具要在 pixelfx 检出目录里跑,单独复制技能目录只能拿到说明、拿不到 244 个特效。
- 需要 Node 18+;导出 GIF/MP4 预览时才需要 ffmpeg。
- 特效质量靠「渲染出来看」,纯文本对话里判断不了,建议配合能看图的客户端。
- 商用或二次分发时按 MIT 保留版权与 NOTICE 中的出处署名。