@fps-games/vfx 0.1.1

package/packages/effects/door_open_gold_flakes/door_open_gold_flakes.json

@@ -0,0 +1,498 @@
+{
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "build.particle.door_open_gold_flakes",
+  "name": {
+    "zh": "开门光效",
+    "en": "Door Open Light FX"
+  },
+  "source": {
+    "engine": "babylon",
+    "engineVersion": "8.56.2",
+    "projectPath": "D:/project/lumber_order",
+    "rootAsset": "src/assets/vfx/effects/door_open_gold_flakes",
+    "sourceId": "lumber_order/door_open_gold_flakes",
+    "extractedAt": "2026-06-02T00:00:00.000Z",
+    "extractorVersion": "manual-lumber-order-vfx/0.1.0",
+    "canonicalSource": "local",
+    "legacyId": null,
+    "previousIds": []
+  },
+  "assets": {
+    "textures": [],
+    "materials": [],
+    "meshes": [],
+    "shaders": [],
+    "sounds": [],
+    "scripts": [
+      {
+        "kind": "script",
+        "id": "gold_flakes_v1",
+        "packagePath": "assets/runtime/goldFlakes.v1.js",
+        "runtimeId": "goldFlakes/v1",
+        "engine": "babylon",
+        "moduleFormat": "esm",
+        "exports": [
+          "createGoldFlakesRuntime",
+          "runtimeContract"
+        ],
+        "mimeType": "text/javascript"
+      }
+    ],
+    "raw": []
+  },
+  "emitters": [
+    {
+      "name": "door_open_gold_flakes_main",
+      "sourceNodeName": "door_open_gold_flakes_main",
+      "enabled": true,
+      "type": "GoldFlakes",
+      "duration": 1.25,
+      "effectScale": 1,
+      "flakeCount": 30,
+      "areaRadius": 0.72,
+      "riseHeight": 1.35,
+      "staggerTime": 0.34,
+      "scaleX": 1,
+      "scaleY": 1,
+      "scaleZ": 1,
+      "flakeWidth": 0.055,
+      "flakeHeight": 0.18,
+      "flakeAlpha": 0.9,
+      "groundOffsetY": 0.06,
+      "hdrIntensity": 1.8,
+      "lightRayCount": 7,
+      "lightRaySpread": 0.82,
+      "lightRayWidth": 0.3,
+      "lightRayHeight": 1.75,
+      "lightRayOffsetY": 0.62,
+      "lightRayAlpha": 0.92,
+      "lightRayScaleX": 1,
+      "lightRayScaleY": 1,
+      "lightRayScaleZ": 1,
+      "lightRayStaggerTime": 0.16,
+      "glowWidth": 1.55,
+      "glowHeight": 1.08,
+      "glowOffsetY": 0.42,
+      "glowAlpha": 0.72,
+      "glowIntensity": 4.2,
+      "glowColor": {
+        "r": 1,
+        "g": 0.9,
+        "b": 0.42,
+        "a": 1
+      },
+      "flakeColor": {
+        "r": 1,
+        "g": 0.78,
+        "b": 0.18,
+        "a": 1
+      },
+      "runtime": {
+        "adapter": "goldFlakes/v1",
+        "stopAfterSeconds": 1.25,
+        "disposeOnComplete": true
+      }
+    }
+  ],
+  "runtime": {
+    "driver": "goldFlakes",
+    "defaultMesh": null,
+    "defaultOffset": {
+      "x": 0,
+      "y": 0,
+      "z": 0
+    },
+    "start": [
+      "Instantiate Babylon runtime for door_open_gold_flakes"
+    ],
+    "update": [
+      "Apply Babylon tunable parameter overrides"
+    ],
+    "stop": [
+      "Stop and dispose runtime resources"
+    ],
+    "adapters": [
+      {
+        "id": "goldFlakes/v1",
+        "engine": "babylon",
+        "entry": "assets/runtime/goldFlakes.v1.js",
+        "moduleFormat": "esm",
+        "exports": [
+          "createGoldFlakesRuntime",
+          "runtimeContract"
+        ]
+      }
+    ]
+  },
+  "tunableParams": [
+    {
+      "key": "door_open_gold_flakes.flakeCount",
+      "labelZh": "金片数量",
+      "type": "number",
+      "default": 30,
+      "min": 1,
+      "max": 120,
+      "step": 1,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "flakeCount",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.areaRadius",
+      "labelZh": "生成范围",
+      "type": "number",
+      "default": 0.72,
+      "min": 0.05,
+      "max": 3,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "areaRadius",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.riseHeight",
+      "labelZh": "上升高度",
+      "type": "number",
+      "default": 1.35,
+      "min": 0.1,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "riseHeight",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.staggerTime",
+      "labelZh": "错开时间",
+      "type": "number",
+      "default": 0.34,
+      "min": 0,
+      "max": 2,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "staggerTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.flakeSize",
+      "labelZh": "金片大小",
+      "type": "number",
+      "default": 1,
+      "min": 0.2,
+      "max": 4,
+      "step": 0.01,
+      "targets": [
+        {
+          "emitter": "door_open_gold_flakes_main",
+          "property": "flakeWidth",
+          "operator": "scaleDefault",
+          "defaultValue": 0.055
+        },
+        {
+          "emitter": "door_open_gold_flakes_main",
+          "property": "flakeHeight",
+          "operator": "scaleDefault",
+          "defaultValue": 0.18
+        }
+      ]
+    },
+    {
+      "key": "door_open_gold_flakes.flakeColor",
+      "labelZh": "金片颜色",
+      "type": "color",
+      "default": "#ffc72e",
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "flakeColor",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.scaleX",
+      "labelZh": "X缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "scaleX",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.scaleY",
+      "labelZh": "Y缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "scaleY",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.scaleZ",
+      "labelZh": "Z缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "scaleZ",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.hdrIntensity",
+      "labelZh": "HDR强度",
+      "type": "number",
+      "default": 1.8,
+      "min": 0,
+      "max": 6,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "hdrIntensity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.flakeAlpha",
+      "labelZh": "金片透明度",
+      "type": "number",
+      "default": 0.9,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "flakeAlpha",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.effectScale",
+      "labelZh": "整体缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.1,
+      "max": 4,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "effectScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.lightRayCount",
+      "labelZh": "光片数量",
+      "type": "number",
+      "default": 7,
+      "min": 0,
+      "max": 12,
+      "step": 1,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "lightRayCount",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.lightRaySize",
+      "labelZh": "光片大小",
+      "type": "number",
+      "default": 1,
+      "min": 0.2,
+      "max": 3,
+      "step": 0.01,
+      "targets": [
+        {
+          "emitter": "door_open_gold_flakes_main",
+          "property": "lightRayWidth",
+          "operator": "scaleDefault",
+          "defaultValue": 0.22
+        },
+        {
+          "emitter": "door_open_gold_flakes_main",
+          "property": "lightRayHeight",
+          "operator": "scaleDefault",
+          "defaultValue": 1.45
+        }
+      ]
+    },
+    {
+      "key": "door_open_gold_flakes.lightRayAlpha",
+      "labelZh": "光片透明度",
+      "type": "number",
+      "default": 0.92,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "lightRayAlpha",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.lightRayScaleX",
+      "labelZh": "光片X缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "lightRayScaleX",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.lightRayScaleY",
+      "labelZh": "光片Y缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "lightRayScaleY",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.lightRayScaleZ",
+      "labelZh": "光片Z缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.05,
+      "max": 5,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "lightRayScaleZ",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.glowIntensity",
+      "labelZh": "光芒强度",
+      "type": "number",
+      "default": 4.2,
+      "min": 0,
+      "max": 8,
+      "step": 0.01,
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "glowIntensity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.glowColor",
+      "labelZh": "光片颜色",
+      "type": "color",
+      "default": "#ffe66b",
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "glowColor",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "door_open_gold_flakes.duration",
+      "labelZh": "生命周期",
+      "type": "number",
+      "default": 1.25,
+      "min": 0.1,
+      "max": 5,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "door_open_gold_flakes_main",
+        "property": "duration",
+        "operator": "set"
+      }
+    }
+  ],
+  "babylon": {
+    "driver": "goldFlakes",
+    "previewConfig": {
+      "textureUrl": null,
+      "emitterCount": 1,
+      "effectFile": "door_open_gold_flakes.json",
+      "normalizedVfx": null
+    }
+  },
+  "debug": {
+    "playAnchor": "player",
+    "livePreview": true
+  },
+  "review": {
+    "status": "draft",
+    "artistNotes": [
+      "Gold flakes rise straight upward in a staggered area for a door opening effect.",
+      "Flakes keep a fixed upright orientation and do not use random rotation.",
+      "Distribution is deterministic but offset so the field does not look grid-like."
+    ],
+    "approvedBy": null,
+    "approvedAt": null
+  },
+  "recording": {
+    "provider": "local-placeholder",
+    "recordedAt": "2026-06-02T00:00:00.000Z",
+    "mimeType": "image/png",
+    "durationSec": 1.25,
+    "fps": 0,
+    "media": {
+      "previewVideo": null,
+      "previewWebm": null,
+      "previewMp4": null,
+      "previewGif": null,
+      "thumbnail": "media/thumbnail.png",
+      "contactSheet": "media/contact-sheet.png",
+      "gcsUri": null
+    }
+  },
+  "search": {
+    "tags": [
+      "babylon",
+      "door open",
+      "gold flakes",
+      "rising particles",
+      "reward feedback",
+      "casual game"
+    ],
+    "descriptionEn": "A field of upright gold flakes that rise straight upward with staggered timing for door opening feedback.",
+    "useCases": [
+      "door opening",
+      "gate unlock",
+      "reward reveal"
+    ],
+    "negativeUseCases": [
+      "upgrade spiral",
+      "gear spin",
+      "dust burst",
+      "wood chips"
+    ]
+  },
+  "legacyIds": []
+}

