@fps-games/vfx 0.1.1 → 0.3.2

package/packages/effects/player-upgrade/index.ts

@@ -80,8 +80,11 @@ const DEFAULT_PARAMS: PlayerUpgradeParams = {
 export const playerUpgradeEffectPackage: VfxEffectPackage<PlayerUpgradeParams> = {
   id: 'player-upgrade',
   nameZh: '人物&NPC升级',
+  placement: 'socket',
   manifest,
   defaultParams: DEFAULT_PARAMS,
+  // initialHeight 走 service 存活的 Y 偏移通道(不写 root.position,避免被 applySpawnToRoot 覆盖)(G6/M13)。
+  spawnParams: { offsetY: 'initialHeight' },
   debugAnchor: 'player',
   debugParams: [
     { key: 'lifetime', label: '生命周期', kind: 'lifetime', min: 0.2, max: 6, step: 0.01 },
@@ -105,9 +108,8 @@ export const playerUpgradeEffectPackage: VfxEffectPackage<PlayerUpgradeParams> =
     { key: 'glowWidth', label: '光柱宽度', kind: 'number', min: 0.1, max: 4, step: 0.01 },
   ],
   create({ scene, root, position, params }) {
-    const effectScale = Math.max(0.05, params.scale);
     markVfxRoot(root);
-    root.position.copyFrom(position).addInPlace(new Vector3(0, params.initialHeight * effectScale, 0));
+    root.position.copyFrom(position);   // 高度偏移由 service 经 spawnParams.offsetY 施加(存活)
     const strands = createStrandSystem(scene, root, params);
     const strandMeshes = createStrandMeshes(scene, root, params);
     const rings = createExpandingRings(scene, root, params);
@@ -129,7 +131,10 @@ export const playerUpgradeEffectPackage: VfxEffectPackage<PlayerUpgradeParams> =
       disposed = true;
       window.clearTimeout(disposeTimer);
       strands.stop();
-      strands.dispose();
+      // dispose(false):金丝粒子贴图是按 scene 缓存的共享 DynamicTexture(strandTextureByScene),
+      // ParticleSystem.dispose() 默认 disposeTexture=true 会销毁它,WeakMap 却仍持失效引用 →
+      // 二次升级金丝空白。纹理生命周期绑 scene、跨播放复用,故不随实例销毁。
+      strands.dispose(false);
       strandMeshes.dispose();
       rings.dispose();
       glowAura.dispose();

package/packages/effects/pulse-laser-volley/index.ts

@@ -9,6 +9,8 @@ import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
 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 type { Mesh } from '@babylonjs/core/Meshes/mesh';
 import type { Scene } from '@babylonjs/core/scene';
@@ -88,6 +90,8 @@ interface Bolt { mesh: Mesh; left: number; }
 export const pulseLaserVolleyEffectPackage: VfxEffectPackage<PulseLaserParams> = {
   id: 'pulse-laser-volley',
   nameZh: '脉冲激光',
+  placement: 'socket',
+  optionalInputs: ['aim'],
   defaultParams: DEFAULT_PARAMS,
   debugAnchor: 'playerRight',
   debugParams: [
@@ -104,10 +108,17 @@ export const pulseLaserVolleyEffectPackage: VfxEffectPackage<PulseLaserParams> =
     { key: 'boltBright', label: '光弹亮度', kind: 'number', min: 0.2, max: 3, step: 0.05 },
   ],
 
-  create({ scene, root, position, rotationY, params }) {
+  create({ scene, root, position, rotationY, params, inputs }) {
     root.position.copyFrom(position);
     root.rotation.y = rotationY;
     registerShaders();
+    // 有 inputs.aim:每帧朝目标(Space.WORLD,root 挂在炮口)+ 齐射射程=到目标距离;无 aim 回退挂点朝向 + params.targetDistance。
+    const effectiveDist = (): number => {
+      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;
@@ -151,9 +162,8 @@ export const pulseLaserVolleyEffectPackage: VfxEffectPackage<PulseLaserParams> =
     muzzle.position.set(0, 0, 0);
     let muzzleFlash = 0;
 
-    function fireVolley(): void {
+    function fireVolley(dist: number): void {
       const n = Math.max(1, Math.round(params.boltsPerVolley));
-      const dist = params.targetDistance;
       let fired = 0;
       for (const b of pool) {
         if (fired >= n) break;
@@ -171,8 +181,9 @@ export const pulseLaserVolleyEffectPackage: VfxEffectPackage<PulseLaserParams> =
     let volleyTimer = 0;
     const observer = scene.onBeforeRenderObservable.add(() => {
       const dt = Math.min(scene.getEngine().getDeltaTime() / 1000, 0.05);
+      const dist = effectiveDist();   // 每帧:有 aim 则朝目标 + 取到目标距离
       volleyTimer += dt;
-      if (volleyTimer >= params.volleyInterval) { volleyTimer = 0; fireVolley(); }
+      if (volleyTimer >= params.volleyInterval) { volleyTimer = 0; fireVolley(dist); }
 
       muzzleFlash = Math.max(0, muzzleFlash - dt * 6);
       const s = 1 + muzzleFlash * 0.6;

package/packages/effects/thruster-flame/index.ts

@@ -221,6 +221,7 @@ function excludeFromGlow(scene: Scene, mesh: AbstractMesh): void {
 export const thrusterFlameEffectPackage: VfxEffectPackage<ThrusterFlameParams> = {
   id: 'thruster-flame',
   nameZh: '战机尾焰',
+  placement: 'socket',
   defaultParams: DEFAULT_PARAMS,
   debugAnchor: 'playerRight',
   debugParams: [
@@ -236,7 +237,7 @@ export const thrusterFlameEffectPackage: VfxEffectPackage<ThrusterFlameParams> =
     { key: 'coreColor', label: '内核色', kind: 'color' },
   ],
 
-  create({ scene, root, position, params }) {
+  create({ scene, root, position, params, renderingGroupId }) {
     root.position.copyFrom(position);
     registerShaders();
     const preset = PRESETS[(params.mode as EngineMode)] ?? PRESETS.ion;
@@ -245,7 +246,7 @@ export const thrusterFlameEffectPackage: VfxEffectPackage<ThrusterFlameParams> =
     const outer = buildFlameMesh('vfx_thruster_outer', scene, FLAME_LEN, FLAME_R, 30, 24);
     const core = buildFlameMesh('vfx_thruster_core', scene, FLAME_LEN * 0.68, FLAME_R * 0.5, 24, 18);
     const swirl = buildFlameMesh('vfx_thruster_swirl', scene, FLAME_LEN * 0.42, FLAME_R * 1.3, 14, 24);
-    for (const m of [outer, core, swirl]) { m.parent = root; excludeFromGlow(scene, m); }
+    for (const m of [outer, core, swirl]) { m.parent = root; m.renderingGroupId = renderingGroupId ?? 0; excludeFromGlow(scene, m); }
 
     const outerMat = makeFXMaterial('vfx_thruster_outerMat', scene, 'vfxThrusterFlame', noiseTex);
     const coreMat = makeFXMaterial('vfx_thruster_coreMat', scene, 'vfxThrusterFlame', noiseTex);

package/packages/effects/treasure-attention/effect.json

@@ -0,0 +1,7 @@
+{
+  "id": "treasure-attention",
+  "nameZh": "宝藏注意力光效",
+  "search": {
+    "tags": ["treasure", "attention", "pickup", "gold", "sparkle", "aura", "ring"]
+  }
+}