# VfxSmith

> AI pixel VFX creation and asset management, with a free library of 245 open-source effects (MIT, based on pixelfx by Patch) with a browser editor that exports transparent sprite sheets with Aseprite-style JSON, PNG frame sequences, GIFs and ready Godot 4 packs (scene, SpriteFrames, pivot, impact signals). Any effect can be recolored with a Hue setting; color, speed and direction requests are applied instantly without credits.

## Pages

- [AI creation guide](https://vfxsmith.com/guides/ai-pixel-vfx/): prompts, model modes, project isolation and exports
- [Effect library](https://vfxsmith.com/effects/): every effect with preview, palette controls and PNG + JSON downloads
- [Collections](https://vfxsmith.com/collections/): combat, magic, environment and pickup sets
- [Editor](https://vfxsmith.com/workspace/): customize an effect and export it for an engine
- [Guides](https://vfxsmith.com/guides/): using sprite sheets in games
- [Godot 4 guide](https://vfxsmith.com/guides/godot-pixel-vfx/): the Godot pack, spawning effects, mirroring and impact signals
- [Pricing](https://vfxsmith.com/pricing/): free library and editor; AI runs cost 5/15/40 credits (Standard/Enhanced/Ultra); plans Starter $12.90/month for 180 credits, Pro $29/month for 500 credits, Ultra $59/month for 1100 credits
- [Developer docs](https://vfxsmith.com/docs/): run the JavaScript effects in a canvas game
- [Licenses](https://vfxsmith.com/licenses/): MIT license and upstream notices

## Data

- [Effect catalog JSON](https://vfxsmith.com/assets/catalog.json): ids, names, sizes, timing and tags
- Per effect: https://vfxsmith.com/assets/effects/%7Bid%7D/sheet.png and https://vfxsmith.com/assets/effects/%7Bid%7D/sheet.json
- Per effect, Godot 4 pack: https://vfxsmith.com/assets/effects/%7Bid%7D/godot.zip — unzip one folder anywhere in a Godot project; {name}.tscn is an AnimatedSprite2D placed by the effect's pivot that plays once, frees itself, mirrors with `facing = -1`, and emits `beat(index)` on impact frames

## For AI coding agents (Godot)

- Pick effects from the catalog JSON by tags, duration and loop; download godot.zip; instance the scene at the hit point; connect `beat` to damage, hit-stop or camera shake.
- The open-source repository ships a CLI, `node tools/vfxsmith.mjs`: `list <query>` (Chinese or English), `export <id|effect.js> --godot <dir> [--color blue] [--hue deg] [--set key=value]`, and `character --preset swordfighter|brawler|sentinel --godot <dir>` for animated characters with per-frame sockets (weapon_tip, hand, chest, head) so effects can follow the body.
- New effects without a model or account: `kit --examples` lists the effect kit's components (flash, ring, fireBurst, smoke, sparks, embers, rocks, dust, scorch, light, slash, cut, glint, hitStar, dustRing, cracks, bolt, arcs, orb) with their parameters; write a JSON spec placing them in time and space and run `compose spec.json --godot <dir> --preview sheet.png`. Size, pivot and duration are computed and the effect ends transparent.
- Sources generated in the editor download as effect.js and export the same way.