@fps-games/vfx 0.1.1

package/packages/effects/tree_chop_dust_burst/tree_chop_dust_burst.json

@@ -0,0 +1,412 @@
+{
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "build.particle.tree_chop_dust_burst",
+  "name": {
+    "zh": "树倒地的烟尘",
+    "en": "Tree Fall Dust Burst"
+  },
+  "source": {
+    "engine": "babylon",
+    "engineVersion": "8.56.2",
+    "projectPath": "D:/project/loy_babylon_particle_test",
+    "rootAsset": "src/effects/treeChopDustBurst.ts",
+    "sourceId": "loy-babylon-particle-test/treeChopDustBurst",
+    "extractedAt": "2026-06-01T00:00:00.000Z",
+    "extractorVersion": "manual-babylon-particle-package/0.1.0",
+    "canonicalSource": "local",
+    "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.tree_chop_dust_burst/source",
+    "legacyId": null,
+    "previousIds": []
+  },
+  "assets": {
+    "textures": [
+      {
+        "kind": "texture",
+        "id": "tree_chop_dust_burst_dust",
+        "packagePath": "assets/textures/tree_chop_dust_burst_dust.png",
+        "sourcePath": "D:/project/loy_babylon_particle_test/public/textures/particles/tree-chop-dust-burst-dust.png",
+        "sourceId": "generated-soft-dust-alpha",
+        "width": 128,
+        "height": 128
+      }
+    ],
+    "materials": [],
+    "meshes": [],
+    "shaders": [],
+    "sounds": [],
+    "scripts": [
+      {
+        "kind": "script",
+        "id": "particle_emitter_v1",
+        "packagePath": "assets/runtime/particleEmitter.v1.js",
+        "runtimeId": "particleEmitter/v1",
+        "engine": "babylon",
+        "moduleFormat": "esm",
+        "exports": [
+          "createParticleEmitterRuntime",
+          "runtimeContract"
+        ],
+        "mimeType": "text/javascript"
+      }
+    ],
+    "raw": [
+      {
+        "kind": "raw",
+        "id": "02-normalized-vfx",
+        "packagePath": "source/02-normalized-vfx.json",
+        "sourcePath": "D:/project/loy_babylon_particle_test/out_particle/build.particle.tree_chop_dust_burst/source/02-normalized-vfx.json"
+      },
+      {
+        "kind": "raw",
+        "id": "01-source-dump",
+        "packagePath": "source/01-source-dump.json",
+        "sourcePath": "D:/project/loy_babylon_particle_test/out_particle/build.particle.tree_chop_dust_burst/source/01-source-dump.json"
+      },
+      {
+        "kind": "raw",
+        "id": "tree_chop_dust_burst_source_ts",
+        "packagePath": "source/src/effects/treeChopDustBurst.ts",
+        "sourcePath": "D:/project/loy_babylon_particle_test/src/effects/treeChopDustBurst.ts"
+      },
+      {
+        "kind": "raw",
+        "id": "tree_chop_dust_burst_dust_texture_source",
+        "packagePath": "source/textures/tree-chop-dust-burst-dust.png",
+        "sourcePath": "D:/project/loy_babylon_particle_test/public/textures/particles/tree-chop-dust-burst-dust.png"
+      }
+    ]
+  },
+  "emitters": [
+    {
+      "name": "tree_chop_dust_burst_dust",
+      "sourceNodeName": "tree_chop_dust_burst_dust",
+      "enabled": true,
+      "deterministic": true,
+      "blendMode": "STANDARD",
+      "particleTexturePath": "assets/textures/tree_chop_dust_burst_dust.png",
+      "capacity": 108,
+      "manualEmitCount": 36,
+      "emitRate": 0,
+      "effectScale": 1,
+      "minSize": 0.24,
+      "maxSize": 0.24,
+      "minLifeTime": 0.58,
+      "maxLifeTime": 0.58,
+      "minEmitPower": 1.225,
+      "maxEmitPower": 1.225,
+      "updateSpeed": 0.016666666666666666,
+      "gravity": {
+        "x": 0,
+        "y": -0.85,
+        "z": 0
+      },
+      "shape": {
+        "sourceType": "Box",
+        "sourceEnum": 0,
+        "radius": 1,
+        "angle": 0,
+        "type": "Box",
+        "direction1": {
+          "x": -1.548,
+          "y": 0.1,
+          "z": -0.612
+        },
+        "direction2": {
+          "x": 0.108,
+          "y": 0.86,
+          "z": 0.612
+        },
+        "minEmitBox": {
+          "x": -0.1,
+          "y": -0.03,
+          "z": -0.12
+        },
+        "maxEmitBox": {
+          "x": 0.12,
+          "y": 0.1,
+          "z": 0.12
+        },
+        "radiusRange": 0
+      },
+      "spriteSheet": {
+        "enabled": false
+      },
+      "alphaKeys": [
+        {
+          "time": 0,
+          "alpha": 0
+        },
+        {
+          "time": 0.08,
+          "alpha": 0.68
+        },
+        {
+          "time": 0.42,
+          "alpha": 0.42
+        },
+        {
+          "time": 1,
+          "alpha": 0
+        }
+      ],
+      "colorKeys": [
+        {
+          "time": 0,
+          "color": {
+            "r": 0.8,
+            "g": 0.65,
+            "b": 0.45,
+            "a": 0.72
+          }
+        },
+        {
+          "time": 1,
+          "color": {
+            "r": 0.5,
+            "g": 0.45,
+            "b": 0.38,
+            "a": 0
+          }
+        }
+      ],
+      "sizeKeys": [
+        {
+          "time": 0,
+          "size": 1.8125
+        },
+        {
+          "time": 0.35,
+          "size": 5
+        },
+        {
+          "time": 1,
+          "size": 8.125
+        }
+      ],
+      "renderColor": {
+        "color": {
+          "r": 0.8,
+          "g": 0.65,
+          "b": 0.45,
+          "a": 0.72
+        },
+        "colorIntensity": 1,
+        "alphaIntensity": 1
+      },
+      "minInitialRotation": 0,
+      "maxInitialRotation": 0,
+      "minAngularSpeed": 0,
+      "maxAngularSpeed": 0,
+      "source": {
+        "simulationSpace": 1,
+        "renderMode": 0,
+        "alignSpace": 2,
+        "normalizedVfxEmitterId": "tree_chop_dust_burst_dust"
+      },
+      "sourceMap": null,
+      "runtime": {
+        "stopAfterSeconds": 1.1,
+        "disposeOnComplete": true
+      }
+    }
+  ],
+  "runtime": {
+    "driver": "particle",
+    "defaultMesh": null,
+    "defaultOffset": {
+      "x": 0,
+      "y": 0,
+      "z": 0
+    },
+    "start": [
+      "Instantiate Babylon runtime for tree_chop_dust_burst"
+    ],
+    "update": [
+      "Apply Babylon tunable parameter overrides"
+    ],
+    "stop": [
+      "Stop and dispose runtime resources"
+    ],
+    "adapters": [
+      {
+        "id": "particleEmitter/v1",
+        "engine": "babylon",
+        "entry": "assets/runtime/particleEmitter.v1.js",
+        "moduleFormat": "esm",
+        "exports": [
+          "createParticleEmitterRuntime",
+          "runtimeContract"
+        ]
+      }
+    ]
+  },
+  "tunableParams": [
+    {
+      "key": "tree_chop_dust_burst_dust.manualEmitCount",
+      "labelZh": "烟尘数量",
+      "type": "number",
+      "default": 36,
+      "min": 1,
+      "max": 120,
+      "step": 1,
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "manualEmitCount",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.renderColor.color",
+      "labelZh": "烟尘颜色",
+      "type": "color",
+      "default": "#caa473",
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "renderColor.color",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.effectScale",
+      "labelZh": "整体缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.1,
+      "max": 8,
+      "step": 0.1,
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "effectScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.minLifeTime",
+      "labelZh": "烟尘最短生命周期",
+      "type": "number",
+      "default": 0.34,
+      "min": 0.05,
+      "max": 3,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "minLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.maxLifeTime",
+      "labelZh": "烟尘最长生命周期",
+      "type": "number",
+      "default": 0.82,
+      "min": 0.05,
+      "max": 3,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "maxLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.minEmitPower",
+      "labelZh": "烟尘最低速度",
+      "type": "number",
+      "default": 0.7,
+      "min": 0,
+      "max": 12,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "minEmitPower",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_chop_dust_burst_dust.maxEmitPower",
+      "labelZh": "烟尘最高速度",
+      "type": "number",
+      "default": 1.75,
+      "min": 0,
+      "max": 16,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_chop_dust_burst_dust",
+        "property": "maxEmitPower",
+        "operator": "set"
+      }
+    }
+  ],
+  "babylon": {
+    "driver": "particle",
+    "entryFile": "apps/vfx_asset_library/frontend/src/runtime/drivers/particleDriver.ts",
+    "previewConfig": {
+      "textureUrl": "assets/textures/tree_chop_dust_burst_dust.png",
+      "emitterCount": 1,
+      "effectFile": "tree_chop_dust_burst.json",
+      "normalizedVfx": "source/02-normalized-vfx.json"
+    }
+  },
+  "review": {
+    "status": "tweaked",
+    "artistNotes": [
+      "Built from the local Babylon tree chop dust prototype.",
+      "Uses a soft smoke puff layer for casual UA game feedback."
+    ],
+    "approvedBy": null,
+    "approvedAt": null,
+    "history": [
+      {
+        "at": "2026-06-01T00:00:00.000Z",
+        "from": "prototype",
+        "to": "tweaked",
+        "note": "Packaged for fps-vfx-library."
+      }
+    ]
+  },
+  "recording": {
+    "provider": "local-screenshot",
+    "recordedAt": "2026-06-01T00:00:00.000Z",
+    "mimeType": "image/png",
+    "durationSec": 1.1,
+    "fps": 0,
+    "media": {
+      "previewVideo": null,
+      "previewWebm": null,
+      "previewMp4": null,
+      "previewGif": null,
+      "thumbnail": "media/thumbnail.png",
+      "contactSheet": "media/contact-sheet.png",
+      "gcsUri": null
+    }
+  },
+  "aiDescription": null,
+  "search": {
+    "tags": [
+      "babylon",
+      "particle",
+      "tree",
+      "chop",
+      "dust",
+      "casual"
+    ],
+    "descriptionZh": "砍树命中时从命中点贴地喷出的简化烟尘团，带少量木屑飞溅，适合买量小游戏里的资源采集反馈。",
+    "descriptionEn": "A simple ground-hugging dust puff for tree falling impact feedback in casual UA games.",
+    "useCases": [
+      "tree falling impact",
+      "tree chopping dust feedback",
+      "casual resource collection"
+    ],
+    "negativeUseCases": [
+      "large explosion",
+      "continuous smoke plume",
+      "realistic cinematic dust"
+    ]
+  },
+  "legacyIds": [],
+  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.tree_chop_dust_burst",
+  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.tree_chop_dust_burst/source",
+  "fullProvenancePrefix": "gs://fps-vfx-library/packages/build.particle.tree_chop_dust_burst/provenance"
+}

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

