@fps-games/vfx 0.3.2 → 0.3.4

package/packages/effects/pulse-laser-volley/index.ts

@@ -1,215 +0,0 @@
-// 脉冲激光齐射(移植自 babylon-laser pulseSystem, 特效#12)。
-// ShaderMaterial 乘色范式(复刻 Unity Particle Add):贴图中性白+alpha,颜色全由 shader tint 决定。
-// 自包含库版:沿 root 局部 +Z 朝距离 targetDistance 的虚拟目标自动整排齐射光弹池 + 发射点白球。
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import { CreatePlane } from '@babylonjs/core/Meshes/Builders/planeBuilder';
-import { CreateSphere } from '@babylonjs/core/Meshes/Builders/sphereBuilder';
-import { ShaderMaterial } from '@babylonjs/core/Materials/shaderMaterial';
-import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
-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 type { Mesh } from '@babylonjs/core/Meshes/mesh';
-import type { Scene } from '@babylonjs/core/scene';
-import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
-import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
-import boltTextureUrl from './assets/textures/bolt_guangshu.webp?url';
-import { LIFETIME_DEBUG_PARAMS, LIFETIME_DEFAULTS, scheduleLifetime } from '../space-shared';
-
-interface PulseLaserParams extends VfxParamValues {
-  lifetimeMode: string; lifetime: number;
-  targetDistance: number;
-  volleyInterval: number;
-  boltSpeed: number;
-  boltsPerVolley: number;
-  boltSpacing: number;
-  boltLen: number;
-  boltColor: VfxColorValue;
-  boltCore: number;
-  boltCorePow: number;
-  boltBright: number;
-}
-
-const DEFAULT_PARAMS: PulseLaserParams = {
-  ...LIFETIME_DEFAULTS,
-  targetDistance: 12,
-  volleyInterval: 0.22,
-  boltSpeed: 26,
-  boltsPerVolley: 6,
-  boltSpacing: 0.5,
-  boltLen: 1.0,
-  boltColor: { r: 0.071, g: 0.408, b: 1.0 }, // #1268ff
-  boltCore: 0.3,
-  boltCorePow: 3.0,
-  boltBright: 1.3,
-};
-
-const BOLT_LEN = 2.0, BOLT_W = 0.34, POOL_SIZE = 60;
-
-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); }`;
-
-// 乘色:col = mix(tint, white, pow(a,corePow)*coreStr) * bright;  配 ALPHA_ADD
-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(): void {
-  if (shadersRegistered) return;
-  Effect.ShadersStore['vfxPulseBoltVertexShader'] = BOLT_VERTEX;
-  Effect.ShadersStore['vfxPulseBoltFragmentShader'] = BOLT_FRAGMENT;
-  shadersRegistered = true;
-}
-
-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);
-  }
-}
-
-interface Bolt { mesh: Mesh; left: number; }
-
-export const pulseLaserVolleyEffectPackage: VfxEffectPackage<PulseLaserParams> = {
-  id: 'pulse-laser-volley',
-  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: 'volleyInterval', label: '齐射间隔(s)', kind: 'number', min: 0.08, max: 1, step: 0.01 },
-    { key: 'boltSpeed', label: '光弹速度', kind: 'number', min: 5, max: 60, step: 1 },
-    { key: 'boltsPerVolley', label: '每排弹数', kind: 'number', min: 1, max: 12, step: 1 },
-    { key: 'boltSpacing', label: '排内间距', kind: 'number', min: 0.2, max: 1.5, step: 0.05 },
-    { 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();
-    // 有 inputs.aim:每帧朝目标(Space.WORLD,root 挂在炮口)+ 齐射射程=到目标距离;无 aim 回退挂点朝向 + params.targetDistance。
-    const effectiveDist = (): number => {
-      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);
-
-    // 对象池:单面片,长轴沿局部 +Z,均为 root 子节点(在 root 局部空间飞行)
-    const pool: Bolt[] = [];
-    for (let i = 0; i < POOL_SIZE; i++) {
-      const mesh = CreatePlane(`vfx_pulse_bolt${i}`, { 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);
-      pool.push({ mesh, left: 0 });
-    }
-
-    // 发射点白球(不排除辉光,吃 bloom)
-    const muzzle = CreateSphere('vfx_pulse_muzzle', { diameter: 0.85, segments: 16 }, scene);
-    const muzzleMat = new StandardMaterial('vfx_pulse_muzzleMat', scene);
-    muzzleMat.emissiveColor = new Color3(1, 1, 1);
-    muzzleMat.diffuseColor = Color3.Black();
-    muzzleMat.disableLighting = true;
-    muzzleMat.alpha = 0.95;
-    muzzle.material = muzzleMat;
-    muzzle.isPickable = false;
-    muzzle.parent = root;
-    muzzle.position.set(0, 0, 0);
-    let muzzleFlash = 0;
-
-    function fireVolley(dist: number): void {
-      const n = Math.max(1, Math.round(params.boltsPerVolley));
-      let fired = 0;
-      for (const b of pool) {
-        if (fired >= n) break;
-        if (b.left > 0) continue;
-        const off = (fired - (n - 1) / 2) * params.boltSpacing;
-        b.mesh.position.set(off, 0, 0);                  // 沿局部 X 横向排开,从根部出发
-        b.mesh.scaling.z = params.boltLen / BOLT_LEN;
-        b.left = dist / params.boltSpeed;
-        b.mesh.setEnabled(true);
-        fired += 1;
-      }
-      muzzleFlash = 1;
-    }
-
-    let volleyTimer = 0;
-    const observer = scene.onBeforeRenderObservable.add(() => {
-      const dt = Math.min(scene.getEngine().getDeltaTime() / 1000, 0.05);
-      const dist = effectiveDist();   // 每帧:有 aim 则朝目标 + 取到目标距离
-      volleyTimer += dt;
-      if (volleyTimer >= params.volleyInterval) { volleyTimer = 0; fireVolley(dist); }
-
-      muzzleFlash = Math.max(0, muzzleFlash - dt * 6);
-      const s = 1 + muzzleFlash * 0.6;
-      muzzle.scaling.set(s, s, s);
-
-      const step = params.boltSpeed * dt;
-      for (const b of pool) {
-        if (b.left <= 0) continue;
-        b.left -= dt;
-        b.mesh.position.z += step;     // 沿局部 +Z 匀速飞行
-        if (b.left <= 0) b.mesh.setEnabled(false);
-      }
-    });
-
-    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 b of pool) b.mesh.dispose();
-      muzzle.dispose(); muzzleMat.dispose();
-      boltMat.dispose(); boltTex.dispose();
-      root.dispose();
-    };
-    ltTimer = scheduleLifetime(params, dispose);
-    return { root, dispose };
-  },
-};

package/packages/effects/resource-collect-sparkles/effect.json

@@ -1,6 +0,0 @@
-{
-  "id": "resource-collect-sparkles",
-  "nameZh": "资源持续收集圆点",
-  "assets": [],
-  "source": "procedural"
-}

package/packages/effects/resource-collect-sparkles/index.ts

@@ -1,254 +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 ResourceCollectSparklesParams extends VfxParamValues {
-  lifetime: number;
-  emitMode: string;
-  scale: number;
-  initialHeight: number;
-  color: VfxColorValue;
-  opacity: number;
-  particleCount: number;
-  particleLife: number;
-  minSize: number;
-  maxSize: number;
-  directionX: number;
-  directionY: number;
-  directionZ: number;
-  riseSpeed: number;
-  drift: number;
-  glowStrength: number;
-}
-
-const DEFAULT_PARAMS: ResourceCollectSparklesParams = {
-  lifetime: 1,
-  emitMode: 'loop',
-  scale: 1,
-  initialHeight: 0.035,
-  color: { r: 1, g: 0.82, b: 0.38 },
-  opacity: 0.88,
-  particleCount: 26,
-  particleLife: 0.86,
-  minSize: 0.045,
-  maxSize: 0.12,
-  directionX: 0,
-  directionY: 1,
-  directionZ: 0,
-  riseSpeed: 0.58,
-  drift: 0.08,
-  glowStrength: 2.4,
-};
-
-export const resourceCollectSparklesEffectPackage: VfxEffectPackage<ResourceCollectSparklesParams> = {
-  id: 'resource-collect-sparkles',
-  nameZh: '资源持续收集圆点',
-  manifest,
-  defaultParams: DEFAULT_PARAMS,
-  debugAnchor: 'playerRight',
-  debugParams: [
-    {
-      key: 'emitMode',
-      label: '发射模式',
-      kind: 'enum',
-      options: [
-        { value: 'loop', label: '一直发射' },
-        { value: 'timed', label: '自定义时间' },
-      ],
-    },
-    { key: 'lifetime', label: '生命周期', kind: 'lifetime', min: 0.08, max: 8, step: 0.01 },
-    { key: 'scale', label: '整体缩放', kind: 'scale', min: 0.05, max: 6, step: 0.01 },
-    { key: 'initialHeight', label: '初始高度', kind: 'number', min: -0.5, max: 2, step: 0.01 },
-    { key: 'color', label: '圆点颜色', kind: 'color' },
-    { key: 'opacity', label: '透明度', kind: 'opacity', min: 0, max: 1, step: 0.01 },
-    { key: 'particleCount', label: '粒子数量', kind: 'number', min: 0, max: 240, step: 1 },
-    { key: 'particleLife', label: '单点生命', kind: 'number', min: 0.08, max: 4, step: 0.01 },
-    { key: 'minSize', label: '最小大小', kind: 'number', min: 0.005, max: 1, step: 0.001 },
-    { key: 'maxSize', label: '最大大小', kind: 'number', min: 0.005, max: 1, step: 0.001 },
-    { key: 'directionX', label: '方向 X', kind: 'number', min: -1, max: 1, step: 0.01 },
-    { key: 'directionY', label: '方向 Y', kind: 'number', min: -1, max: 1, step: 0.01 },
-    { key: 'directionZ', label: '方向 Z', kind: 'number', min: -1, max: 1, step: 0.01 },
-    { key: 'riseSpeed', label: '发射速度', kind: 'number', min: 0, max: 5, step: 0.01 },
-    { key: 'drift', label: '方向扰动', kind: 'number', min: 0, max: 2, step: 0.01 },
-    { key: 'glowStrength', label: '光芒强度', kind: 'number', min: 0.1, max: 8, step: 0.05 },
-  ],
-  create({ scene, root, position, params }) {
-    root.position.copyFrom(position).addInPlace(new Vector3(0, params.initialHeight, 0));
-    const system = createDotSystem(scene, root, params);
-    let disposed = false;
-    let stopTimer: number | null = null;
-    let disposeTimer: number | null = null;
-
-    system.start();
-    if (readEmitMode(params.emitMode) === 'timed') {
-      stopTimer = window.setTimeout(() => system.stop(), Math.max(0.01, params.lifetime) * 1000);
-      disposeTimer = window.setTimeout(
-        () => disposeAll(),
-        Math.max(0.05, params.lifetime + params.particleLife + 0.12) * 1000,
-      );
-    }
-
-    return {
-      root,
-      dispose() {
-        disposeAll();
-      },
-    };
-
-    function disposeAll(): void {
-      if (disposed) return;
-      disposed = true;
-      if (stopTimer !== null) window.clearTimeout(stopTimer);
-      if (disposeTimer !== null) window.clearTimeout(disposeTimer);
-      system.stop();
-      system.dispose(false);
-      root.dispose();
-    }
-  },
-};
-
-function createDotSystem(scene: Scene, root: TransformNode, params: ResourceCollectSparklesParams): ParticleSystem {
-  const scale = Math.max(0.01, params.scale);
-  const particleCount = Math.max(0, Math.round(params.particleCount));
-  const particleLife = Math.max(0.04, params.particleLife);
-  const emitRate = particleCount / particleLife;
-  const capacity = Math.max(16, Math.ceil(particleCount * 2.4 + 16));
-  const system = new ParticleSystem('resource-collect-dots', capacity, scene);
-  const minSize = Math.max(0.001, Math.min(params.minSize, params.maxSize) * scale);
-  const maxSize = Math.max(minSize, Math.max(params.minSize, params.maxSize) * scale);
-
-  configureVfxParticleSystem(system);
-  system.particleTexture = getDotTexture(scene);
-  system.emitter = root as any;
-  system.emitRate = emitRate;
-  system.updateSpeed = 1 / 60;
-  system.minLifeTime = particleLife * 0.9;
-  system.maxLifeTime = particleLife * 1.14;
-  system.minSize = minSize;
-  system.maxSize = maxSize;
-  system.minAngularSpeed = 0;
-  system.maxAngularSpeed = 0;
-  system.minEmitPower = 1;
-  system.maxEmitPower = 1;
-  system.gravity = Vector3.Zero();
-  system.blendMode = ParticleSystem.BLENDMODE_ADD;
-  const glow = Math.max(0.1, params.glowStrength);
-  system.color1 = tintColor(params.color, glow, 0.72 * params.opacity);
-  system.color2 = tintColor(params.color, glow * 1.18, 0.9 * params.opacity);
-  system.colorDead = tintColor(params.color, glow, 0);
-  system.addColorGradient(0, tintColor(params.color, glow * 0.65, 0));
-  system.addColorGradient(0.18, tintColor(params.color, glow * 1.28, 0.82 * params.opacity));
-  system.addColorGradient(0.72, tintColor(params.color, glow, 0.68 * params.opacity));
-  system.addColorGradient(1, tintColor(params.color, glow * 0.5, 0));
-  system.addVelocityGradient(0, 0.92);
-  system.addVelocityGradient(0.72, 1);
-  system.addVelocityGradient(1, 0.42);
-  system.addDragGradient(0, 0.08);
-  system.addDragGradient(1, 0.45);
-
-  let positionIndex = 0;
-  let directionIndex = 4096;
-  system.startPositionFunction = (worldMatrix: Matrix, positionToUpdate: Vector3, _particle: Particle, isLocal: boolean) => {
-    const index = positionIndex;
-    positionIndex += 1;
-    const local = sampleDotPosition(index, scale);
-    if (isLocal) positionToUpdate.copyFrom(local);
-    else Vector3.TransformCoordinatesToRef(local, worldMatrix, positionToUpdate);
-  };
-  system.startDirectionFunction = (worldMatrix: Matrix, directionToUpdate: Vector3, _particle: Particle, isLocal: boolean) => {
-    const index = directionIndex;
-    directionIndex += 1;
-    const baseDirection = getEmitDirection(params);
-    const drift = Math.max(0, params.drift) * scale;
-    const speed = Math.max(0, params.riseSpeed) * scale * lerp(0.78, 1.18, sequence01(index, 1));
-    const direction = baseDirection
-      .scale(speed)
-      .addInPlace(new Vector3(
-        (sequence01(index, 0) - 0.5) * drift,
-        (sequence01(index, 3) - 0.5) * drift * 0.35,
-        (sequence01(index, 2) - 0.5) * drift,
-      ));
-    if (isLocal) directionToUpdate.copyFrom(direction);
-    else Vector3.TransformNormalToRef(direction, worldMatrix, directionToUpdate);
-  };
-
-  return system;
-}
-
-function readEmitMode(value: string): 'loop' | 'timed' {
-  return value === 'timed' || value === '自定义时间' ? 'timed' : 'loop';
-}
-
-function getEmitDirection(params: ResourceCollectSparklesParams): Vector3 {
-  const direction = new Vector3(params.directionX, params.directionY, params.directionZ);
-  if (direction.lengthSquared() < 0.0001) direction.set(0, 1, 0);
-  direction.normalize();
-  return direction;
-}
-
-function sampleDotPosition(index: number, scale: number): Vector3 {
-  const radius = Math.sqrt(sequence01(index, 0)) * 0.34 * scale;
-  const angle = sequence01(index, 1) * Math.PI * 2;
-  const y = sequence01(index, 2) * 0.018 * scale;
-  return new Vector3(Math.cos(angle) * radius, y, Math.sin(angle) * radius);
-}
-
-function getDotTexture(scene: Scene): DynamicTexture {
-  const key = '__vfx_resource_collect_dot_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('resource_collect_dot_texture', { width: 64, height: 64 }, scene, true);
-  const context = texture.getContext() as unknown as CanvasRenderingContext2D;
-  context.fillStyle = 'rgba(255, 255, 255, 0)';
-  context.fillRect(0, 0, 64, 64);
-  const dot = context.createRadialGradient(32, 32, 1, 32, 32, 30);
-  dot.addColorStop(0, 'rgba(255, 255, 255, 1)');
-  dot.addColorStop(0.64, 'rgba(255, 255, 255, 1)');
-  dot.addColorStop(0.84, 'rgba(255, 255, 255, 0.82)');
-  dot.addColorStop(1, 'rgba(255, 255, 255, 0)');
-  context.fillStyle = dot;
-  context.beginPath();
-  context.arc(32, 32, 30, 0, Math.PI * 2);
-  context.fill();
-  texture.hasAlpha = true;
-  texture.update(false);
-  metadata[key] = texture;
-  return texture;
-}
-
-function tintColor(color: VfxColorValue, brightness: number, alpha: number): Color4 {
-  return new Color4(
-    Math.max(0, color.r * brightness),
-    Math.max(0, color.g * brightness),
-    Math.max(0, color.b * brightness),
-    clamp01(alpha),
-  );
-}
-
-function lerp(min: number, max: number, t: number): number {
-  return min + (max - min) * t;
-}
-
-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);
-}

package/packages/effects/run-footstep-dust/assets/runtime/runFootstepDust.v1.js

@@ -1,215 +0,0 @@
-export const runtimeId = "runFootstepDust/v1";
-
-export const runtimeContract = {
-  runtimeId,
-  kind: "runFootstepDust",
-  fields: {
-    count: "Particles emitted per burst.",
-    frequency: "Dust burst frequency in bursts per second.",
-    particleColor: "Base particle tint as a #rrggbb color.",
-    spread: "Dust spawn jitter behind the character.",
-    effectScale: "Overall spatial scale for spawn spacing, particle size, speed, and gravity.",
-  },
-};
-
-function num(value, fallback = 0) {
-  const next = Number(value);
-  return Number.isFinite(next) ? next : fallback;
-}
-
-function fract(value) {
-  return value - Math.floor(value);
-}
-
-function sequence01(index, axis) {
-  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);
-}
-
-function readVec(BABYLON, value, fallback = new BABYLON.Vector3(1, 0, 0)) {
-  if (!value) return fallback;
-  return new BABYLON.Vector3(num(value.x, fallback.x), num(value.y, fallback.y), num(value.z, fallback.z));
-}
-
-function readColor(BABYLON, value, fallback = new BABYLON.Color4(0.78, 0.7, 0.54, 1)) {
-  if (typeof value === "string") {
-    const match = /^#?([0-9a-f]{6})$/i.exec(value);
-    if (match) {
-      const hex = match[1];
-      return new BABYLON.Color4(
-        parseInt(hex.slice(0, 2), 16) / 255,
-        parseInt(hex.slice(2, 4), 16) / 255,
-        parseInt(hex.slice(4, 6), 16) / 255,
-        1,
-      );
-    }
-  }
-  if (value && typeof value === "object") {
-    return new BABYLON.Color4(num(value.r, fallback.r), num(value.g, fallback.g), num(value.b, fallback.b), num(value.a, 1));
-  }
-  return fallback;
-}
-
-function tintColor(BABYLON, color, brightness, alpha) {
-  return new BABYLON.Color4(
-    Math.min(1, Math.max(0, color.r * brightness)),
-    Math.min(1, Math.max(0, color.g * brightness)),
-    Math.min(1, Math.max(0, color.b * brightness)),
-    alpha,
-  );
-}
-
-function makeTexture(BABYLON, scene) {
-  const texture = new BABYLON.DynamicTexture("runFootstepDustTexture", { width: 128, height: 128 }, scene, true);
-  const context = texture.getContext();
-  context.clearRect(0, 0, 128, 128);
-  for (const puff of [
-    { x: 48, y: 69, radius: 34, alpha: 0.72 },
-    { x: 70, y: 60, radius: 31, alpha: 0.64 },
-    { x: 86, y: 76, radius: 27, alpha: 0.5 },
-  ]) {
-    const shadow = context.createRadialGradient(puff.x, puff.y + 2, puff.radius * 0.22, puff.x, puff.y + 2, puff.radius + 5);
-    shadow.addColorStop(0, `rgba(86, 78, 64, ${puff.alpha * 0.22})`);
-    shadow.addColorStop(1, "rgba(86, 78, 64, 0)");
-    context.fillStyle = shadow;
-    context.beginPath();
-    context.arc(puff.x, puff.y + 2, puff.radius + 5, 0, Math.PI * 2);
-    context.fill();
-  }
-  for (const puff of [
-    { x: 48, y: 69, radius: 34, alpha: 0.72 },
-    { x: 70, y: 60, radius: 31, alpha: 0.64 },
-    { x: 86, y: 76, radius: 27, alpha: 0.5 },
-  ]) {
-    const core = context.createRadialGradient(puff.x, puff.y, puff.radius * 0.12, puff.x, puff.y, puff.radius);
-    core.addColorStop(0, `rgba(255, 255, 255, ${puff.alpha})`);
-    core.addColorStop(0.58, `rgba(235, 229, 210, ${puff.alpha * 0.52})`);
-    core.addColorStop(1, "rgba(220, 212, 188, 0)");
-    context.fillStyle = core;
-    context.beginPath();
-    context.arc(puff.x, puff.y, puff.radius, 0, Math.PI * 2);
-    context.fill();
-  }
-  texture.hasAlpha = true;
-  texture.update(false);
-  return texture;
-}
-
-export async function createRunFootstepDustRuntime({ BABYLON, scene, emitter, shouldStart = false }) {
-  if (!BABYLON) throw new Error("createRunFootstepDustRuntime requires BABYLON.");
-  if (!scene) throw new Error("createRunFootstepDustRuntime requires scene.");
-  if (!emitter) throw new Error("createRunFootstepDustRuntime requires emitter.");
-
-  const particlesPerStep = Math.max(0, Math.round(num(emitter.count ?? emitter.particleCount, 6)));
-  const effectScale = Math.max(0.01, num(emitter.effectScale, 1));
-  const spread = Math.max(0, num(emitter.spread, 0.3)) * effectScale;
-  const frequency = Math.max(0, num(emitter.frequency ?? emitter.stepFrequency, 4.5));
-  const lifeTime = Math.max(0.05, num(emitter.lifeTime ?? emitter.particleLifeTime, 0.42));
-  const particleSize = Math.max(0.001, num(emitter.particleSize, 0.18)) * effectScale;
-  const speed = Math.max(0, num(emitter.speed, 0.56)) * effectScale;
-  const trailOffset = Math.max(0, num(emitter.trailOffset, 0.22)) * effectScale;
-  const dustColor = readColor(BABYLON, emitter.particleColor);
-  const capacity = Math.max(48, Math.round(num(emitter.capacity, Math.ceil(particlesPerStep * Math.max(6, frequency * lifeTime * 3)))));
-  const movementDirection = readVec(BABYLON, emitter.emissionDirection, new BABYLON.Vector3(1, 0, 0));
-  movementDirection.y = 0;
-  if (movementDirection.lengthSquared() < 0.0001) movementDirection.set(1, 0, 0);
-  movementDirection.normalize();
-  const sideDirection = new BABYLON.Vector3(-movementDirection.z, 0, movementDirection.x);
-  const backwardDirection = movementDirection.scale(-1);
-  const system = new BABYLON.ParticleSystem(emitter.name || "run_footstep_dust", capacity, scene);
-
-  system.particleTexture = makeTexture(BABYLON, scene);
-  system.emitter = readVec(BABYLON, emitter.origin, BABYLON.Vector3.Zero());
-  system.emitRate = 0;
-  system.manualEmitCount = 0;
-  system.updateSpeed = 1 / 60;
-  system.minLifeTime = lifeTime;
-  system.maxLifeTime = lifeTime;
-  system.minSize = particleSize;
-  system.maxSize = particleSize;
-  system.minEmitPower = speed;
-  system.maxEmitPower = speed;
-  system.minAngularSpeed = 0;
-  system.maxAngularSpeed = 0;
-  system.gravity = readVec(BABYLON, emitter.gravity, new BABYLON.Vector3(0, -0.08, 0)).scale(effectScale);
-  system.blendMode = BABYLON.ParticleSystem.BLENDMODE_STANDARD;
-  system.color1 = tintColor(BABYLON, dustColor, 1.04, 0.58);
-  system.color2 = tintColor(BABYLON, dustColor, 0.78, 0.4);
-  system.colorDead = tintColor(BABYLON, dustColor, 0.52, 0);
-  system.addColorGradient(0, tintColor(BABYLON, dustColor, 1.04, 0));
-  system.addColorGradient(0.12, tintColor(BABYLON, dustColor, 1.04, 0.6));
-  system.addColorGradient(0.58, tintColor(BABYLON, dustColor, 0.86, 0.42));
-  system.addColorGradient(1, tintColor(BABYLON, dustColor, 0.58, 0));
-  system.addSizeGradient(0, particleSize * 0.5);
-  system.addSizeGradient(0.28, particleSize * 1.18);
-  system.addSizeGradient(0.72, particleSize * 1.65);
-  system.addSizeGradient(1, particleSize * 1.95);
-  system.addVelocityGradient(0, 1);
-  system.addVelocityGradient(0.35, 0.34);
-  system.addVelocityGradient(1, 0.03);
-  system.addDragGradient(0, 0.85);
-  system.addDragGradient(1, 1.9);
-
-  let positionIndex = 0;
-  let directionIndex = 0;
-  system.startPositionFunction = (worldMatrix, positionToUpdate, _particle, isLocal) => {
-    const index = positionIndex;
-    positionIndex += 1;
-    const sideJitter = (sequence01(index, 1) - 0.5) * spread * 0.55;
-    const backwardJitter = sequence01(index, 2) * spread * 0.75;
-    const lift = sequence01(index, 3) * 0.012 * effectScale;
-    const x = backwardDirection.x * (trailOffset + backwardJitter) + sideDirection.x * sideJitter;
-    const y = lift;
-    const z = backwardDirection.z * (trailOffset + backwardJitter) + sideDirection.z * sideJitter;
-    if (isLocal) positionToUpdate.set(x, y, z);
-    else BABYLON.Vector3.TransformCoordinatesFromFloatsToRef(x, y, z, worldMatrix, positionToUpdate);
-  };
-  system.startDirectionFunction = (worldMatrix, directionToUpdate, _particle, isLocal) => {
-    const index = directionIndex;
-    directionIndex += 1;
-    const backward = backwardDirection.scale(0.28 + sequence01(index, 4) * 0.26);
-    const sideways = sideDirection.scale((sequence01(index, 5) - 0.5) * 0.28);
-    const x = backward.x + sideways.x;
-    const y = 0.08 + sequence01(index, 6) * 0.1;
-    const z = backward.z + sideways.z;
-    if (isLocal) directionToUpdate.set(x, y, z);
-    else BABYLON.Vector3.TransformNormalFromFloatsToRef(x, y, z, worldMatrix, directionToUpdate);
-  };
-
-  let observer = null;
-  let timeToNextStep = 0;
-  const interval = frequency > 0 ? 1 / frequency : Number.POSITIVE_INFINITY;
-  const start = () => {
-    if (observer) return;
-    system.start();
-    observer = scene.onBeforeRenderObservable.add(() => {
-      if (particlesPerStep <= 0 || !Number.isFinite(interval)) return;
-      timeToNextStep -= scene.getEngine().getDeltaTime() / 1000;
-      while (timeToNextStep <= 0) {
-        system.manualEmitCount += particlesPerStep;
-        timeToNextStep += interval;
-      }
-    });
-  };
-
-  const preview = {
-    start,
-    stop: () => {
-      if (observer) scene.onBeforeRenderObservable.remove(observer);
-      observer = null;
-      system.stop();
-    },
-    dispose: () => {
-      if (observer) scene.onBeforeRenderObservable.remove(observer);
-      observer = null;
-      system.particleTexture?.dispose();
-      system.dispose();
-    },
-    isStarted: () => Boolean(observer),
-    duration: Math.max(1, lifeTime + 1 / Math.max(0.001, frequency)),
-    system,
-  };
-  if (shouldStart) preview.start();
-  return preview;
-}