patch-gg/pixelfx

Before Local scripts → After Local scripts

fe7103c36d94 → a84159688af3

- 3 description: Make pixel art effects and sprite animations in code with the pixelfx library, which has 232 ready-made ones (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.
+ 3 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.
+ 76 **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
+ 77 up, when to freeze, how the target reacts. Use it whichever way the game is built:
+ 78 
+ 79 - With the stock character: `createAct(slash, { x, y })` instead of `createFx`. `act.update(dt)`, `act.draw(frame)`, and throw the
+ 80   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.
+ 81 - With the game's own character: read the timing, `slash.act` or `meta.pixelfx.act` in a sheet's JSON (`windup`, `recovery`, `hits`
+ 82   with `t` and `freeze`). Play the character's attack animation `windup` seconds before the effect, and at each hit stop updating
+ 83   everything, effect and characters both, for `freeze` seconds. Host-side hit-stop works on any effect, with or without an act.
+ 84 
+ 85 `src/fx/moves/` has whole attacks chained from the effects, wind-up to recovery: start there when someone asks for a move, not an effect.
+ 86 
- 97 5. **Check.** `node tools/check.mjs <id>` catches drawing outside the canvas, one-shots that don't end empty,
- 98    loop seams, unseeded randomness and slow frames. Fix until it passes clean. Delete the drafts you didn't keep.
+ 108 5. **Act it out** if a character is involved: add `export const act` (see "Acts" in `docs/AUTHORING.md`), with a wind-up before t = 0,
+ 109    a pose change on the release frame, a freeze on contact and a recovery. `node tools/act.mjs <id>` shows consecutive 12 fps steps:
+ 110    judge motion from those and from `--mp4`, not from a contact sheet's samples.
+ 111 6. **Check.** `node tools/check.mjs <id>` catches drawing outside the canvas, one-shots that don't end empty,
+ 112    loop seams, unseeded randomness and slow frames, and in an act: keys out of order, unknown pose fields and hands
+ 113    that teleport. Fix until it passes clean. Delete the drafts you didn't keep.
+ 129 | a great effect on a dead character | give it an act: wind-up, release pose, freeze on contact, a target that reacts, recovery |
+ 130 | the act feels weightless | a wind-up the opposite way to the blow, a longer freeze (up to 0.2 s), a bigger silhouette change, shake |
+ 131 | the hit lands out of sync | move the hit key to the effect's own constant, not to a time you eyeballed |
+ 132 | he holds the weapon badly | keep a bend in the elbow, shafts in front of the chest; on a swing the blade lags the hand; arms reach about 15 px and don't stretch, so step the body in |
+ 133 | his arms cross or the pose looks flat | he faces three-quarters towards us: for open arms the near hand goes left (`fx < 0`), far hand right, with `turn: 1`; `yaw` really turns him |

Compare on GitHub

Before Not checked yet → After Local scripts

First observation → fe7103c36d94

No earlier version was observed for comparison.

Compare on GitHub