package/packages/effects/door_open_gold_flakes/index.ts

@@ -0,0 +1,11 @@
+import manifest from './door_open_gold_flakes.json';
+import runtimeUrl from './assets/runtime/goldFlakes.v1.js?url';
+import { createManifestRuntimeEffectPackage } from '../../manifestRuntimePackage';
+
+export const doorOpenGoldFlakesEffectPackage = createManifestRuntimeEffectPackage({
+  id: 'door_open_gold_flakes',
+  manifest,
+  assetUrls: {
+    'assets/runtime/goldFlakes.v1.js': runtimeUrl,
+  },
+});

package/packages/effects/door_open_gold_flakes/vfx-params.json

@@ -0,0 +1,23 @@
+{
+  "door_open_gold_flakes.flakeCount": 30,
+  "door_open_gold_flakes.areaRadius": 0.72,
+  "door_open_gold_flakes.riseHeight": 1.35,
+  "door_open_gold_flakes.staggerTime": 0.34,
+  "door_open_gold_flakes.flakeSize": 1,
+  "door_open_gold_flakes.flakeColor": "#ffc72e",
+  "door_open_gold_flakes.scaleX": 1,
+  "door_open_gold_flakes.scaleY": 1,
+  "door_open_gold_flakes.scaleZ": 0.5,
+  "door_open_gold_flakes.hdrIntensity": 1.8,
+  "door_open_gold_flakes.flakeAlpha": 1,
+  "door_open_gold_flakes.effectScale": 1,
+  "door_open_gold_flakes.lightRayCount": 7,
+  "door_open_gold_flakes.lightRaySize": 1.25,
+  "door_open_gold_flakes.lightRayAlpha": 0.92,
+  "door_open_gold_flakes.lightRayScaleX": 3,
+  "door_open_gold_flakes.lightRayScaleY": 0.91,
+  "door_open_gold_flakes.lightRayScaleZ": 3,
+  "door_open_gold_flakes.glowIntensity": 4.2,
+  "door_open_gold_flakes.glowColor": "#ffe66b",
+  "door_open_gold_flakes.duration": 1.25
+}

