@fps-games/vfx 0.1.1

package/packages/effects/lumber_vehicle_wood_chips/lumber_vehicle_wood_chips.json

@@ -0,0 +1,335 @@
+{
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "build.particle.lumber_vehicle_wood_chips",
+  "name": {
+    "en": "Lumber Vehicle Wood Chips",
+    "zh": "伐木车砍树碎屑"
+  },
+  "source": {
+    "engine": "babylon",
+    "engineVersion": "8.11.0",
+    "projectPath": "D:/project/loy-babylon-particle-test",
+    "rootAsset": "src/effects/lumberVehicleWoodChips.ts",
+    "sourceId": "loy-babylon-particle-test/lumberVehicleWoodChips",
+    "extractedAt": "2026-06-02T00:00:00.000Z",
+    "extractorVersion": "manual-babylon-solid-particle-package/0.2.0",
+    "canonicalSource": "local",
+    "legacyId": null,
+    "previousIds": []
+  },
+  "assets": {
+    "textures": [],
+    "materials": [],
+    "meshes": [],
+    "shaders": [],
+    "sounds": [],
+    "scripts": [
+      {
+        "kind": "script",
+        "id": "solid_particle_scatter_runtime",
+        "packagePath": "assets/runtime/solidParticleScatter.v1.js",
+        "runtimeId": "solidParticleScatter/v1",
+        "engine": "babylon",
+        "moduleFormat": "esm",
+        "exports": [
+          "createSolidParticleScatterRuntime",
+          "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.lumber_vehicle_wood_chips/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.lumber_vehicle_wood_chips/source/01-source-dump.json"
+      },
+      {
+        "kind": "raw",
+        "id": "lumber_vehicle_wood_chips_source_ts",
+        "packagePath": "source/src/effects/lumberVehicleWoodChips.ts",
+        "sourcePath": "D:/project/loy-babylon-particle-test/src/effects/lumberVehicleWoodChips.ts"
+      }
+    ]
+  },
+  "emitters": [
+    {
+      "name": "lumber_vehicle_wood_chips_main",
+      "sourceNodeName": "lumber_vehicle_wood_chips_main",
+      "enabled": true,
+      "deterministic": true,
+      "type": "SolidParticleSystem",
+      "billboard": false,
+      "primitive": {
+        "type": "splinter",
+        "width": 0.095,
+        "height": 0.007,
+        "depth": 0.018
+      },
+      "capacity": 120,
+      "count": 56,
+      "effectScale": 1,
+      "resourceScale": 0.72,
+      "spread": 0.42,
+      "duration": 0.42,
+      "speedScale": 1,
+      "intervalMs": 0,
+      "emissionDirection": {
+        "x": 0.92,
+        "y": 0.22,
+        "z": 0
+      },
+      "scatterMode": "radial",
+      "scatterGravity": 1.28,
+      "rotationStrength": 1.15,
+      "outwardAngleDegrees": 360,
+      "rotationCenter": "pieceCenter",
+      "origin": {
+        "x": 0,
+        "y": 0,
+        "z": 0
+      },
+      "material": {
+        "diffuseColor": {
+          "r": 0.74,
+          "g": 0.46,
+          "b": 0.22
+        },
+        "emissiveColor": {
+          "r": 0.035,
+          "g": 0.02,
+          "b": 0.008
+        }
+      },
+      "runtime": {
+        "stopAfterSeconds": 0.92,
+        "disposeOnComplete": true
+      }
+    }
+  ],
+  "runtime": {
+    "driver": "solidParticleScatter",
+    "defaultMesh": null,
+    "defaultOffset": {
+      "x": 0,
+      "y": 0,
+      "z": 0
+    },
+    "start": [
+      "Instantiate Babylon solid-particle runtime for lumber_vehicle_wood_chips"
+    ],
+    "update": [
+      "Apply Babylon tunable parameter overrides"
+    ],
+    "stop": [
+      "Stop and dispose runtime resources"
+    ],
+    "adapters": [
+      {
+        "id": "solidParticleScatter/v1",
+        "engine": "babylon",
+        "entry": "assets/runtime/solidParticleScatter.v1.js",
+        "moduleFormat": "esm",
+        "exports": [
+          "createSolidParticleScatterRuntime",
+          "runtimeContract"
+        ]
+      }
+    ]
+  },
+  "tunableParams": [
+    {
+      "key": "lumber_vehicle_wood_chips_main.count",
+      "labelZh": "木屑数量",
+      "type": "number",
+      "default": 56,
+      "min": 1,
+      "max": 120,
+      "step": 1,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "count",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.effectScale",
+      "labelZh": "整体缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.1,
+      "max": 8,
+      "step": 0.1,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "effectScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.resourceScale",
+      "labelZh": "木屑尺寸",
+      "type": "number",
+      "default": 0.72,
+      "min": 0.1,
+      "max": 3,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "resourceScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.spread",
+      "labelZh": "飞溅范围",
+      "type": "number",
+      "default": 0.42,
+      "min": 0,
+      "max": 2,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "spread",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.speedScale",
+      "labelZh": "飞溅速度",
+      "type": "number",
+      "default": 1,
+      "min": 0,
+      "max": 20,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "speedScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.duration",
+      "labelZh": "生命周期",
+      "type": "number",
+      "default": 0.42,
+      "min": 0.08,
+      "max": 3,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "duration",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.scatterGravity",
+      "labelZh": "下落重力",
+      "type": "number",
+      "default": 1.28,
+      "min": 0.01,
+      "max": 20,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "scatterGravity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.outwardAngleDegrees",
+      "labelZh": "炸开角度",
+      "type": "number",
+      "default": 360,
+      "min": 0,
+      "max": 360,
+      "step": 1,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "outwardAngleDegrees",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "lumber_vehicle_wood_chips_main.rotationStrength",
+      "labelZh": "旋转强度",
+      "type": "number",
+      "default": 1.15,
+      "min": 0,
+      "max": 6,
+      "step": 0.01,
+      "target": {
+        "emitter": "lumber_vehicle_wood_chips_main",
+        "property": "rotationStrength",
+        "operator": "set"
+      }
+    }
+  ],
+  "babylon": {
+    "driver": "solidParticleScatter",
+    "previewConfig": {
+      "textureUrl": null,
+      "emitterCount": 1,
+      "effectFile": "lumber_vehicle_wood_chips.json",
+      "normalizedVfx": "source/02-normalized-vfx.json"
+    }
+  },
+  "review": {
+    "status": "tweaked",
+    "artistNotes": [
+      "Single-emitter 3D wood chip spray for a lumber vehicle cutting a tree.",
+      "Uses SolidParticleSystem thin splinter chips, not camera-facing billboard sprites.",
+      "Adjusted for lumber_order style: warmer low-poly brown material, smaller chip geometry, tighter non-explosive spray."
+    ],
+    "approvedBy": null,
+    "approvedAt": null
+  },
+  "recording": {
+    "provider": "local-placeholder",
+    "recordedAt": "2026-06-02T00:00:00.000Z",
+    "mimeType": "image/png",
+    "durationSec": 0.92,
+    "fps": 0,
+    "media": {
+      "previewVideo": null,
+      "previewWebm": null,
+      "previewMp4": null,
+      "previewGif": null,
+      "thumbnail": "media/thumbnail.png",
+      "contactSheet": "media/contact-sheet.png",
+      "gcsUri": null
+    }
+  },
+  "search": {
+    "tags": [
+      "babylon",
+      "solid particle",
+      "3d wood chips",
+      "lumber vehicle",
+      "tree cutting",
+      "casual game",
+      "ua game"
+    ],
+    "descriptionEn": "A single-emitter burst of non-billboard 3D wood chips sprayed from a lumber vehicle cutter hitting a tree.",
+    "useCases": [
+      "lumber vehicle tree cutting",
+      "wood harvesting feedback",
+      "Tiles Survive playable ad"
+    ],
+    "negativeUseCases": [
+      "camera-facing sprite particles",
+      "dust cloud",
+      "large lumber chunks",
+      "fire",
+      "magic"
+    ]
+  },
+  "legacyIds": []
+}

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

@@ -0,0 +1,11 @@
+{
+  "lumber_vehicle_wood_chips_main.count": 5,
+  "lumber_vehicle_wood_chips_main.effectScale": 3.4,
+  "lumber_vehicle_wood_chips_main.resourceScale": 1,
+  "lumber_vehicle_wood_chips_main.spread": 0.5,
+  "lumber_vehicle_wood_chips_main.speedScale": 1.42,
+  "lumber_vehicle_wood_chips_main.duration": 0.7,
+  "lumber_vehicle_wood_chips_main.scatterGravity": 1.28,
+  "lumber_vehicle_wood_chips_main.outwardAngleDegrees": 360,
+  "lumber_vehicle_wood_chips_main.rotationStrength": 1.43
+}

package/packages/effects/monster-hit/index.ts

@@ -0,0 +1,128 @@
+// 怪物受击(移植自 axe_and_bear enemyHitBurst:闪光光条 + 红血粒子两套合一)。一次性 burst。
+// 闪光:BILLBOARDMODE_STRETCHED 拉伸光条 + ADD 加色(HDR 黄白→橙)。血:球体红粒子 + 标准混合 + 下落。
+// 贴图程序化生成(放射辉光 128 + 实心白圆 64),按场景缓存,无外部资产。参数分两段(闪光/血)。
+import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
+import { ParticleSystem } from '@babylonjs/core/Particles/particleSystem';
+import { DynamicTexture } from '@babylonjs/core/Materials/Textures/dynamicTexture';
+import { Color4 } from '@babylonjs/core/Maths/math.color';
+import { Vector3 } from '@babylonjs/core/Maths/math.vector';
+import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh';
+import type { Scene } from '@babylonjs/core/scene';
+import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
+
+interface MonsterHitParams extends VfxParamValues {
+  // 段1 闪光
+  flashCount: number; flashSize: number; flashLength: number; flashBright: number; flashColor: VfxColorValue;
+  // 段2 血
+  bloodCount: number; bloodSize: number; bloodGravity: number; bloodColor: VfxColorValue;
+  height: number;
+}
+
+const DEFAULT_PARAMS: MonsterHitParams = {
+  flashCount: 16, flashSize: 1, flashLength: 1, flashBright: 2, flashColor: { r: 1, g: 0.92, b: 0.5 },
+  bloodCount: 20, bloodSize: 0.3, bloodGravity: 6, bloodColor: { r: 1, g: 0, b: 0 },
+  height: 1.4,
+};
+
+// 程序化贴图(按场景缓存,随场景存活,不在 effect dispose 里销毁)
+interface HitTex { glow: DynamicTexture; circle: DynamicTexture; }
+const texCache = new WeakMap<Scene, HitTex>();
+function getTextures(scene: Scene): HitTex {
+  const cached = texCache.get(scene);
+  if (cached) return cached;
+  const glow = new DynamicTexture('vfx_mhit_glow', 128, scene, false); glow.hasAlpha = true;
+  const gc = glow.getContext(); gc.clearRect(0, 0, 128, 128);
+  const gg = gc.createRadialGradient(64, 64, 0, 64, 64, 64);
+  gg.addColorStop(0, 'rgba(255,255,255,1)'); gg.addColorStop(0.85, 'rgba(255,255,255,0.9)'); gg.addColorStop(1, 'rgba(255,255,255,0)');
+  gc.fillStyle = gg; gc.beginPath(); gc.arc(64, 64, 64, 0, Math.PI * 2); gc.fill(); glow.update();
+  const circle = new DynamicTexture('vfx_mhit_circle', 64, scene, false); circle.hasAlpha = true;
+  const cc = circle.getContext(); cc.clearRect(0, 0, 64, 64); cc.fillStyle = 'white'; cc.beginPath(); cc.arc(32, 32, 30, 0, Math.PI * 2); cc.fill(); circle.update();
+  const tex: HitTex = { glow, circle }; texCache.set(scene, tex); return tex;
+}
+
+function c4(c: VfxColorValue, m = 1, a = 1): Color4 { return new Color4(c.r * m, c.g * m, c.b * m, a); }
+
+export const monsterHitEffectPackage: VfxEffectPackage<MonsterHitParams> = {
+  id: 'monster-hit',
+  nameZh: '怪物受击',
+  debugAnchor: 'playerRight',
+  defaultParams: DEFAULT_PARAMS,
+  debugParams: [
+    // 段1 · 闪光
+    { key: 'flashCount', label: '闪光·数量', kind: 'number', min: 0, max: 40, step: 1 },
+    { key: 'flashSize', label: '闪光·尺寸', kind: 'scale', min: 0.2, max: 3, step: 0.05 },
+    { key: 'flashLength', label: '闪光·拉伸', kind: 'scale', min: 0.2, max: 3, step: 0.05 },
+    { key: 'flashBright', label: '闪光·亮度', kind: 'number', min: 0.5, max: 5, step: 0.05 },
+    { key: 'flashColor', label: '闪光·颜色', kind: 'color' },
+    // 段2 · 血
+    { key: 'bloodCount', label: '血·数量', kind: 'number', min: 0, max: 80, step: 1 },
+    { key: 'bloodSize', label: '血·大小', kind: 'number', min: 0.05, max: 1, step: 0.01 },
+    { key: 'bloodGravity', label: '血·重力', kind: 'number', min: 0, max: 20, step: 0.5 },
+    { key: 'bloodColor', label: '血·颜色', kind: 'color' },
+    // 通用
+    { key: 'height', label: '高度', kind: 'number', min: 0, max: 3, step: 0.1 },
+  ],
+
+  create({ scene, root, position, params }) {
+    root.position.copyFrom(position);
+    const { glow, circle } = getTextures(scene);
+    const emitter = new TransformNode('vfx_mhit_emitter', scene);
+    emitter.parent = root; emitter.position.set(0, params.height, 0);
+
+    // ── 段1 闪光:拉伸加色光条向外爆 ──────────────────────────────────────────────
+    const line = new ParticleSystem('vfx_mhit_lines', 120, scene);
+    line.emitter = emitter as unknown as AbstractMesh; line.minEmitBox = new Vector3(0, 0, 0); line.maxEmitBox = new Vector3(0, 0, 0);
+    line.billboardMode = ParticleSystem.BILLBOARDMODE_STRETCHED;
+    line.minLifeTime = 0.12; line.maxLifeTime = 0.25;
+    line.minEmitPower = 9.1; line.maxEmitPower = 15.6;
+    line.direction1 = new Vector3(-1, 0.05, -1); line.direction2 = new Vector3(1, 0.15, 1);
+    // 不要 isLocal=true:配 TransformNode 发射器时会发不出粒子(世界空间一次性 burst 即可)
+    line.gravity = new Vector3(0, 0, 0); line.emitRate = 0;
+    line.blendMode = ParticleSystem.BLENDMODE_ADD; line.particleTexture = glow;
+    line.minSize = 0.78 * params.flashSize; line.maxSize = 1.3 * params.flashSize;
+    line.minScaleY = 3.38 * params.flashLength; line.maxScaleY = 5.46 * params.flashLength;
+    line.minScaleX = 0.18 * params.flashSize; line.maxScaleX = 0.36 * params.flashSize;
+    const fb = params.flashBright;
+    line.addColorGradient(0.0, c4(params.flashColor, fb, 1));
+    line.addColorGradient(0.5, c4(params.flashColor, fb * 0.75, 1));
+    line.addColorGradient(1.0, c4(params.flashColor, fb * 0.5, 0));
+    line.manualEmitCount = Math.round(params.flashCount);
+
+    // ── 段2 血:球体红粒子向外溅 + 下落 ──────────────────────────────────────────
+    const blood = new ParticleSystem('vfx_mhit_blood', 220, scene);
+    blood.emitter = emitter as unknown as AbstractMesh; blood.minEmitBox = new Vector3(-0.05, -0.05, -0.05); blood.maxEmitBox = new Vector3(0.05, 0.05, 0.05);
+    blood.createSphereEmitter(0.2);
+    blood.billboardMode = ParticleSystem.BILLBOARDMODE_ALL;
+    blood.minLifeTime = 0.35; blood.maxLifeTime = 0.6;
+    blood.minEmitPower = 6; blood.maxEmitPower = 14;
+    blood.gravity = new Vector3(0, -params.bloodGravity, 0);
+    blood.emitRate = 0; blood.particleTexture = circle;
+    blood.blendMode = ParticleSystem.BLENDMODE_STANDARD;
+    blood.color1 = c4(params.bloodColor, 1, 1);
+    blood.color2 = new Color4(params.bloodColor.r * 0.8, params.bloodColor.g * 0.8 + 0.1, params.bloodColor.b * 0.8 + 0.1, 1);
+    blood.colorDead = c4(params.bloodColor, 0.3, 0.2);
+    blood.minSize = params.bloodSize * 1.5; blood.maxSize = params.bloodSize * 2.5;
+    blood.manualEmitCount = Math.round(params.bloodCount) + 10;
+
+    line.start(); blood.start();
+
+    let elapsed = 0, lineStopped = false, redStopped = false;
+    const observer = scene.onBeforeRenderObservable.add(() => {
+      elapsed += scene.getEngine().getDeltaTime();
+      if (!lineStopped && elapsed >= 180) { line.stop(); lineStopped = true; }
+      if (!redStopped && elapsed >= 200) { blood.stop(); redStopped = true; }
+    });
+
+    let disposed = false;
+    const disposeTimer = window.setTimeout(() => disposeAll(), 1000);
+    function disposeAll(): void {
+      if (disposed) return; disposed = true;
+      window.clearTimeout(disposeTimer);
+      scene.onBeforeRenderObservable.remove(observer);
+      // dispose(false):不销毁贴图!glow/circle 是场景级缓存的共享纹理,
+      // 默认 dispose() 会连贴图一起销毁,导致下次播放拿到死贴图 → 不显示。
+      line.dispose(false); blood.dispose(false); emitter.dispose(); root.dispose();
+    }
+    return { root, dispose() { disposeAll(); } };
+  },
+};

package/packages/effects/monster-hit/vfx-params.json

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

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

@@ -0,0 +1,6 @@
+{
+  "id": "player-upgrade",
+  "nameZh": "人物升级光效",
+  "source": "runtime-generated",
+  "assets": []
+}