@fps-games/vfx 0.3.15 → 0.3.17

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/EffectPackageService.d.ts

@@ -1,16 +1,18 @@
 import { Vector3 } from '@babylonjs/core/Maths/math.vector';
 import { Scene } from '@babylonjs/core/scene';
 import { VfxRegistry } from './registry';
-import { VfxDebugAnchor, VfxEffectHandle, VfxEffectPackage, VfxParamValues, VfxSpawnTransform } from './types';
+import { VfxDebugAnchor, VfxEffectHandle, VfxEffectPackage, VfxParamValues, VfxRuntimeResources, VfxSpawnTransform } from './types';
 export interface EffectPackageServiceOptions {
     /** 注入的注册表(由项目侧 glob + buildRegistry 构建);库不直接引用项目注册表 */
     registry: VfxRegistry;
     getDebugAnchorPosition?: (anchor: VfxDebugAnchor) => Vector3 | null;
+    runtime?: VfxRuntimeResources;
 }
 export declare class EffectPackageService {
     private readonly scene;
     private readonly registry;
     private readonly getDebugAnchorPosition?;
+    private readonly runtime?;
     private readonly activeHandles;
     private readonly savedParams;
     constructor(scene: Scene, options: EffectPackageServiceOptions);

package/dist/SceneVfxService.d.ts

@@ -1,7 +1,7 @@
 import { Scene } from '@babylonjs/core/scene';
 import { Vector3 } from '@babylonjs/core/Maths/math.vector';
 import { VfxRegistry } from './registry';
-import { VfxDebugAnchor, VfxEffectHandle, VfxEffectPackage, VfxParamValues, VfxSpawnTransform } from './types';
+import { VfxDebugAnchor, VfxEffectHandle, VfxEffectPackage, VfxParamValues, VfxRuntimeResources, VfxSpawnTransform } from './types';
 import { EffectPackageService } from './EffectPackageService';
 export interface SceneVfxWarmupEntry {
     effectId: string;
@@ -12,6 +12,7 @@ export interface SceneVfxServiceOptions {
     /** 注入的注册表(项目侧 glob + buildRegistry 构建) */
     registry: VfxRegistry;
     getDebugAnchorPosition?: (anchor: VfxDebugAnchor) => Vector3 | null;
+    runtime?: VfxRuntimeResources;
 }
 export declare class SceneVfxService {
     private effectPackageService;

package/dist/effects/energy-shield/index.d.ts

@@ -1,3 +1,4 @@
+import { GlowLayer } from '@babylonjs/core/Layers/glowLayer';
 import { ShaderMaterial } from '@babylonjs/core/Materials/shaderMaterial';
 import { Vector3 } from '@babylonjs/core/Maths/math.vector';
 import { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
@@ -23,6 +24,8 @@ export interface EnergyShieldParams extends VfxParamValues {
     flowIntensity: number;
     marbleContrast: number;
     bloomIntensity: number;
+    bloomKernelSize: number;
+    showGlowLayer: boolean;
     haloScale: number;
     showHalo: boolean;
     segments: number;
@@ -33,11 +36,13 @@ export interface CreateEnergyShieldOptions {
     position?: Vector3;
     params?: Partial<EnergyShieldParams>;
     renderingGroupId?: number;
+    glowLayer?: GlowLayer | null;
     disposeRoot?: boolean;
 }
 export interface EnergyShieldHandle extends VfxEffectHandle {
     shield: Mesh;
     material: ShaderMaterial;
+    glowLayer: GlowLayer | null;
     update(params: Partial<EnergyShieldParams>): void;
 }
 export declare const energyShieldEffectPackage: VfxEffectPackage<EnergyShieldParams>;

package/dist/effects/energy-shield/index.js

@@ -1,4 +1,5 @@
 import { Constants } from "@babylonjs/core/Engines/constants";
+import { GlowLayer } from "@babylonjs/core/Layers/glowLayer";
 import { Effect } from "@babylonjs/core/Materials/effect";
 import { ShaderMaterial } from "@babylonjs/core/Materials/shaderMaterial";
 import { Color3 } from "@babylonjs/core/Maths/math.color";
@@ -28,6 +29,8 @@ const DEFAULT_PARAMS = {
   flowIntensity: 1.15,
   marbleContrast: 0.67,
   bloomIntensity: 0.45,
+  bloomKernelSize: 36,
+  showGlowLayer: true,
   haloScale: 1.018,
   showHalo: false,
   segments: 64
@@ -234,11 +237,19 @@ const energyShieldEffectPackage = {
     { key: "flowIntensity", label: "流动强度", kind: "number", min: 0, max: 8, step: 0.01 },
     { key: "marbleContrast", label: "纹路锐度", kind: "number", min: 0.25, max: 4, step: 0.01 },
     { key: "bloomIntensity", label: "Bloom 强度", kind: "number", min: 0, max: 4, step: 0.01 },
+    { key: "bloomKernelSize", label: "GlowLayer 半径", kind: "number", min: 8, max: 128, step: 1 },
+    { key: "showGlowLayer", label: "显示 GlowLayer", kind: "boolean" },
     { key: "haloScale", label: "外层光晕缩放", kind: "scale", min: 1, max: 1.08, step: 1e-3 },
     { key: "showHalo", label: "显示外层光晕", kind: "boolean" }
   ],
-  create({ scene, root, position, renderingGroupId, params }) {
-    return createEnergyShield(scene, { root, position, renderingGroupId, params });
+  create({ scene, root, position, renderingGroupId, params, runtime }) {
+    return createEnergyShield(scene, {
+      root,
+      position,
+      renderingGroupId,
+      params,
+      glowLayer: runtime?.glowLayer ?? runtime?.getGlowLayer?.() ?? null
+    });
   }
 };
 function createEnergyShield(scene, options = {}) {
@@ -269,6 +280,10 @@ function createEnergyShield(scene, options = {}) {
   shield.alphaIndex = 20;
   const material = createShieldMaterial(scene);
   shield.material = material;
+  const sharedGlowLayer = options.glowLayer ?? null;
+  let glowLayer = null;
+  let ownsGlowLayer = false;
+  let glowMeshIncluded = false;
   let halo = null;
   let haloMaterial = null;
   let haloFeather = null;
@@ -283,6 +298,45 @@ function createEnergyShield(scene, options = {}) {
     haloFeather = null;
     haloFeatherMaterial = null;
   };
+  const addGlowMesh = () => {
+    if (!glowLayer || glowMeshIncluded) return;
+    glowLayer.addIncludedOnlyMesh(shield);
+    glowLayer.referenceMeshToUseItsOwnMaterial(shield);
+    glowMeshIncluded = true;
+  };
+  const removeGlowMesh = () => {
+    if (!glowLayer || !glowMeshIncluded) return;
+    glowLayer.removeIncludedOnlyMesh(shield);
+    glowMeshIncluded = false;
+  };
+  const disposeGlowLayer = () => {
+    removeGlowMesh();
+    if (ownsGlowLayer) glowLayer?.dispose();
+    glowLayer = null;
+    ownsGlowLayer = false;
+  };
+  const ensureGlowLayer = () => {
+    if (!params.showGlowLayer || params.bloomIntensity <= 1e-3) {
+      disposeGlowLayer();
+      return;
+    }
+    if (!glowLayer) {
+      if (sharedGlowLayer) {
+        glowLayer = sharedGlowLayer;
+      } else {
+        glowLayer = new GlowLayer(`vfx_energyShield_glow_${shield.uniqueId}`, scene, {
+          blurKernelSize: params.bloomKernelSize,
+          mainTextureRatio: 0.35
+        });
+        ownsGlowLayer = true;
+      }
+      addGlowMesh();
+    }
+    if (ownsGlowLayer) {
+      glowLayer.intensity = params.bloomIntensity;
+      glowLayer.blurKernelSize = params.bloomKernelSize;
+    }
+  };
   const ensureHalo = () => {
     if (!params.showHalo || params.bloomIntensity <= 1e-3) {
       disposeHalo();
@@ -335,6 +389,7 @@ function createEnergyShield(scene, options = {}) {
       haloFeather.material = haloFeatherMaterial;
     }
   };
+  ensureGlowLayer();
   ensureHalo();
   applyParams(material, shield, halo, haloMaterial, haloFeather, haloFeatherMaterial, params);
   let elapsed = 0;
@@ -349,6 +404,7 @@ function createEnergyShield(scene, options = {}) {
     if (disposed) return;
     disposed = true;
     scene.onBeforeRenderObservable.remove(observer);
+    disposeGlowLayer();
     disposeHalo();
     shield.dispose(false, false);
     material.dispose();
@@ -358,8 +414,12 @@ function createEnergyShield(scene, options = {}) {
     root,
     shield,
     material,
+    get glowLayer() {
+      return glowLayer;
+    },
     update(partial) {
       params = mergeParams(partial, params);
+      ensureGlowLayer();
       ensureHalo();
       applyParams(material, shield, halo, haloMaterial, haloFeather, haloFeatherMaterial, params);
     },

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/dist/effects/treasure-attention/index.js

@@ -76,8 +76,15 @@ const treasureAttentionEffectPackage = {
     { key: "bloomKernelSize", label: "Bloom 半径", kind: "number", min: 8, max: 96, step: 1 },
     { key: "showGlowLayer", label: "显示 GlowLayer", kind: "boolean" }
   ],
-  create({ scene, root, position, renderingGroupId, params }) {
-    return createTreasureAttentionFx(scene, { root, position, renderingGroupId, params, serviceOwnedRoot: true });
+  create({ scene, root, position, renderingGroupId, params, runtime }) {
+    return createTreasureAttentionFx(scene, {
+      root,
+      position,
+      renderingGroupId,
+      params,
+      glowLayer: runtime?.glowLayer ?? runtime?.getGlowLayer?.() ?? null,
+      serviceOwnedRoot: true
+    });
   }
 };
 function createTreasureAttentionFx(scene, options = {}) {

package/dist/index.js

@@ -75,6 +75,7 @@ class EffectPackageService {
     this.scene = scene;
     this.registry = options.registry;
     this.getDebugAnchorPosition = options.getDebugAnchorPosition;
+    this.runtime = options.runtime;
     this.savedParams = cloneOverrideMap(options.registry.savedParams);
   }
   getEffectPackages() {
@@ -127,7 +128,8 @@ class EffectPackageService {
         renderingGroupId: spawn.renderingGroupId,
         params: runtimeParams,
         scale: spawn.scale,
-        inputs: spawn.inputs
+        inputs: spawn.inputs,
+        runtime: this.runtime
       });
       applySpawnToRoot(root, spawn, applyRootScale);
     } catch (error) {
@@ -315,7 +317,8 @@ class SceneVfxService {
   constructor(scene, options) {
     this.effectPackageService = new EffectPackageService(scene, {
       registry: options.registry,
-      getDebugAnchorPosition: options.getDebugAnchorPosition
+      getDebugAnchorPosition: options.getDebugAnchorPosition,
+      runtime: options.runtime
     });
   }
   getEffectPackageService() {

package/dist/types.d.ts

@@ -2,6 +2,7 @@ import { Scene } from '@babylonjs/core/scene';
 import { Vector3 } from '@babylonjs/core/Maths/math.vector';
 import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
 import { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
+import { GlowLayer } from '@babylonjs/core/Layers/glowLayer';
 export type VfxDebugAnchor = 'playerRight' | 'player';
 export type VfxInput<T> = T | (() => T);
 export type VfxInputKey = 'aim' | 'normal' | 'endpoints' | 'target' | 'reference';
@@ -24,6 +25,11 @@ export interface VfxResolvedInputs {
     reference?: () => Vector3;
     scalars?: Record<string, () => number>;
 }
+/** 运行时共享资源:不可序列化,由项目/游戏层注入,与可保存 params 分开。 */
+export interface VfxRuntimeResources {
+    glowLayer?: GlowLayer | null;
+    getGlowLayer?: () => GlowLayer | null;
+}
 export type VfxParamValue = number | string | boolean | VfxColorValue;
 export type VfxParamValues = Record<string, VfxParamValue>;
 export interface VfxColorValue {
@@ -74,6 +80,8 @@ export interface VfxEffectPackageContext<PParams extends VfxParamValues = VfxPar
     scale: Vector3;
     /** 运行时外部信息(已归一化为访问器)。link/target/定向武器/活改标量等按 required/optionalInputs 读取。 */
     inputs?: VfxResolvedInputs;
+    /** 运行时共享资源(如 scene 级共享 GlowLayer)。 */
+    runtime?: VfxRuntimeResources;
 }
 export interface VfxEffectHandle {
     root: TransformNode;

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.15",
+  "version": "0.3.17",
   "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/energy-shield/vfx-params.json

@@ -23,6 +23,8 @@
     "flowIntensity": 1.15,
     "marbleContrast": 0.67,
     "bloomIntensity": 0.45,
+    "bloomKernelSize": 36,
+    "showGlowLayer": true,
     "haloScale": 1.018,
     "showHalo": false,
     "segments": 64

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": {}
+}