@@ -0,0 +1,9 @@
+{
+  "tree_chop_dust_burst_dust.manualEmitCount": 21,
+  "tree_chop_dust_burst_dust.renderColor.color": "#ffffff",
+  "tree_chop_dust_burst_dust.effectScale": 0.5,
+  "tree_chop_dust_burst_dust.minLifeTime": 0.34,
+  "tree_chop_dust_burst_dust.maxLifeTime": 0.82,
+  "tree_chop_dust_burst_dust.minEmitPower": 0.7,
+  "tree_chop_dust_burst_dust.maxEmitPower": 1.75
+}

package/packages/effects/ufo-thread-flame/index.ts

@@ -0,0 +1,152 @@
+// UFO 丝束尾焰(移植自 babylon-laser loadShip 尾焰, 特效#13)。
+// 双贴图分工范式:flame_spike(刺形 alpha)走 opacityTexture(V-CLAMP 静止保轮廓);
+// flame_flow(蓝亮纹)走 emissiveTexture(V-WRAP,vOffset 递减让亮纹从根部向尾端流)。
+// 双层 NO_CAP 锥筒共享 StandardMaterial,ALPHA_ADD + 反向自转 + x/z 脉冲。沿 root 局部 -Z 喷出。
+import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
+import { Mesh } from '@babylonjs/core/Meshes/mesh';
+import { CreateCylinder } from '@babylonjs/core/Meshes/Builders/cylinderBuilder';
+import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
+import { Texture } from '@babylonjs/core/Materials/Textures/texture';
+import { Color3 } from '@babylonjs/core/Maths/math.color';
+import { Constants } from '@babylonjs/core/Engines/constants';
+import type { Scene } from '@babylonjs/core/scene';
+import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
+import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
+import flameSpikeUrl from './assets/textures/flame_spike.webp?url';
+import flameFlowUrl from './assets/textures/flame_flow.webp?url';
+import { LIFETIME_DEBUG_PARAMS, LIFETIME_DEFAULTS, scheduleLifetime } from '../space-shared';
+
+interface UfoThreadFlameParams extends VfxParamValues {
+  lifetimeMode: string; lifetime: number;
+  flameColor: VfxColorValue;
+  flameLen: number;
+  flameWidth: number;
+  flameSpeed: number;
+  flamePulse: number;
+  innerW: number; innerLen: number; innerOff: number;
+  outerW: number; outerLen: number; outerOff: number;
+  posX: number; posY: number; posZ: number;
+}
+
+const DEFAULT_PARAMS: UfoThreadFlameParams = {
+  ...LIFETIME_DEFAULTS,
+  flameColor: { r: 0.102, g: 0.427, b: 1.0 }, // #1a6dff
+  flameLen: 1.0, flameWidth: 1.0, flameSpeed: 1.0, flamePulse: 0.025,
+  innerW: 1.0, innerLen: 2.9, innerOff: 0,
+  outerW: 0.87, outerLen: 2.0, outerOff: 0.05,
+  posX: -0.02, posY: 0, posZ: -1.72,
+};
+
+// 双层锥筒基准直径(根/尾):里层箍中央喷口、外层略小于尾盘外缘
+const CONE_BASE: Array<{ dB: number; dT: number }> = [{ dB: 1.2, dT: 1.12 }, { dB: 2.5, dT: 2.3 }];
+
+function colorVec(c: VfxColorValue): Color3 { return new Color3(c.r, c.g, c.b); }
+function excludeFromGlow(scene: Scene, mesh: AbstractMesh): void {
+  for (const layer of scene.effectLayers ?? []) {
+    const add = (layer as unknown as { addExcludedMesh?: (m: AbstractMesh) => void }).addExcludedMesh;
+    if (typeof add === 'function') add.call(layer, mesh);
+  }
+}
+
+export const ufoThreadFlameEffectPackage: VfxEffectPackage<UfoThreadFlameParams> = {
+  id: 'ufo-thread-flame',
+  nameZh: 'UFO丝束尾焰',
+  debugAnchor: 'player',
+  defaultParams: DEFAULT_PARAMS,
+  debugParams: [
+    ...LIFETIME_DEBUG_PARAMS,
+    { key: 'flameColor', label: '尾焰颜色', kind: 'color' },
+    { key: 'flameLen', label: '长度倍率', kind: 'scale', min: 0.2, max: 4, step: 0.01 },
+    { key: 'flameWidth', label: '宽度倍率', kind: 'scale', min: 0.3, max: 3, step: 0.01 },
+    { key: 'flameSpeed', label: '自转/流速', kind: 'number', min: 0, max: 6, step: 0.05 },
+    { key: 'flamePulse', label: '脉冲幅度', kind: 'number', min: 0, max: 0.3, step: 0.005 },
+    { key: 'innerW', label: '里圈口径', kind: 'number', min: 0.2, max: 4, step: 0.01 },
+    { key: 'innerLen', label: '里圈长度', kind: 'number', min: 0.3, max: 8, step: 0.05 },
+    { key: 'innerOff', label: '里圈轴向偏移', kind: 'number', min: -2, max: 2, step: 0.01 },
+    { key: 'outerW', label: '外圈口径', kind: 'number', min: 0.2, max: 4, step: 0.01 },
+    { key: 'outerLen', label: '外圈长度', kind: 'number', min: 0.3, max: 8, step: 0.05 },
+    { key: 'outerOff', label: '外圈轴向偏移', kind: 'number', min: -2, max: 2, step: 0.01 },
+    { key: 'posX', label: '挂点X', kind: 'number', min: -2, max: 2, step: 0.01 },
+    { key: 'posY', label: '挂点Y', kind: 'number', min: -2, max: 2, step: 0.01 },
+    { key: 'posZ', label: '挂点Z(机尾后)', kind: 'number', min: -5, max: 2, step: 0.01 },
+  ],
+
+  create({ scene, root, position, rotationY, params }) {
+    root.position.copyFrom(position);
+    root.rotation.y = rotationY;
+
+    // 形状贴图:刺形 alpha,V-CLAMP 静止保轮廓
+    const spikeTex = new Texture(flameSpikeUrl, scene);
+    spikeTex.hasAlpha = true;
+    spikeTex.wrapU = Texture.WRAP_ADDRESSMODE;
+    spikeTex.wrapV = Texture.CLAMP_ADDRESSMODE;
+    spikeTex.uScale = 1; spikeTex.vScale = 1; spikeTex.vOffset = 0;
+    // 流动贴图:蓝亮纹,V-WRAP 可滚;level 压暗白纹让蓝基底主导(ADD 下白不受 emissiveColor 控)
+    const flowTex = new Texture(flameFlowUrl, scene);
+    flowTex.wrapU = Texture.WRAP_ADDRESSMODE;
+    flowTex.wrapV = Texture.WRAP_ADDRESSMODE;
+    flowTex.level = 0.62;
+
+    const mat = new StandardMaterial('vfx_ufo_flameMat', scene);
+    mat.emissiveTexture = flowTex;
+    mat.opacityTexture = spikeTex;
+    mat.emissiveColor = colorVec(params.flameColor);
+    mat.disableLighting = true;
+    mat.backFaceCulling = false;
+    mat.disableDepthWrite = true;
+    mat.alphaMode = Constants.ALPHA_ADD;
+    mat.alpha = 0.78;
+
+    const flameRoot = new TransformNode('vfx_ufo_flameRoot', scene);
+    flameRoot.parent = root;
+    flameRoot.rotation.x = -Math.PI / 2; // 筒轴 +Y → 机尾后方 -Z
+
+    const cones: Mesh[] = [];
+    for (const { dB, dT } of CONE_BASE) {
+      const c = CreateCylinder('vfx_ufo_flameTube', { diameterBottom: dB, diameterTop: dT, height: 1, tessellation: 36, cap: Mesh.NO_CAP }, scene);
+      c.isPickable = false;
+      c.parent = flameRoot;
+      c.material = mat;
+      excludeFromGlow(scene, c);
+      cones.push(c);
+    }
+
+    function applyShape(): void {
+      cones.forEach((c, i) => {
+        const inner = i === 0;
+        const len = (inner ? params.innerLen : params.outerLen) * params.flameLen;
+        const off = inner ? params.innerOff : params.outerOff;
+        const w = inner ? params.innerW : params.outerW;
+        c.scaling.y = len;
+        c.scaling.x = c.scaling.z = w;
+        c.position.y = len / 2 - 0.05 + off; // 根部微嵌喷口消缝
+      });
+      flameRoot.position.set(params.posX, params.posY, params.posZ);
+    }
+    applyShape();
+
+    let t = 0;
+    const observer = scene.onBeforeRenderObservable.add(() => {
+      const dt = Math.min(scene.getEngine().getDeltaTime() / 1000, 0.05);
+      t += dt;
+      cones.forEach((c, i) => { c.rotation.y += (i ? -2.0 : 1.5) * params.flameSpeed * dt; });
+      flowTex.vOffset -= 1.6 * params.flameSpeed * dt; // 亮纹从根部向尾端推进
+      const ps = 1 + Math.sin(t * 14) * params.flamePulse;
+      flameRoot.scaling.set(ps * params.flameWidth, 1, ps * params.flameWidth);
+    });
+
+    let disposed = false;
+    let ltTimer = 0;
+    const dispose = (): void => {
+      if (disposed) return; disposed = true;
+      if (ltTimer) window.clearTimeout(ltTimer);
+      scene.onBeforeRenderObservable.remove(observer);
+      for (const c of cones) c.dispose();
+      flameRoot.dispose();
+      mat.dispose(); spikeTex.dispose(); flowTex.dispose();
+      root.dispose();
+    };
+    ltTimer = scheduleLifetime(params, dispose);
+    return { root, dispose };
+  },
+};

package/packages/effects/ufo-thread-flame/vfx-params.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "vfx-params/1.0",
+  "effectId": "ufo-thread-flame",
+  "params": {}
+}

package/packages/effects/vehicle-exhaust-smoke/effect.json

@@ -0,0 +1,8 @@
+{
+  "id": "vehicle-exhaust-smoke",
+  "nameZh": "小车尾气",
+  "source": "runtime-generated",
+  "assets": [
+    "assets/textures/vehicle_exhaust_smoke_atlas.png"
+  ]
+}