@fps-games/vfx 0.3.16 → 0.3.17

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/vfx",
-  "version": "0.3.16",
+  "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