@fps-games/vfx 0.3.15 → 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/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.15",
+  "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": {}
+}