fx-bundle

Generates standalone static Texture2D or animated SpriteFrames visual effects for Godot projects.

531|45|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/RandallLiuXin/GodotMaker --skill fx-bundle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fx-bundle
Source: https://github.com/RandallLiuXin/GodotMaker/tree/main/skills/assets/fx-bundle
Command: npx skills add https://github.com/RandallLiuXin/GodotMaker --skill fx-bundle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating game visual effects like projectiles, explosions, and muzzle flashes requires generating source art, slicing sprite sheets, and compiling Godot resources, which is tedious to do manually and error-prone when timing, grids, and frame order must stay consistent.

Core Features & Use Cases

  • Static Effect Generation: Produces one transparent Texture2D PNG for detached effects such as pickups, slash arcs, or dust, with deterministic magenta-background cleanup, scaling, and centering.
  • Animated Effect Generation: Builds one SpriteFrames resource from an explicit grid, ordered frame names, FPS, loop flag, and per-frame durations, with GIF preview and per-frame PNG output.
  • Validated Production Loop: Runs L0-L4 validation including a real Godot import/load probe, records full provenance traces, and emits a machine-readable ASSET_RESULT.json handoff.
  • Use Case: Ask for an animated explosion effect with a 4x2 grid at 12 FPS, and receive a validated SpriteFrames .tres file plus a stable grid sheet ready to reference in a Godot scene.

Quick Start

Generate an animated explosion effect as a SpriteFrames resource with a 4x2 grid at 12 FPS for my Godot project.

Frequently Asked Questions about fx-bundle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an animated SpriteFrames effect for Godot?

Submit a request with asset_type fx-bundle, spec.mode animated, one action defining grid columns and rows, ordered frame names, FPS, loop flag, and per-frame durations. The skill generates the source art, slices frames deterministically, and compiles a validated SpriteFrames .tres file.

What visual effects can this Godot asset skill create?

It creates detached foreground effects: projectiles, impacts, explosions, pickups, muzzle flashes, slash arcs, aura loops, and dust. Output is limited to one static Texture2D or one animated SpriteFrames, never particle nodes, shaders, trails, or multi-node scenes.

Does the fx-bundle skill support pixel art effects?

No, pixel-art requests are unsupported in this version. The skill stops clearly rather than quantizing, nearest-neighbour scaling, or labelling ordinary generated art as pixel art.

Can it generate particle systems or PackedScene effects?

No, particle PackedScenes, trails, shaders, lights, sounds, collision shapes, and lifecycle scripts are explicitly out of scope. Requesting one is a STOP condition since the deliverable must be a single Texture2D or SpriteFrames resource.

Why does effect generation stop instead of producing output?

Stops occur only when a required input is unreadable, a declared provider or reference attachment is unavailable, the request is contradictory, or the deliverable is unsupported. Processing or validation failures are treated as repairable diagnostics, not stop conditions.