@fps-games/vfx 0.3.2 → 0.3.4

package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-tuning-report.json

@@ -1,60 +0,0 @@
-{
-  "schemaVersion": "vfx-preview-tuning-report/1.0",
-  "stage": "preview-tuning",
-  "generatedAt": "2026-05-16T16:33:44.109Z",
-  "effectId": "world.particle.effect_build_processinglogs",
-  "sourcePackage": "vfx-intermediate/cocos-babylon-packages/effect_build_processinglogs",
-  "inputEffectFile": "03-effect.json",
-  "outputPackage": "world.particle.effect_build_processinglogs.stage4-package.zip",
-  "packageFiles": {
-    "tunedEffect": "03-effect.json",
-    "overrides": "04-preview-overrides.json",
-    "report": "04-preview-tuning-report.json"
-  },
-  "emitters": [
-    {
-      "name": "shumu",
-      "enabled": true,
-      "capacity": 100,
-      "emitRate": 0,
-      "particleTexturePath": "assets/textures/suipian3.png",
-      "materialSourcePath": "assets/materials/shumu.mtl",
-      "shape": "Cone",
-      "runtime": {
-        "adapter": "particleEmitter/v1"
-      },
-      "renderColor": {
-        "color": {
-          "r": 1,
-          "g": 1,
-          "b": 1,
-          "a": 1
-        },
-        "colorIntensity": 1,
-        "alphaIntensity": 1
-      }
-    },
-    {
-      "name": "yanwu",
-      "enabled": true,
-      "capacity": 100,
-      "emitRate": 0,
-      "particleTexturePath": "assets/textures/effect_yanwu4.png",
-      "materialSourcePath": "assets/materials/yanwu.mtl",
-      "shape": "Cone",
-      "runtime": {
-        "adapter": "particleEmitter/v1"
-      },
-      "renderColor": {
-        "color": {
-          "r": 1,
-          "g": 1,
-          "b": 1,
-          "a": 1
-        },
-        "colorIntensity": 1,
-        "alphaIntensity": 1
-      }
-    }
-  ]
-}

package/packages/build.particle.wood_chip_dust_burst/provenance/asset-map.json

