@fps-games/vfx 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -12,6 +12,14 @@
 
 <!-- release.mjs 在此行下方插入新版本区块 -->
 
+## v0.3.16 — 2026-07-08
+
+### 改动
+- feat(pulse-laser-volley-sequence): add single-shot pulse laser variant
+
+### 特效
+- 新增:pulse-laser-volley-sequence
+
 ## v0.3.11 — 2026-07-07
 
 ### 改动

package/dist/effects/magnet-suction/index.d.ts

@@ -5,6 +5,8 @@ interface MagnetSuctionParams extends VfxParamValues {
     scale: number;
     initialHeight: number;
     color: VfxColorValue;
+    lineColor: VfxColorValue;
+    particleColor: VfxColorValue;
     opacity: number;
     intensity: number;
     forwardOffset: number;

package/dist/effects/magnet-suction/index.js

@@ -20,13 +20,14 @@ const manifest = {
   assets,
   source
 };
-const BOLT_SEGMENTS = 6;
 const DEFAULT_PARAMS = {
   lifetimeMode: "infinite",
   lifetime: 2.5,
   scale: 1.15,
   initialHeight: 0,
-  color: { r: 0.48, g: 0.9, b: 1 },
+  color: { r: 0.82, g: 0.95, b: 1 },
+  lineColor: { r: 0.82, g: 0.95, b: 1 },
+  particleColor: { r: 0.82, g: 0.95, b: 1 },
   opacity: 1,
   intensity: 1,
   forwardOffset: 0,
@@ -38,18 +39,18 @@ const DEFAULT_PARAMS = {
   fadeDistance: 0.58,
   spawnFade: 0.45,
   suctionSpeed: 1.65,
-  lineCount: 0,
+  lineCount: 32,
   lineLength: 0.46,
-  lineWidth: 0.052,
+  lineWidth: 0.045,
   lineOpacity: 1,
   lineSpread: 1,
   lineTwist: 0,
-  particleCount: 5,
-  particleSize: 0.036,
-  particleSpeed: 1.65,
+  particleCount: 22,
+  particleSize: 0.06,
+  particleSpeed: 2.15,
   particleDrift: 0,
   particleOuterOffset: 0,
-  particleOpacity: 0.68,
+  particleOpacity: 0.85,
   directionX: 0,
   directionZ: -1
 };
@@ -69,7 +70,8 @@ const magnetSuctionEffectPackage = {
     { key: "lifetime", label: "自定义时长", kind: "lifetime", min: 0.1, max: 30, step: 0.01 },
     { key: "scale", label: "整体缩放", kind: "scale", min: 0.05, max: 6, step: 0.01 },
     { key: "initialHeight", label: "局部高度", kind: "number", min: -2, max: 4, step: 0.01 },
-    { key: "color", label: "吸入颜色", kind: "color" },
+    { key: "lineColor", label: "线条颜色", kind: "color" },
+    { key: "particleColor", label: "圆点颜色", kind: "color" },
     { key: "opacity", label: "整体透明度", kind: "opacity", min: 0, max: 1, step: 0.01 },
     { key: "intensity", label: "强度", kind: "opacity", min: 0, max: 1, step: 0.01 },
     { key: "forwardOffset", label: "入口前偏移", kind: "number", min: -2, max: 4, step: 0.01 },
@@ -80,14 +82,16 @@ const magnetSuctionEffectPackage = {
     { key: "mouthPadding", label: "入口保护距离", kind: "number", min: 0.01, max: 2, step: 0.01 },
     { key: "fadeDistance", label: "入口淡出距离", kind: "number", min: 0.01, max: 3, step: 0.01 },
     { key: "spawnFade", label: "外侧淡入距离", kind: "number", min: 0.01, max: 3, step: 0.01 },
-    { key: "lineLength", label: "电弧长度", kind: "number", min: 0.02, max: 2, step: 0.01 },
-    { key: "lineWidth", label: "电弧宽度", kind: "number", min: 2e-3, max: 0.18, step: 1e-3 },
-    { key: "lineOpacity", label: "电弧透明度", kind: "opacity", min: 0, max: 1.5, step: 0.01 },
+    { key: "suctionSpeed", label: "线条速度", kind: "number", min: 0, max: 8, step: 0.01 },
+    { key: "lineCount", label: "白线数量", kind: "number", min: 0, max: 96, step: 1 },
+    { key: "lineLength", label: "白线长度", kind: "number", min: 0.02, max: 2, step: 0.01 },
+    { key: "lineWidth", label: "白线尾宽", kind: "number", min: 2e-3, max: 0.18, step: 1e-3 },
+    { key: "lineOpacity", label: "白线透明度", kind: "opacity", min: 0, max: 1.5, step: 0.01 },
     { key: "lineSpread", label: "散布缩放", kind: "number", min: 0.1, max: 2, step: 0.01 },
-    { key: "particleCount", label: "电弧数量", kind: "number", min: 0, max: 24, step: 1 },
-    { key: "particleSize", label: "电弧抖动大小", kind: "number", min: 5e-3, max: 0.3, step: 1e-3 },
-    { key: "particleSpeed", label: "电弧吸入速度", kind: "number", min: 0, max: 8, step: 0.01 },
-    { key: "particleOpacity", label: "电弧闪烁强度", kind: "opacity", min: 0, max: 1, step: 0.01 },
+    { key: "particleCount", label: "粒子数量", kind: "number", min: 0, max: 80, step: 1 },
+    { key: "particleSize", label: "粒子大小", kind: "number", min: 5e-3, max: 0.3, step: 1e-3 },
+    { key: "particleSpeed", label: "粒子速度", kind: "number", min: 0, max: 10, step: 0.01 },
+    { key: "particleOpacity", label: "粒子透明度", kind: "opacity", min: 0, max: 1, step: 0.01 },
     { key: "directionX", label: "吸入方向 X", kind: "number", min: -1, max: 1, step: 0.01 },
     { key: "directionZ", label: "吸入方向 Z", kind: "number", min: -1, max: 1, step: 0.01 }
   ],
@@ -138,15 +142,26 @@ function createMagnetSuctionField(scene, root, params, renderingGroupId) {
   }
 }
 function createSuctionMesh(scene, root, params, material, renderingGroupId) {
-  const boltCount = Math.max(0, Math.round(params.particleCount));
-  const boltVertexCount = boltCount * BOLT_SEGMENTS * 4;
-  const totalVertexCount = boltVertexCount;
+  const lineCount = Math.max(0, Math.round(params.lineCount));
+  const particleCount = Math.max(0, Math.round(params.particleCount));
+  const lineVertexCount = lineCount * 3;
+  const particleVertexCount = particleCount * 4;
+  const totalVertexCount = lineVertexCount + particleVertexCount;
   const positions = new Float32Array(totalVertexCount * 3);
   const colors = new Float32Array(totalVertexCount * 4);
   const indices = [];
-  let time = 0;
-  for (let base = 0; base < totalVertexCount; base += 4) {
-    pushQuadIndices(indices, base);
+  const lines = [];
+  const particles = [];
+  let resetIndex = 1;
+  for (let index = 0; index < lineCount; index += 1) {
+    const base = index * 3;
+    indices.push(base, base + 1, base + 2);
+    lines.push(resetLine({}, true));
+  }
+  for (let index = 0; index < particleCount; index += 1) {
+    const base = lineVertexCount + index * 4;
+    indices.push(base, base + 1, base + 2, base, base + 2, base + 3);
+    particles.push(resetParticle({}, true));
   }
   const mesh = new Mesh("magnet-suction.mesh", scene);
   mesh.parent = root;
@@ -164,7 +179,15 @@ function createSuctionMesh(scene, root, params, material, renderingGroupId) {
   writeGeometry();
   return { update, dispose };
   function update(deltaSeconds) {
-    time += deltaSeconds;
+    const basis = createSuctionBasis(params);
+    for (const line of lines) {
+      line.d -= line.speed * deltaSeconds;
+      if (line.d < basis.mouthPadding) resetLine(line, false);
+    }
+    for (const particle of particles) {
+      particle.d -= particle.speed * deltaSeconds;
+      if (particle.d < basis.mouthPadding) resetParticle(particle, false);
+    }
     writeGeometry();
   }
   function dispose() {
@@ -173,9 +196,8 @@ function createSuctionMesh(scene, root, params, material, renderingGroupId) {
   function writeGeometry() {
     const basis = createSuctionBasis(params);
     const cameraBasis = createCameraBasis(scene, root, basis);
-    const suctionColor = toColor3(params.color);
-    const electric = new Color3(0.82, 0.98, 1);
-    const boltBlue = new Color3(0.25, 0.62, 1);
+    const lineColor = toColor3(params.lineColor ?? params.color);
+    const particleColor = toColor3(params.particleColor ?? params.color);
     const alphaScale = clamp01(params.opacity) * Math.max(0, params.intensity);
     let vertexIndex = 0;
     const putVertex = (position, color, alpha, brightness = 1) => {
@@ -190,66 +212,61 @@ function createSuctionMesh(scene, root, params, material, renderingGroupId) {
       colors[colorOffset + 3] = clamp01(alpha * alphaScale);
       vertexIndex += 1;
     };
-    const putQuad = (a, b, c, d, color, alpha, brightness = 1) => {
-      putVertex(a, color, alpha, brightness);
-      putVertex(b, color, alpha, brightness);
-      putVertex(c, color, alpha, brightness);
-      putVertex(d, color, alpha, brightness);
-    };
-    const putRibbon = (a, b, width, color, alpha, brightness = 1) => {
-      const segment = b.subtract(a);
-      let side = Vector3.Cross(segment, basis.axis);
-      if (side.lengthSquared() < 1e-4) side = cameraBasis.ribbonSide.clone();
-      side.normalize();
-      const half = side.scale(width * 0.5);
-      putQuad(a.subtract(half), a.add(half), b.add(half), b.subtract(half), color, alpha, brightness);
-    };
-    writeBolts(basis, electric, boltBlue, putRibbon);
-    while (vertexIndex < totalVertexCount) {
-      putVertex(Vector3.Zero(), suctionColor, 0);
+    for (const line of lines) {
+      const alpha = lineFade(line.d, basis) * params.lineOpacity * line.alphaMul;
+      const headD = Math.max(basis.mouthPadding, line.d);
+      const tailD = Math.min(basis.length, line.d + line.len);
+      const head = suctionPosition(headD, line.u, line.v, basis);
+      const tail = suctionPosition(tailD, line.u, line.v, basis);
+      const shrink = Math.max(lateralScale(headD, basis), 0.18);
+      const half = cameraBasis.ribbonSide.scale(line.width * shrink * 0.5);
+      putVertex(tail.subtract(half), lineColor, alpha, line.brightness);
+      putVertex(tail.add(half), lineColor, alpha * 0.92, line.brightness);
+      putVertex(head, lineColor, alpha * 0.22, line.brightness);
+    }
+    for (const particle of particles) {
+      const fade = lineFade(particle.d, basis);
+      const alpha = Math.sqrt(fade) * params.particleOpacity * particle.alphaMul;
+      const center = suctionPosition(particle.d, particle.u, particle.v, basis);
+      const shrink = Math.max(lateralScale(particle.d, basis), 0.48);
+      const right = cameraBasis.particleRight.scale(particle.size * shrink);
+      const up = cameraBasis.particleUp.scale(particle.size * shrink * 0.7);
+      putVertex(center.subtract(right).subtractInPlace(up), particleColor, alpha, particle.brightness);
+      putVertex(center.add(right).subtractInPlace(up), particleColor, alpha, particle.brightness);
+      putVertex(center.add(right).addInPlace(up), particleColor, alpha * 0.8, particle.brightness);
+      putVertex(center.subtract(right).addInPlace(up), particleColor, alpha * 0.8, particle.brightness);
     }
     mesh.updateVerticesData(VertexBuffer.PositionKind, positions, false, false);
     mesh.updateVerticesData(VertexBuffer.ColorKind, colors, false, false);
-    function writeBolts(currentBasis, boltColor, edgeColor, writeRibbon) {
-      for (let bolt = 0; bolt < boltCount; bolt += 1) {
-        const seed = sequence01(bolt + 7, bolt % 8);
-        const speedScale = Math.max(0, params.particleSpeed) / DEFAULT_PARAMS.particleSpeed;
-        const cycle = (time * speedScale * (1.45 + seed * 0.55) + seed) % 1;
-        const flicker = sequence01(bolt * 17 + Math.floor(time * 20), bolt % 8);
-        const active = flicker > 0.28 ? 1 : 0.18;
-        const angle = bolt * 2.399 + time * (1.7 + seed * 0.9);
-        const lengthScale = Math.max(0.04, params.lineLength / DEFAULT_PARAMS.lineLength);
-        const boltLength = lerp(currentBasis.length * 0.16, currentBasis.length * 0.28, seed) * lengthScale;
-        const headDistance = lerp(currentBasis.length * 0.92, currentBasis.mouthPadding * 1.15, cycle);
-        let previousDistance = Math.min(currentBasis.length, headDistance + boltLength);
-        let previous = suctionPosition(
-          previousDistance,
-          Math.cos(angle) * currentBasis.spreadX * 0.5 * lateralScale(previousDistance, currentBasis),
-          Math.sin(angle * 1.3) * currentBasis.spreadY * 0.5 * lateralScale(previousDistance, currentBasis),
-          currentBasis
-        );
-        for (let segment = 0; segment < BOLT_SEGMENTS; segment += 1) {
-          const t = (segment + 1) / BOLT_SEGMENTS;
-          const distance = Math.max(currentBasis.mouthPadding * 1.08, lerp(previousDistance, headDistance, t));
-          const suckScale = lateralScale(distance, currentBasis);
-          const jitter = (sequence01(bolt * 19 + segment + Math.floor(time * 18), segment) - 0.5) * 0.34 * currentBasis.spreadX * suckScale;
-          const curl = angle + t * (2.6 + seed * 1.8) + Math.sin(time * 4 + bolt) * 0.35;
-          const next = suctionPosition(
-            distance,
-            Math.cos(curl) * currentBasis.spreadX * suckScale * (1 - t * 0.45) + jitter,
-            Math.sin(curl * 1.25) * currentBasis.spreadY * suckScale * (1 - t * 0.5),
-            currentBasis
-          );
-          const mouthFade = smoothstep(0.04, 0.18, cycle) * (1 - smoothstep(0.88, 1, cycle));
-          writeRibbon(previous, next, basis.lineWidth * 0.58, segment % 2 === 0 ? boltColor : edgeColor, 0.38 * params.lineOpacity * active * mouthFade, 1.85);
-          previous = next;
-        }
-      }
-    }
   }
-}
-function pushQuadIndices(indices, base) {
-  indices.push(base, base + 1, base + 2, base, base + 2, base + 3);
+  function resetLine(line, initial) {
+    const basis = createSuctionBasis(params);
+    line.d = initial ? randomRange(basis.mouthPadding + 0.05, basis.length) : basis.length + randomRange(0, basis.spawnFade);
+    line.u = randomRange(-basis.spreadX * 0.5, basis.spreadX * 0.5);
+    line.v = randomRange(-basis.spreadY * 0.5, basis.spreadY * 0.5);
+    line.len = randomRange(basis.lineLength * 0.65, basis.lineLength * 1.35);
+    line.width = randomRange(basis.lineWidth * 0.65, basis.lineWidth * 1.35);
+    line.speed = Math.max(0, params.suctionSpeed * Math.max(0.01, params.scale)) * randomRange(0.78, 1.25);
+    line.alphaMul = randomRange(0.65, 1);
+    line.brightness = randomRange(0.82, 1);
+    return line;
+  }
+  function resetParticle(particle, initial) {
+    const basis = createSuctionBasis(params);
+    particle.d = initial ? randomRange(basis.mouthPadding + 0.05, basis.length) : basis.length + randomRange(0, basis.spawnFade);
+    particle.u = randomRange(-basis.spreadX * 0.55, basis.spreadX * 0.55);
+    particle.v = randomRange(-basis.spreadY * 0.55, basis.spreadY * 0.55);
+    particle.size = randomRange(basis.particleSize * 0.45, basis.particleSize * 1.15);
+    particle.speed = Math.max(0, params.particleSpeed * Math.max(0.01, params.scale)) * randomRange(0.75, 1.35);
+    particle.alphaMul = randomRange(0.35, 0.9);
+    particle.brightness = randomRange(0.75, 1);
+    return particle;
+  }
+  function randomRange(min, max) {
+    const id2 = resetIndex;
+    resetIndex += 1;
+    return lerp(min, max, sequence01(id2, resetIndex % 8));
+  }
 }
 function createSuctionBasis(params) {
   const scale = Math.max(0.01, params.scale);
@@ -348,7 +365,7 @@ function createSuctionMaterial(scene) {
   });
   material.backFaceCulling = false;
   material.transparencyMode = Material.MATERIAL_ALPHABLEND;
-  material.alphaMode = Constants.ALPHA_ADD;
+  material.alphaMode = Constants.ALPHA_COMBINE;
   material.disableDepthWrite = true;
   return material;
 }
@@ -377,6 +394,12 @@ function registerSuctionShaders() {
     `;
   }
 }
+function lineFade(distance, basis) {
+  const mouthFade = smoothstep(basis.mouthPadding, basis.mouthPadding + basis.fadeDistance, distance);
+  const clampedDistance = Math.min(distance, basis.length);
+  const outerFade = smoothstep(0, basis.spawnFade, basis.length - clampedDistance);
+  return mouthFade * outerFade;
+}
 function toColor3(color) {
   return new Color3(clamp01(color.r), clamp01(color.g), clamp01(color.b));
 }

package/dist/effects/pulse-laser-volley-sequence/index.d.ts

@@ -0,0 +1,14 @@
+import { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
+interface PulseLaserParams extends VfxParamValues {
+    lifetimeMode: string;
+    lifetime: number;
+    targetDistance: number;
+    boltSpeed: number;
+    boltLen: number;
+    boltColor: VfxColorValue;
+    boltCore: number;
+    boltCorePow: number;
+    boltBright: number;
+}
+export declare const pulseLaserVolleySequenceEffectPackage: VfxEffectPackage<PulseLaserParams>;
+export {};

package/dist/effects/pulse-laser-volley-sequence/index.js

@@ -0,0 +1,142 @@
+import { CreatePlane } from "@babylonjs/core/Meshes/Builders/planeBuilder";
+import { ShaderMaterial } from "@babylonjs/core/Materials/shaderMaterial";
+import { Effect } from "@babylonjs/core/Materials/effect";
+import { Texture } from "@babylonjs/core/Materials/Textures/texture";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+import { Space } from "@babylonjs/core/Maths/math.axis";
+import { Constants } from "@babylonjs/core/Engines/constants";
+import { L as LIFETIME_DEBUG_PARAMS, a as LIFETIME_DEFAULTS, s as scheduleLifetime } from "../../chunks/space-shared-xh5IOcLH.js";
+const boltTextureUrl = "data:image/webp;base64,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";
+const DEFAULT_PARAMS = {
+  ...LIFETIME_DEFAULTS,
+  targetDistance: 12,
+  boltSpeed: 26,
+  boltLen: 1,
+  boltColor: { r: 0.071, g: 0.408, b: 1 },
+  // #1268ff
+  boltCore: 0.3,
+  boltCorePow: 3,
+  boltBright: 1.3
+};
+const BOLT_LEN = 2, BOLT_W = 0.34;
+const BOLT_VERTEX = `precision highp float;
+attribute vec3 position; attribute vec2 uv;
+uniform mat4 worldViewProjection;
+varying vec2 vUV;
+void main() { vUV = uv; gl_Position = worldViewProjection * vec4(position, 1.0); }`;
+const BOLT_FRAGMENT = `precision highp float;
+varying vec2 vUV;
+uniform sampler2D tex;
+uniform vec3 tint;
+uniform float coreStr; uniform float corePow; uniform float bright;
+void main() {
+  vec4 t = texture2D(tex, vUV);
+  float core = pow(t.a, corePow) * coreStr;
+  vec3 col = mix(tint, vec3(1.0), core) * bright;
+  gl_FragColor = vec4(col, t.a);
+}`;
+let shadersRegistered = false;
+function registerShaders() {
+  if (shadersRegistered) return;
+  Effect.ShadersStore["vfxPulseBoltVertexShader"] = BOLT_VERTEX;
+  Effect.ShadersStore["vfxPulseBoltFragmentShader"] = BOLT_FRAGMENT;
+  shadersRegistered = true;
+}
+function colorVec(c) {
+  return new Color3(c.r, c.g, c.b);
+}
+function excludeFromGlow(scene, mesh) {
+  for (const layer of scene.effectLayers ?? []) {
+    const add = layer.addExcludedMesh;
+    if (typeof add === "function") add.call(layer, mesh);
+  }
+}
+const pulseLaserVolleySequenceEffectPackage = {
+  id: "pulse-laser-volley-sequence",
+  nameZh: "脉冲激光(单发)",
+  placement: "socket",
+  optionalInputs: ["aim"],
+  defaultParams: DEFAULT_PARAMS,
+  debugAnchor: "playerRight",
+  debugParams: [
+    ...LIFETIME_DEBUG_PARAMS,
+    { key: "targetDistance", label: "目标距离", kind: "number", min: 2, max: 40, step: 0.5 },
+    { key: "boltSpeed", label: "光弹速度", kind: "number", min: 5, max: 60, step: 1 },
+    { key: "boltLen", label: "光弹长度", kind: "number", min: 0.3, max: 4, step: 0.05 },
+    { key: "boltColor", label: "光弹颜色", kind: "color" },
+    { key: "boltCore", label: "白芯强度", kind: "number", min: 0, max: 1, step: 0.01 },
+    { key: "boltCorePow", label: "白芯收窄", kind: "number", min: 0.5, max: 8, step: 0.1 },
+    { key: "boltBright", label: "光弹亮度", kind: "number", min: 0.2, max: 3, step: 0.05 }
+  ],
+  create({ scene, root, position, rotationY, params, inputs }) {
+    root.position.copyFrom(position);
+    root.rotation.y = rotationY;
+    registerShaders();
+    const effectiveDist = () => {
+      if (!inputs?.aim) return params.targetDistance;
+      const tgt = inputs.aim();
+      root.lookAt(tgt, 0, 0, 0, Space.WORLD);
+      return Vector3.Distance(root.getAbsolutePosition(), tgt);
+    };
+    const boltTex = new Texture(boltTextureUrl, scene);
+    boltTex.hasAlpha = true;
+    const boltMat = new ShaderMaterial("vfx_pulse_boltMat", scene, { vertex: "vfxPulseBolt", fragment: "vfxPulseBolt" }, {
+      attributes: ["position", "uv"],
+      uniforms: ["worldViewProjection", "tint", "coreStr", "corePow", "bright"],
+      samplers: ["tex"],
+      needAlphaBlending: true
+    });
+    boltMat.setTexture("tex", boltTex);
+    boltMat.backFaceCulling = false;
+    boltMat.disableDepthWrite = true;
+    boltMat.alphaMode = Constants.ALPHA_ADD;
+    boltMat.setColor3("tint", colorVec(params.boltColor));
+    boltMat.setFloat("coreStr", params.boltCore);
+    boltMat.setFloat("corePow", params.boltCorePow);
+    boltMat.setFloat("bright", params.boltBright);
+    const mesh = CreatePlane("vfx_pulse_single_bolt", { width: BOLT_W, height: BOLT_LEN }, scene);
+    mesh.rotation.x = Math.PI / 2;
+    mesh.material = boltMat;
+    mesh.isPickable = false;
+    mesh.parent = root;
+    mesh.setEnabled(false);
+    excludeFromGlow(scene, mesh);
+    const bolt = { mesh, left: 0 };
+    let fired = false;
+    const observer = scene.onBeforeRenderObservable.add(() => {
+      const dt = Math.min(scene.getEngine().getDeltaTime() / 1e3, 0.05);
+      const dist = effectiveDist();
+      if (!fired) {
+        bolt.mesh.position.set(0, 0, 0);
+        bolt.mesh.scaling.z = params.boltLen / BOLT_LEN;
+        bolt.left = dist / params.boltSpeed;
+        bolt.mesh.setEnabled(true);
+        fired = true;
+      }
+      const step = params.boltSpeed * dt;
+      if (bolt.left > 0) {
+        bolt.left -= dt;
+        bolt.mesh.position.z += step;
+        if (bolt.left <= 0) bolt.mesh.setEnabled(false);
+      }
+    });
+    let disposed = false;
+    let ltTimer = 0;
+    const dispose = () => {
+      if (disposed) return;
+      disposed = true;
+      if (ltTimer) window.clearTimeout(ltTimer);
+      scene.onBeforeRenderObservable.remove(observer);
+      bolt.mesh.dispose();
+      boltMat.dispose();
+      boltTex.dispose();
+      root.dispose();
+    };
+    ltTimer = scheduleLifetime(params, dispose);
+    return { root, dispose };
+  }
+};
+export {
+  pulseLaserVolleySequenceEffectPackage
+};

package/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "vfx-index/1.0",
-  "count": 40,
+  "count": 41,
   "effects": [
     {
       "id": "build.particle.lumber_debris_scatter",
@@ -277,6 +277,16 @@
       "media": {},
       "path": "packages/effects/pulse-laser-volley"
     },
+    {
+      "id": "pulse-laser-volley-sequence",
+      "dir": "pulse-laser-volley-sequence",
+      "nameZh": "pulse-laser-volley-sequence",
+      "kind": "code",
+      "category": null,
+      "tags": [],
+      "media": {},
+      "path": "packages/effects/pulse-laser-volley-sequence"
+    },
     {
       "id": "resource-collect-sparkles",
       "dir": "resource-collect-sparkles",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/vfx",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "type": "module",
   "description": "Shared VFX library for Playable projects: engine-injected effect packages + runtime. Project-pure (no imports of host project code).",
   "publishConfig": {

package/packages/effects/pulse-laser-volley-sequence/vfx-params.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "vfx-params/1.0",
+  "effectId": "pulse-laser-volley-sequence",
+  "params": {}
+}