⚡ Built for Phaser 4 — Cinematic Explosions, One Function

phaser-fx-v4 is a lightweight, provider-based effects library for Phaser 4.1+. One parametric explosion engine, 18+ tunable knobs, 7 hand-crafted preset looks. Drop it into any scene and ship better-feeling games.

✨ What's inside

• 💥 Grid-based shard explosion — splits any sprite/texture into a configurable col×row grid and animates each piece with physics
• 🎯 18+ parameters — speed, gravity, spread angle, rotation, fade, tint, scale ranges, easing, radial / implode / variance modes
• 🎬 7 preset looks in the live demo — burst, shockwave, vortex, fire, shatter, concussion, fireworks (copy the configs straight into your game)
• 🚀 Performance-first — opt-in object pooling + viewport culling. Auto-detected: implement two methods on your provider and the library uses them
• 🔌 Provider pattern — zero coupling to Phaser internals. Wire up FXProvider once, every effect just works
• 📐 TypeScript-first — full .d.ts definitions, IDE autocomplete out of the box
• 🪶 Tiny — ~25 KB compiled package, ESM, tree-shakeable, zero runtime dependencies

🚀 Usage

import { explodeImage } from "phaser-fx-v4";
const provider = new PhaserFXProvider(this); // your FXProvider, created once
explodeImage(provider, "enemy", 0, {
  x: 400,
  y: 300,
  cols: 10,
  rows: 10,
  speed: 520,
  gravity: 480,
  radial: true,
  scale: { start: 1, end: 0 },
  rotateMaxDeg: 320,
  duration: 900,
  ease: "Quad.easeOut",
  onComplete: () => console.log("💥"),
});

📦 What you get

• dist/index.js — compiled ESM bundle for Vite / Webpack / Rollup
• dist/*.d.ts — full TypeScript definitions
• src/ — TypeScript sources (modify for your own use, per license)
• README.md — install + full API reference
• LICENSE — commercial use, unlimited projects per developer

✅ Requirements

• Phaser ≥ 4.1.0
• A bundler (Vite, Webpack, Rollup, esbuild) — ships ESM only
• TypeScript not required, but recommended for full IDE support

📝 License

Commercial — one license per individual developer, unlimited personal & commercial projects, source modification allowed for your own use. Redistribution and resale prohibited.