@@ -1,146 +0,0 @@
-{
-  "schemaVersion": "vfx-asset-map/1.0",
-  "generatedAt": "2026-05-16T16:33:44.118Z",
-  "sourcePackage": "vfx-intermediate/cocos-babylon-packages/effect_build_processinglogs",
-  "policy": {
-    "runtimeAssetsRoot": "assets/",
-    "sourceAssetsRoot": "source/",
-    "note": "assets/ contains files loaded by Babylon runtime. source/cocos/assets/ preserves the original Cocos asset tree for traceability and reconversion."
-  },
-  "entries": [
-    {
-      "id": "effect_yanwu4",
-      "kind": "texture",
-      "group": "textures",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/textures/effect_yanwu4.png",
-      "sourcePackagePath": "assets/textures/effect_yanwu4.png",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/effect_yanwu4.png",
-      "sourceId": "97938072-6b83-42b3-a522-0a8c869d94d4@6c48a",
-      "usedBy": [
-        "emitters.yanwu.texture"
-      ],
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/effect_yanwu4.png",
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/effect_yanwu4.png"
-    },
-    {
-      "id": "suipian3",
-      "kind": "texture",
-      "group": "textures",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/textures/suipian3.png",
-      "sourcePackagePath": "assets/textures/suipian3.png",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/suipian3.png",
-      "sourceId": "951f017f-fb0e-4af7-8842-57d9096eb6f9@6c48a",
-      "usedBy": [
-        "emitters.shumu.texture"
-      ],
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/suipian3.png",
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/tex/suipian3.png"
-    },
-    {
-      "id": "shumu",
-      "kind": "material",
-      "group": "materials",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/shumu.mtl",
-      "sourcePackagePath": "assets/materials/shumu.mtl",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/shumu.mtl",
-      "sourceId": "0f514a26-1760-4fac-8282-f3a3075055d5",
-      "usedBy": [
-        "emitters.shumu.material"
-      ],
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/shumu.mtl",
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/shumu.mtl"
-    },
-    {
-      "id": "yanwu",
-      "kind": "material",
-      "group": "materials",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/yanwu.mtl",
-      "sourcePackagePath": "assets/materials/yanwu.mtl",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/yanwu.mtl",
-      "sourceId": "ba874fed-3e3c-4247-98cd-7405e3ce0738",
-      "usedBy": [
-        "emitters.yanwu.material"
-      ],
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/yanwu.mtl",
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/mat/yanwu.mtl"
-    },
-    {
-      "id": "02-normalized-vfx",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/02-normalized-vfx.json",
-      "sourcePackagePath": "source/02-normalized-vfx.json",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/02-normalized-vfx.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "01-source-dump",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/01-source-dump.json",
-      "sourcePackagePath": "source/01-source-dump.json",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/01-source-dump.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "effect_build_processinglogs",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/Effect_Build_Processinglogs.prefab",
-      "sourcePackagePath": "source/raw/Effect_Build_Processinglogs.prefab",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/prefab/Effect_Build_Processinglogs.prefab",
-      "sourceId": "25c97f18-e7cf-4a86-8653-bb2aa95edfc6",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/prefab/Effect_Build_Processinglogs.prefab"
-    },
-    {
-      "id": "effect_build_processinglogs.meta",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/Effect_Build_Processinglogs.prefab.meta",
-      "sourcePackagePath": "source/raw/Effect_Build_Processinglogs.prefab.meta",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source/cocos/assets/ArtResources/Effect/Effect_Build_Processinglogs/prefab/Effect_Build_Processinglogs.prefab.meta",
-      "sourceId": "25c97f18-e7cf-4a86-8653-bb2aa95edfc6",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Processinglogs/prefab/Effect_Build_Processinglogs.prefab.meta"
-    },
-    {
-      "id": "particle_emitter_v1",
-      "kind": "script",
-      "group": "scripts",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/runtime/particleEmitter.v1.js",
-      "sourcePackagePath": "assets/runtime/particleEmitter.v1.js",
-      "sourceArchivePath": null,
-      "sourcePath": null,
-      "sourceId": null,
-      "usedBy": []
-    }
-  ],
-  "packageId": "build.particle.wood_chip_dust_burst",
-  "previousPackageIds": [
-    "world.particle.effect_build_processinglogs"
-  ],
-  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source",
-  "canonicalSource": "gcs"
-}

package/packages/build.particle.wood_chip_dust_burst/provenance/lineage.json

