跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

pixelfx

Make pixel art effects and sprite animations in code with the pixelfx library, which has 244 ready-made ones, acted out by a character who winds up, freezes on contact and recovers (fire, explosions, water, ice, lightning, sci-fi, melee, impacts, projectiles, spawn and death, arcane, holy, shadow, status, nature, weather, UI, pickups, transitions, critters) to drop into a game, recolor, export as sprite sheets or remix, plus a draft, render, look, refine loop that makes new ones look hand-animated. Use when someone wants pixel art VFX, sprite animations or sprite sheets, game juice, a specific effect ("a frost nova for my mage", "a coin pickup sparkle"), wants to use or export a pixelfx effect in Godot, Unity, Phaser or a canvas game, or wants their pixel effects to look better.

patch-gg · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add patch-gg/pixelfx --skill pixelfx

技能说明


name: pixelfx description: Make pixel art effects and sprite animations in code with the pixelfx library, which has 244 ready-made ones, acted out by a character who winds up, freezes on contact and recovers (fire, explosions, water, ice, lightning, sci-fi, melee, impacts, projectiles, spawn and death, arcane, holy, shadow, status, nature, weather, UI, pickups, transitions, critters) to drop into a game, recolor, export as sprite sheets or remix, plus a draft, render, look, refine loop that makes new ones look hand-animated. Use when someone wants pixel art VFX, sprite animations or sprite sheets, game juice, a specific effect ("a frost nova for my mage", "a coin pickup sparkle"), wants to use or export a pixelfx effect in Godot, Unity, Phaser or a canvas game, or wants their pixel effects to look better. license: MIT compatibility: Node 18 or newer. ffmpeg is optional (GIF and MP4 previews).

pixelfx

Pixel art effects as code. Each effect is one file, src/fx/<category>/<name>.js, that draws into two buffers: color (pixels: opaque, dithered or truly translucent) and light (additive glow). No images, so an effect can be played live, recolored, mirrored, reseeded and rendered to a sprite sheet for any engine.

The method is Hugo Duprez's (How to make (good) pixel art effects with Claude): code is clay, trust your eyes, feed your references. One-shot prompts make mediocre effects. Drafts you render, look at and refine make good ones.

Before anything

  1. Work in a pixelfx checkout. If the working directory has no tools/render.mjs, clone one next to the project: git clone https://github.com/patch-gg/pixelfx. No install step: the tools use only Node.
  2. Check it runs: node tools/render.mjs fire/torch writes records/fire/torch/contact.png. Open that PNG with your image-reading tool. That contact sheet is how you see every effect from now on.

1. Look for an existing effect first

node tools/list.mjs <words> searches ids, names, tags and descriptions (node tools/list.mjs frost, node tools/list.mjs slash loop). docs/CATALOG.md lists everything by category. Render the candidates and look at them before choosing. Most requests are an existing effect with different options:

  • palette: the main ramp, dark to bright, as hex strings. Any PAL ramp in src/core/color.js (fire ember lava smoke dust ice water electric volt poison holy heal arcane shadow blood earth stone gold leaf wood metal bone neon cyber matrix candy night) or your own. A blue fire is {"palette": PAL.ice}.
  • seed for a different but equivalent take; flip to face left; angle to rotate; light (0..1+) for glow strength; plus each effect's own knobs in its meta.options (size, count, radius, text, height...).
  • Try options without editing code: node tools/render.mjs fire/torch --opts '{"palette":["#102","#215","#43a","#8cf","#fff"]}'.

2. Put it in the game

Canvas or WebGL games in JS or TS (plain canvas, Phaser, PixiJS, Kaplay, three.js): use the code directly. It has no dependencies; copy src/core and the effect files you need, or depend on the repo.

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

const frame = createFrame(320, 180);            // the game's pixel resolution; ox, oy scroll it with the camera
const img = new ImageData(320, 180);
const fx = createFx(frostNova, { x: hero.x, y: hero.y, flip: hero.facing < 0 });

// every tick
fx.update(dt);
clearFrame(frame);
fx.draw(frame, "back");    // what goes behind characters
drawCharacters();          // your own sprites, or draw them into frame.color yourself
fx.draw(frame, "front");
composite(frame, img.data, background);   // color over the background plus light; or null for transparent
ctx.putImageData(img, 0, 0);              // then scale the canvas up with image-rendering: pixelated
if (fx.done()) removeIt();               // one-shots end on their own; fx.stop() fades a loop out

Several effects can share one frame. In a WebGL engine, upload the composited RGBA to a texture each frame, or render the effect to a sprite sheet once (below) and play it like any other animation.

Any engine (Godot, Unity, GameMaker, Defold, LÖVE, Bevy, Construct): export sprite sheets. node tools/render.mjs ice/frost-nova --sheet writes records/ice/frost-nova/frost-nova.png (transparent frames in a grid) and frost-nova.json (Aseprite-style frames, so Phaser's atlas loader, Godot and Unity Aseprite importers and most tools read it; meta.pixelfx has fps, loop, frame size, columns and the pivot). Set the pivot to meta.pixelfx.pivot (the effect's origin, e.g. the feet), import with nearest-neighbour filtering and no compression, and play at meta.pixelfx.fps. Glow is baked into the sheet as color with alpha, which reads as additive over dark scenes; for bright scenes, render a recolored version or keep the effect on a dark layer.

For the full library: node tools/render.mjs <category> --sheet does a whole category.

A hit needs a body behind it. An effect alone looks like a sticker. Effects with a character carry an act: when the body winds up, when to freeze, how the target reacts. Use it whichever way the game is built:

  • With the stock character: createAct(slash, { x, y }) instead of createFx. act.update(dt), act.draw(frame), and throw the picture by act.shake. It holds still by itself during a freeze. node tools/act.mjs <id> --sheet bakes the lot into a sprite sheet.
  • With the game's own character: read the timing, slash.act or meta.pixelfx.act in a sheet's JSON (windup, recovery, hits with t and freeze). Play the character's attack animation windup seconds before the effect, and at each hit stop updating everything,
阅读完整来源 ↗