package/packages/effects/electric-arc/index.ts

@@ -0,0 +1,62 @@
+// 受击电弧(移植自 babylon-laser createElectricPS, 特效#4)。
+// 序列帧粒子(spark_4x4 16帧4x4)绕宿主的立方壳层抖动,受击窗口内持续吐火花。BLENDMODE_ADD。
+import { ParticleSystem } from '@babylonjs/core/Particles/particleSystem';
+import { Texture } from '@babylonjs/core/Materials/Textures/texture';
+import { Color4 } from '@babylonjs/core/Maths/math.color';
+import { Vector3 } from '@babylonjs/core/Maths/math.vector';
+import type { VfxEffectPackage, VfxParamValues } from '../../types';
+import sparkTextureUrl from './assets/textures/spark_4x4.webp?url';
+
+interface ElectricArcParams extends VfxParamValues {
+  radius: number;
+  rate: number;
+  duration: number;
+}
+
+const DEFAULT_PARAMS: ElectricArcParams = { radius: 1.2, rate: 48, duration: 0.55 };
+
+export const electricArcEffectPackage: VfxEffectPackage<ElectricArcParams> = {
+  id: 'electric-arc',
+  nameZh: '受击电弧',
+  debugAnchor: 'playerRight',
+  defaultParams: DEFAULT_PARAMS,
+  debugParams: [
+    { key: 'radius', label: '环绕半径', kind: 'scale', min: 0.3, max: 4, step: 0.05 },
+    { key: 'rate', label: '电弧密度', kind: 'number', min: 0, max: 150, step: 1 },
+    { key: 'duration', label: '持续(s)', kind: 'lifetime', min: 0.1, max: 3, step: 0.05 },
+  ],
+
+  create({ scene, root, position, params }) {
+    root.position.copyFrom(position);
+    const radius = params.radius;
+    const e = radius * 0.9;
+    const ps = new ParticleSystem('vfx_elec_ps', 80, scene, null, true); // 序列帧
+    const tex = new Texture(sparkTextureUrl, scene); tex.hasAlpha = true;
+    ps.particleTexture = tex;
+    ps.spriteCellWidth = 128; ps.spriteCellHeight = 128;
+    ps.startSpriteCellID = 0; ps.endSpriteCellID = 15; ps.spriteCellChangeSpeed = 3;
+    ps.spriteRandomStartCell = true;
+    ps.emitter = position.clone();
+    ps.minEmitBox = new Vector3(-e, -e, -e); ps.maxEmitBox = new Vector3(e, e, e);
+    ps.direction1 = new Vector3(-0.3, -0.3, -0.3); ps.direction2 = new Vector3(0.3, 0.3, 0.3);
+    ps.minSize = radius * 2.2; ps.maxSize = radius * 3.6;
+    ps.minLifeTime = 0.16; ps.maxLifeTime = 0.38;
+    ps.minInitialRotation = -Math.PI; ps.maxInitialRotation = Math.PI;
+    ps.color1 = new Color4(0.85, 0.95, 1, 1); ps.color2 = new Color4(0.5, 0.75, 1, 1); ps.colorDead = new Color4(0.2, 0.4, 1, 0);
+    ps.blendMode = ParticleSystem.BLENDMODE_ADD;
+    ps.minEmitPower = 0; ps.maxEmitPower = 0.5;
+    ps.emitRate = params.rate;
+    ps.start();
+
+    // 受击窗口:duration 后关 emitRate,再等粒子消亡后销毁
+    let disposed = false;
+    const stopTimer = window.setTimeout(() => { ps.emitRate = 0; }, params.duration * 1000);
+    const disposeTimer = window.setTimeout(() => disposeAll(), (params.duration + 0.5) * 1000);
+    function disposeAll(): void {
+      if (disposed) return; disposed = true;
+      window.clearTimeout(stopTimer); window.clearTimeout(disposeTimer);
+      ps.dispose(); tex.dispose(); root.dispose();
+    }
+    return { root, dispose() { disposeAll(); } };
+  },
+};

package/packages/effects/electric-arc/vfx-params.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "vfx-params/1.0",
+  "effectId": "electric-arc",
+  "params": {}
+}

package/packages/effects/energy-shield/effect.json

@@ -0,0 +1,7 @@
+{
+  "id": "energy-shield",
+  "nameZh": "半球玻璃罩",
+  "search": {
+    "tags": ["hemisphere", "glass", "dome", "bloom", "shader", "marble", "flow"]
+  }
+}