@@ -1,69 +0,0 @@
-{
-  "schemaVersion": "vfx-library-lineage/1.0",
-  "savedAt": "2026-05-16T16:33:44.138Z",
-  "sourcePackage": "vfx-intermediate/cocos-babylon-packages/effect_build_processinglogs",
-  "sourceEffect": "03-effect.json",
-  "libraryPackage": "packages/build.particle.wood_chip_dust_burst",
-  "effectId": "build.particle.wood_chip_dust_burst",
-  "media": {
-    "previewVideo": "media/preview.webm",
-    "previewWebm": "media/preview.webm",
-    "previewMp4": "media/preview.mp4",
-    "previewGif": "media/preview.gif",
-    "thumbnail": "media/thumbnail.png",
-    "contactSheet": "media/contact-sheet.png",
-    "gcsUri": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.mp4",
-    "gcs": {
-      "previewMp4": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.mp4",
-      "previewWebm": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.webm",
-      "previewGif": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.gif",
-      "thumbnail": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/thumbnail.png",
-      "contactSheet": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/contact-sheet.png"
-    }
-  },
-  "recording": {
-    "provider": "browser-mediarecorder",
-    "recordedAt": "2026-05-16T16:33:44.772Z",
-    "mimeType": "video/webm;codecs=vp9",
-    "durationSec": 3,
-    "fps": 30,
-    "media": {
-      "previewVideo": "media/preview.webm",
-      "previewWebm": "media/preview.webm",
-      "previewMp4": "media/preview.mp4",
-      "previewGif": "media/preview.gif",
-      "thumbnail": "media/thumbnail.png",
-      "contactSheet": "media/contact-sheet.png",
-      "gcsUri": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.mp4",
-      "gcs": {
-        "previewMp4": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.mp4",
-        "previewWebm": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.webm",
-        "previewGif": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/preview.gif",
-        "thumbnail": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/thumbnail.png",
-        "contactSheet": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/media/contact-sheet.png"
-      }
-    }
-  },
-  "description": {
-    "provider": "funplus-litellm",
-    "status": "described",
-    "model": "gemini-3.1-pro-preview",
-    "metadata": "metadata/description.json"
-  },
-  "previousIds": [
-    "world.particle.effect_build_processinglogs"
-  ],
-  "renamedFrom": {
-    "effectId": "world.particle.effect_build_processinglogs",
-    "libraryPackage": "packages/world.particle.effect_build_processinglogs",
-    "gcsPrefix": "gs://fps-vfx-library/packages/world.particle.effect_build_processinglogs",
-    "renamedAt": "2026-05-16T19:40:50.833Z"
-  },
-  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/source",
-  "fullProvenancePrefix": "gs://fps-vfx-library/packages/build.particle.wood_chip_dust_burst/provenance",
-  "gitPackage": "packages/build.particle.wood_chip_dust_burst",
-  "legacyPackageIds": [
-    "world.particle.effect_build_processinglogs"
-  ]
-}

package/packages/effects/building-upgrade/effect.json

@@ -1,6 +0,0 @@
-{
-  "id": "building-upgrade",
-  "nameZh": "建筑升级金光",
-  "source": "runtime-generated",
-  "assets": []
-}

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

