@fps-games/vfx 0.3.2 → 0.3.4

package/packages/effects/tree_chop_dust_burst/tree_chop_dust_burst.json

@@ -1,412 +0,0 @@
-{
-  "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/ufo-thread-flame/index.ts

@@ -1,153 +0,0 @@
-// 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丝束尾焰',
-  placement: 'socket',
-  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/vehicle-exhaust-smoke/effect.json

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