@@ -1,387 +0,0 @@
-import { Color4 } from '@babylonjs/core/Maths/math.color';
-import { Matrix, Vector3 } from '@babylonjs/core/Maths/math.vector';
-import { DynamicTexture } from '@babylonjs/core/Materials/Textures/dynamicTexture';
-import { ParticleSystem } from '@babylonjs/core/Particles/particleSystem';
-import type { Particle } from '@babylonjs/core/Particles/particle';
-import type { Scene } from '@babylonjs/core/scene';
-import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
-import { configureVfxParticleSystem } from '../../rendering';
-import manifest from './effect.json';
-
-interface BuildingUpgradeParams extends VfxParamValues {
-  lifetime: number;
-  scale: number;
-  initialHeight: number;
-  color: VfxColorValue;
-  opacity: number;
-  scaleX: number;
-  scaleY: number;
-  scaleZ: number;
-  centerCount: number;
-  outlineCount: number;
-  strandWidth: number;
-  riseSpeed: number;
-  centerSpread: number;
-  outlineThickness: number;
-  glowOpacity: number;
-}
-
-const BASE_FOOTPRINT_X = 3.2;
-const BASE_FOOTPRINT_Z = 2.6;
-const BASE_CENTER_HEIGHT = 2.2;
-const BASE_OUTLINE_HEIGHT = 3.1;
-const BASE_GLOW_THICKNESS = 0.38;
-
-const DEFAULT_PARAMS: BuildingUpgradeParams = {
-  lifetime: 1.8,
-  scale: 1,
-  initialHeight: 0.02,
-  color: { r: 1, g: 0.84, b: 0.12 },
-  opacity: 1,
-  scaleX: 1,
-  scaleY: 1,
-  scaleZ: 1,
-  centerCount: 46,
-  outlineCount: 150,
-  strandWidth: 0.035,
-  riseSpeed: 1.15,
-  centerSpread: 0.92,
-  outlineThickness: 0.18,
-  glowOpacity: 0.62,
-};
-
-export const buildingUpgradeEffectPackage: VfxEffectPackage<BuildingUpgradeParams> = {
-  id: 'building-upgrade',
-  nameZh: '建筑升级金光',
-  manifest,
-  defaultParams: DEFAULT_PARAMS,
-  debugAnchor: 'playerRight',
-  debugParams: [
-    { key: 'lifetime', label: '生命周期', kind: 'lifetime', min: 0.2, max: 6, step: 0.01 },
-    { key: 'scale', label: '整体缩放', kind: 'scale', min: 0.1, max: 6, step: 0.01 },
-    { key: 'initialHeight', label: '初始高度', kind: 'number', min: -1, max: 3, step: 0.01 },
-    { key: 'color', label: '金光颜色', kind: 'color' },
-    { key: 'opacity', label: '透明度', kind: 'opacity', min: 0, max: 1, step: 0.01 },
-    { key: 'scaleX', label: 'X 轴缩放', kind: 'number', min: 0.1, max: 6, step: 0.01 },
-    { key: 'scaleY', label: 'Y 轴缩放', kind: 'number', min: 0.1, max: 6, step: 0.01 },
-    { key: 'scaleZ', label: 'Z 轴缩放', kind: 'number', min: 0.1, max: 6, step: 0.01 },
-    { key: 'centerCount', label: '中心金丝数量', kind: 'number', min: 0, max: 240, step: 1 },
-    { key: 'outlineCount', label: '轮廓金丝数量', kind: 'number', min: 0, max: 420, step: 1 },
-    { key: 'strandWidth', label: '金丝粗细', kind: 'number', min: 0.005, max: 0.2, step: 0.001 },
-    { key: 'riseSpeed', label: '上升速度', kind: 'number', min: 0, max: 5, step: 0.01 },
-    { key: 'centerSpread', label: '中心散布', kind: 'number', min: 0, max: 1.5, step: 0.01 },
-    { key: 'outlineThickness', label: '轮廓厚度', kind: 'number', min: 0, max: 1, step: 0.01 },
-    { key: 'glowOpacity', label: '光芒强度', kind: 'opacity', min: 0, max: 1, step: 0.01 },
-  ],
-  create({ scene, root, position, params }) {
-    root.position.copyFrom(position).addInPlace(new Vector3(0, params.initialHeight, 0));
-
-    const centerStrands = createStrandSystem(scene, root, params, 'center');
-    const outlineStrands = createStrandSystem(scene, root, params, 'outline');
-    const glow = createOutlineGlow(scene, root, params);
-    const disposeTimer = window.setTimeout(
-      () => disposeAll(),
-      Math.max(0.05, params.lifetime + getMaxStrandHeight(params) / Math.max(0.1, params.riseSpeed) * 0.18 + 0.45) * 1000,
-    );
-    let disposed = false;
-
-    centerStrands.start();
-    outlineStrands.start();
-    glow.start();
-
-    return {
-      root,
-      dispose() {
-        disposeAll();
-      },
-    };
-
-    function disposeAll(): void {
-      if (disposed) return;
-      disposed = true;
-      window.clearTimeout(disposeTimer);
-      centerStrands.dispose(false);
-      outlineStrands.dispose(false);
-      glow.dispose(false);
-      root.dispose();
-    }
-  },
-};
-
-function createStrandSystem(
-  scene: Scene,
-  root: TransformNode,
-  params: BuildingUpgradeParams,
-  mode: 'center' | 'outline',
-): ParticleSystem {
-  const count = Math.max(0, Math.round(mode === 'center' ? params.centerCount : params.outlineCount));
-  const system = new ParticleSystem(`building-upgrade.${mode}-strands`, Math.max(1, count), scene);
-  const color = params.color;
-  const height = mode === 'center' ? getCenterHeight(params) : getOutlineHeight(params);
-  const width = params.strandWidth * getHorizontalScale(params) * (mode === 'center' ? 1.35 : 0.92);
-
-  configureVfxParticleSystem(system);
-  system.particleTexture = getGoldStrandTexture(scene);
-  system.emitter = root as any;
-  system.manualEmitCount = count;
-  system.emitRate = count * 60;
-  system.targetStopDuration = 0.04;
-  system.disposeOnStop = false;
-  system.updateSpeed = 1 / 60;
-  system.minLifeTime = Math.max(0.12, params.lifetime * (mode === 'center' ? 0.48 : 0.62));
-  system.maxLifeTime = Math.max(system.minLifeTime + 0.01, params.lifetime * (mode === 'center' ? 0.86 : 1.08));
-  system.minSize = Math.max(0.01, height * 0.34);
-  system.maxSize = Math.max(system.minSize, height * (mode === 'center' ? 0.72 : 0.98));
-  system.minScaleX = Math.max(0.02, width);
-  system.maxScaleX = Math.max(system.minScaleX, width * 1.8);
-  system.minScaleY = 1;
-  system.maxScaleY = mode === 'center' ? 1.45 : 1.75;
-  system.minEmitPower = Math.max(0.01, params.riseSpeed * getVerticalScale(params) * (mode === 'center' ? 0.5 : 0.7));
-  system.maxEmitPower = Math.max(system.minEmitPower, params.riseSpeed * getVerticalScale(params) * (mode === 'center' ? 1.15 : 1.65));
-  system.gravity = new Vector3(0, 0.38 * getVerticalScale(params), 0);
-  system.blendMode = ParticleSystem.BLENDMODE_ADD;
-  system.color1 = toColor4(color, params.opacity * (mode === 'center' ? 0.72 : 0.86));
-  system.color2 = toColor4({ r: 1, g: 0.98, b: 0.52 }, params.opacity);
-  system.colorDead = toColor4(color, 0);
-  system.addColorGradient(0, toColor4(color, 0));
-  system.addColorGradient(0.12, toColor4({ r: 1, g: 0.96, b: 0.42 }, params.opacity));
-  system.addColorGradient(0.72, toColor4(color, params.opacity * 0.62));
-  system.addColorGradient(1, toColor4(color, 0));
-  system.addVelocityGradient(0, 1);
-  system.addVelocityGradient(0.65, 0.55);
-  system.addVelocityGradient(1, 0.12);
-
-  let positionIndex = 0;
-  let directionIndex = 0;
-  system.startPositionFunction = (worldMatrix: Matrix, positionToUpdate: Vector3, particle: Particle, isLocal: boolean) => {
-    const index = particle.id + positionIndex;
-    positionIndex += 1;
-    const local = mode === 'center'
-      ? sampleCenterPosition(index, params)
-      : sampleOutlinePosition(index, params);
-    if (isLocal) positionToUpdate.copyFrom(local);
-    else Vector3.TransformCoordinatesToRef(local, worldMatrix, positionToUpdate);
-  };
-  system.startDirectionFunction = (worldMatrix: Matrix, directionToUpdate: Vector3, particle: Particle, isLocal: boolean) => {
-    const index = particle.id + directionIndex;
-    directionIndex += 1;
-    const sway = (mode === 'center' ? 0.22 : 0.12) * getHorizontalScale(params);
-    const local = new Vector3(
-      (sequence01(index, 4) - 0.5) * sway,
-      0.8 + sequence01(index, 5) * 0.65,
-      (sequence01(index, 6) - 0.5) * sway,
-    );
-    if (isLocal) directionToUpdate.copyFrom(local);
-    else Vector3.TransformNormalToRef(local, worldMatrix, directionToUpdate);
-  };
-
-  return system;
-}
-
-function createOutlineGlow(scene: Scene, root: TransformNode, params: BuildingUpgradeParams): ParticleSystem {
-  const count = Math.max(1, Math.round(params.outlineCount * 0.82));
-  const system = new ParticleSystem('building-upgrade.outline-glow-rays', count, scene);
-  const height = getOutlineHeight(params) * 1.06;
-  const glowWidth = Math.max(0.04, BASE_GLOW_THICKNESS * getHorizontalScale(params));
-  const alpha = params.glowOpacity * params.opacity;
-
-  configureVfxParticleSystem(system);
-  system.particleTexture = getOutlineGlowTexture(scene);
-  system.emitter = root as any;
-  system.manualEmitCount = count;
-  system.emitRate = count * 60;
-  system.targetStopDuration = 0.04;
-  system.disposeOnStop = false;
-  system.updateSpeed = 1 / 60;
-  system.minLifeTime = Math.max(0.12, params.lifetime * 0.62);
-  system.maxLifeTime = Math.max(system.minLifeTime + 0.01, params.lifetime * 1.08);
-  system.minSize = Math.max(0.01, height * 0.42);
-  system.maxSize = Math.max(system.minSize, height * 1.08);
-  system.minScaleX = glowWidth * 0.42;
-  system.maxScaleX = glowWidth * 1.18;
-  system.minScaleY = 1.05;
-  system.maxScaleY = 1.75;
-  system.minEmitPower = Math.max(0.01, params.riseSpeed * getVerticalScale(params) * 0.58);
-  system.maxEmitPower = Math.max(system.minEmitPower, params.riseSpeed * getVerticalScale(params) * 1.38);
-  system.gravity = new Vector3(0, 0.3 * getVerticalScale(params), 0);
-  system.blendMode = ParticleSystem.BLENDMODE_ADD;
-  system.color1 = toColor4(params.color, alpha * 0.62);
-  system.color2 = toColor4({ r: 1, g: 0.98, b: 0.58 }, alpha * 0.86);
-  system.colorDead = toColor4(params.color, 0);
-  system.addColorGradient(0, toColor4(params.color, 0));
-  system.addColorGradient(0.1, toColor4({ r: 1, g: 0.96, b: 0.48 }, alpha * 0.82));
-  system.addColorGradient(0.56, toColor4(params.color, alpha * 0.52));
-  system.addColorGradient(1, toColor4(params.color, 0));
-  system.addVelocityGradient(0, 1);
-  system.addVelocityGradient(0.65, 0.52);
-  system.addVelocityGradient(1, 0.12);
-
-  let positionIndex = 0;
-  let directionIndex = 0;
-  system.startPositionFunction = (worldMatrix: Matrix, positionToUpdate: Vector3, particle: Particle, isLocal: boolean) => {
-    const index = particle.id + positionIndex + 31;
-    positionIndex += 1;
-    const local = sampleOutlinePosition(index, params);
-    if (isLocal) positionToUpdate.copyFrom(local);
-    else Vector3.TransformCoordinatesToRef(local, worldMatrix, positionToUpdate);
-  };
-  system.startDirectionFunction = (worldMatrix: Matrix, directionToUpdate: Vector3, particle: Particle, isLocal: boolean) => {
-    const index = particle.id + directionIndex + 31;
-    directionIndex += 1;
-    const sway = 0.08 * getHorizontalScale(params);
-    const local = new Vector3(
-      (sequence01(index, 4) - 0.5) * sway,
-      0.82 + sequence01(index, 5) * 0.58,
-      (sequence01(index, 6) - 0.5) * sway,
-    );
-    if (isLocal) directionToUpdate.copyFrom(local);
-    else Vector3.TransformNormalToRef(local, worldMatrix, directionToUpdate);
-  };
-
-  return system;
-}
-
-function sampleCenterPosition(index: number, params: BuildingUpgradeParams): Vector3 {
-  const angle = sequence01(index, 0) * Math.PI * 2;
-  const radius = Math.sqrt(0.16 + sequence01(index, 1) * 0.84);
-  const xRadius = getFootprintX(params) * 0.5 * params.centerSpread;
-  const zRadius = getFootprintZ(params) * 0.5 * params.centerSpread;
-  const jitterX = (sequence01(index, 7) - 0.5) * xRadius * 0.18;
-  const jitterZ = (sequence01(index, 8) - 0.5) * zRadius * 0.18;
-  const x = Math.cos(angle) * radius * xRadius + jitterX;
-  const z = Math.sin(angle) * radius * zRadius + jitterZ;
-  const y = sequence01(index, 2) * 0.12 * getVerticalScale(params);
-  return new Vector3(x, y, z);
-}
-
-function sampleOutlinePosition(index: number, params: BuildingUpgradeParams): Vector3 {
-  const width = getFootprintX(params);
-  const depth = getFootprintZ(params);
-  const perimeter = Math.max(0.001, width * 2 + depth * 2);
-  const distance = sequence01(index, 0) * perimeter;
-  const jitter = (sequence01(index, 1) - 0.5) * params.outlineThickness * getHorizontalScale(params);
-  const y = sequence01(index, 2) * 0.16 * getVerticalScale(params);
-
-  if (distance < width) return new Vector3(-width * 0.5 + distance, y, -depth * 0.5 + jitter);
-  if (distance < width + depth) return new Vector3(width * 0.5 + jitter, y, -depth * 0.5 + distance - width);
-  if (distance < width * 2 + depth) return new Vector3(width * 0.5 - (distance - width - depth), y, depth * 0.5 + jitter);
-  return new Vector3(-width * 0.5 + jitter, y, depth * 0.5 - (distance - width * 2 - depth));
-}
-
-function getFootprintX(params: BuildingUpgradeParams): number {
-  return BASE_FOOTPRINT_X * Math.max(0.05, params.scale) * Math.max(0.05, params.scaleX);
-}
-
-function getFootprintZ(params: BuildingUpgradeParams): number {
-  return BASE_FOOTPRINT_Z * Math.max(0.05, params.scale) * Math.max(0.05, params.scaleZ);
-}
-
-function getVerticalScale(params: BuildingUpgradeParams): number {
-  return Math.max(0.05, params.scale) * Math.max(0.05, params.scaleY);
-}
-
-function getHorizontalScale(params: BuildingUpgradeParams): number {
-  return Math.max(0.05, params.scale) * Math.max(0.05, (params.scaleX + params.scaleZ) * 0.5);
-}
-
-function getCenterHeight(params: BuildingUpgradeParams): number {
-  return BASE_CENTER_HEIGHT * getVerticalScale(params);
-}
-
-function getOutlineHeight(params: BuildingUpgradeParams): number {
-  return BASE_OUTLINE_HEIGHT * getVerticalScale(params);
-}
-
-function getMaxStrandHeight(params: BuildingUpgradeParams): number {
-  return Math.max(getCenterHeight(params), getOutlineHeight(params));
-}
-
-function getGoldStrandTexture(scene: Scene): DynamicTexture {
-  const key = '__vfx_building_upgrade_gold_strand_texture';
-  const metadata = scene.metadata && typeof scene.metadata === 'object' ? scene.metadata as Record<string, unknown> : {};
-  scene.metadata = metadata;
-  const existing = metadata[key] as DynamicTexture | undefined;
-  if (existing) return existing;
-
-  const texture = new DynamicTexture('building_upgrade_gold_strand_texture', { width: 48, height: 192 }, scene, true);
-  const context = texture.getContext();
-  context.clearRect(0, 0, 48, 192);
-  const glow = context.createLinearGradient(0, 0, 0, 192);
-  glow.addColorStop(0, 'rgba(255, 250, 156, 0)');
-  glow.addColorStop(0.18, 'rgba(255, 239, 84, 0.92)');
-  glow.addColorStop(0.62, 'rgba(255, 210, 28, 0.52)');
-  glow.addColorStop(1, 'rgba(255, 181, 0, 0)');
-  context.fillStyle = glow;
-  context.fillRect(19, 0, 10, 192);
-  context.fillStyle = 'rgba(255, 255, 225, 0.95)';
-  context.fillRect(23, 8, 2, 168);
-  const halo = context.createRadialGradient(24, 64, 0, 24, 64, 24);
-  halo.addColorStop(0, 'rgba(255, 239, 96, 0.5)');
-  halo.addColorStop(1, 'rgba(255, 199, 0, 0)');
-  context.fillStyle = halo;
-  context.fillRect(0, 16, 48, 96);
-  texture.hasAlpha = true;
-  texture.update(false);
-  metadata[key] = texture;
-  return texture;
-}
-
-function getOutlineGlowTexture(scene: Scene): DynamicTexture {
-  const key = '__vfx_building_upgrade_outline_glow_texture';
-  const metadata = scene.metadata && typeof scene.metadata === 'object' ? scene.metadata as Record<string, unknown> : {};
-  scene.metadata = metadata;
-  const existing = metadata[key] as DynamicTexture | undefined;
-  if (existing) return existing;
-
-  const texture = new DynamicTexture('building_upgrade_outline_glow_texture', { width: 96, height: 192 }, scene, true);
-  const context = texture.getContext();
-  const compositeContext = context as unknown as CanvasRenderingContext2D;
-  context.clearRect(0, 0, 96, 192);
-  const sideFade = context.createLinearGradient(0, 0, 96, 0);
-  sideFade.addColorStop(0, 'rgba(255, 204, 0, 0)');
-  sideFade.addColorStop(0.28, 'rgba(255, 220, 38, 0.36)');
-  sideFade.addColorStop(0.5, 'rgba(255, 246, 142, 0.78)');
-  sideFade.addColorStop(0.72, 'rgba(255, 220, 38, 0.36)');
-  sideFade.addColorStop(1, 'rgba(255, 204, 0, 0)');
-  const verticalFade = context.createLinearGradient(0, 0, 0, 192);
-  verticalFade.addColorStop(0, 'rgba(255, 244, 115, 0)');
-  verticalFade.addColorStop(0.16, 'rgba(255, 236, 72, 0.65)');
-  verticalFade.addColorStop(0.55, 'rgba(255, 212, 22, 0.46)');
-  verticalFade.addColorStop(1, 'rgba(255, 174, 0, 0)');
-  context.fillStyle = sideFade;
-  context.fillRect(0, 0, 96, 192);
-  compositeContext.globalCompositeOperation = 'source-in';
-  context.fillStyle = verticalFade;
-  context.fillRect(0, 0, 96, 192);
-  compositeContext.globalCompositeOperation = 'source-over';
-  const core = context.createLinearGradient(0, 0, 0, 192);
-  core.addColorStop(0, 'rgba(255, 255, 214, 0)');
-  core.addColorStop(0.22, 'rgba(255, 255, 214, 0.64)');
-  core.addColorStop(0.66, 'rgba(255, 231, 82, 0.28)');
-  core.addColorStop(1, 'rgba(255, 185, 0, 0)');
-  context.fillStyle = core;
-  context.fillRect(44, 8, 8, 166);
-  texture.hasAlpha = true;
-  texture.update(false);
-  metadata[key] = texture;
-  return texture;
-}
-
-function toColor4(color: VfxColorValue, alpha: number): Color4 {
-  return new Color4(clamp01(color.r), clamp01(color.g), clamp01(color.b), clamp01(alpha));
-}
-
-function clamp01(value: number): number {
-  return Math.min(1, Math.max(0, value));
-}
-
-function fract(value: number): number {
-  return value - Math.floor(value);
-}
-
-function sequence01(index: number, axis: number): number {
-  if (index === 0) return 0.5;
-  const strides = [0.618033988749895, 0.414213562373095, 0.732050807568877, 0.324717957244746, 0.754877666246693, 0.569840290998053];
-  return fract(0.5 + index * strides[axis % strides.length] + axis * 0.173205080756888);
-}