@fps-games/vfx 0.1.1

package/packages/effects/tree-leaf-chop-burst/effect.json

@@ -0,0 +1,498 @@
+{
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "build.particle.tree_leaf_chop_burst",
+  "name": {
+    "zh": "砍树树叶溅射",
+    "en": "Tree Leaf Chop Burst"
+  },
+  "source": {
+    "engine": "babylon",
+    "engineVersion": "8.56.2",
+    "projectPath": "D:/project/loy_babylon_particle_test",
+    "rootAsset": "src/effects/treeLeafChopBurst.ts",
+    "sourceId": "loy-babylon-particle-test/treeLeafChopBurst",
+    "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_leaf_chop_burst/source",
+    "legacyId": null,
+    "previousIds": []
+  },
+  "assets": {
+    "textures": [
+      {
+        "kind": "texture",
+        "id": "tree_leaf_chop_burst",
+        "packagePath": "assets/textures/tree_leaf_chop_burst_leaf_atlas.png",
+        "sourcePath": "D:/project/loy_babylon_particle_test/public/textures/particles/tree-leaf-chop-burst-leaf-atlas.png",
+        "sourceId": "generated-imagegen-leaf-atlas-alpha",
+        "width": 1024,
+        "height": 1024
+      }
+    ],
+    "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/source/02-normalized-vfx.json"
+      },
+      {
+        "kind": "raw",
+        "id": "01-source-dump",
+        "packagePath": "source/01-source-dump.json",
+        "sourcePath": "D:/project/loy_babylon_particle_test/source/01-source-dump.json"
+      },
+      {
+        "kind": "raw",
+        "id": "tree_leaf_chop_burst_source_ts",
+        "packagePath": "source/src/effects/treeLeafChopBurst.ts",
+        "sourcePath": "D:/project/loy_babylon_particle_test/src/effects/treeLeafChopBurst.ts"
+      },
+      {
+        "kind": "raw",
+        "id": "tree_leaf_chop_burst_source_texture",
+        "packagePath": "source/textures/tree-leaf-chop-burst-leaf-atlas-source.png",
+        "sourcePath": "D:/project/loy_babylon_particle_test/public/textures/particles/tree-leaf-chop-burst-leaf-atlas-source.png"
+      }
+    ]
+  },
+  "emitters": [
+    {
+      "name": "tree_leaf_chop_burst",
+      "sourceNodeName": "tree_leaf_chop_burst",
+      "enabled": true,
+      "deterministic": true,
+      "blendMode": "STANDARD",
+      "particleTexturePath": "assets/textures/tree_leaf_chop_burst_leaf_atlas.png",
+      "capacity": 100,
+      "manualEmitCount": 42,
+      "emitRate": 0,
+      "effectScale": 1,
+      "minSize": 0.21,
+      "maxSize": 0.21,
+      "minLifeTime": 0.775,
+      "maxLifeTime": 0.775,
+      "minEmitPower": 3.125,
+      "maxEmitPower": 3.125,
+      "updateSpeed": 0.016666666666666666,
+      "gravity": {
+        "x": 0,
+        "y": -3.8,
+        "z": 0
+      },
+      "shape": {
+        "sourceType": "Box",
+        "sourceEnum": 0,
+        "radius": 1,
+        "angle": 0,
+        "type": "Box",
+        "direction1": {
+          "x": -1.103,
+          "y": 0.55,
+          "z": -0.62
+        },
+        "direction2": {
+          "x": 0.943,
+          "y": 1.85,
+          "z": 0.62
+        },
+        "minEmitBox": {
+          "x": -0.08,
+          "y": 0.05,
+          "z": -0.08
+        },
+        "maxEmitBox": {
+          "x": 0.08,
+          "y": 0.18,
+          "z": 0.08
+        },
+        "radiusRange": 0
+      },
+      "spriteSheet": {
+        "enabled": true,
+        "cellWidth": 256,
+        "cellHeight": 256,
+        "startCellID": 0,
+        "endCellID": 15,
+        "cellChangeSpeed": 0,
+        "randomStartCell": false
+      },
+      "alphaKeys": [
+        {
+          "time": 0,
+          "alpha": 1
+        },
+        {
+          "time": 0.72,
+          "alpha": 1
+        },
+        {
+          "time": 1,
+          "alpha": 0
+        }
+      ],
+      "colorKeys": [
+        {
+          "time": 0,
+          "color": {
+            "r": 0.82,
+            "g": 1,
+            "b": 0.32,
+            "a": 1
+          }
+        },
+        {
+          "time": 1,
+          "color": {
+            "r": 0.54,
+            "g": 0.43,
+            "b": 0.12,
+            "a": 0
+          }
+        }
+      ],
+      "sizeKeys": [
+        {
+          "time": 0,
+          "size": 1
+        },
+        {
+          "time": 0.78,
+          "size": 0.92
+        },
+        {
+          "time": 1,
+          "size": 0.35
+        }
+      ],
+      "renderColor": {
+        "color": {
+          "r": 0.82,
+          "g": 1,
+          "b": 0.32,
+          "a": 1
+        },
+        "colorIntensity": 1,
+        "alphaIntensity": 1
+      },
+      "minInitialRotation": 0,
+      "maxInitialRotation": 0,
+      "minAngularSpeed": 0,
+      "maxAngularSpeed": 0,
+      "source": {
+        "simulationSpace": 1,
+        "renderMode": 0,
+        "alignSpace": 2,
+        "normalizedVfxEmitterId": "tree_leaf_chop_burst"
+      },
+      "sourceMap": null,
+      "mapping": [
+        {
+          "babylon": "ParticleSystem.manualEmitCount",
+          "source": "TreeLeafBurstOptions.particleCount"
+        },
+        {
+          "babylon": "ParticleSystem.minLifeTime/maxLifeTime",
+          "source": "TreeLeafBurstOptions.particleLifeTime"
+        },
+        {
+          "babylon": "ParticleSystem.direction1/direction2",
+          "source": "TreeLeafBurstOptions.emissionDirection + emissionDirectionSpread"
+        },
+        {
+          "babylon": "ParticleSystem.minEmitPower/maxEmitPower",
+          "source": "TreeLeafBurstOptions.minSpeed/maxSpeed"
+        },
+        {
+          "babylon": "ParticleSystem.minSize/maxSize + emitter box + power + gravity",
+          "source": "TreeLeafBurstOptions.effectScale"
+        }
+      ],
+      "runtime": {
+        "stopAfterSeconds": 1.25,
+        "disposeOnComplete": true
+      }
+    }
+  ],
+  "runtime": {
+    "driver": "particle",
+    "defaultMesh": null,
+    "defaultOffset": {
+      "x": 0,
+      "y": 1.4,
+      "z": 0
+    },
+    "start": [
+      "Instantiate Babylon runtime for tree_leaf_chop_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_leaf_chop_burst.manualEmitCount",
+      "labelZh": "粒子数量",
+      "type": "number",
+      "default": 42,
+      "min": 1,
+      "max": 160,
+      "step": 1,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "manualEmitCount",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.minLifeTime",
+      "labelZh": "最小寿命",
+      "type": "number",
+      "default": 0.5,
+      "min": 0.05,
+      "max": 4,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "minLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.maxLifeTime",
+      "labelZh": "最大寿命",
+      "type": "number",
+      "default": 1.05,
+      "min": 0.05,
+      "max": 4,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "maxLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.minEmitPower",
+      "labelZh": "最小发射速度",
+      "type": "number",
+      "default": 1.45,
+      "min": 0,
+      "max": 20,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "minEmitPower",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.maxEmitPower",
+      "labelZh": "最大发射速度",
+      "type": "number",
+      "default": 4.8,
+      "min": 0,
+      "max": 30,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "maxEmitPower",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.minSize",
+      "labelZh": "最小粒子大小",
+      "type": "number",
+      "default": 0.12,
+      "min": 0.01,
+      "max": 3,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "minSize",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.maxSize",
+      "labelZh": "最大粒子大小",
+      "type": "number",
+      "default": 0.3,
+      "min": 0.01,
+      "max": 4,
+      "step": 0.01,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "maxSize",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.effectScale",
+      "labelZh": "整体空间缩放",
+      "type": "number",
+      "default": 1,
+      "min": 0.1,
+      "max": 8,
+      "step": 0.1,
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "effectScale",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.shape.direction1",
+      "labelZh": "发射方向下界",
+      "type": "vector3",
+      "default": {
+        "x": -1.103,
+        "y": 0.55,
+        "z": -0.62
+      },
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "shape.direction1",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.shape.direction2",
+      "labelZh": "发射方向上界",
+      "type": "vector3",
+      "default": {
+        "x": 0.943,
+        "y": 1.85,
+        "z": 0.62
+      },
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "shape.direction2",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "tree_leaf_chop_burst.gravity",
+      "labelZh": "重力",
+      "type": "vector3",
+      "default": {
+        "x": 0,
+        "y": -3.8,
+        "z": 0
+      },
+      "target": {
+        "emitter": "tree_leaf_chop_burst",
+        "property": "gravity",
+        "operator": "set"
+      }
+    }
+  ],
+  "babylon": {
+    "driver": "particle",
+    "entryFile": "apps/vfx_asset_library/frontend/src/runtime/drivers/particleDriver.ts",
+    "previewConfig": {
+      "textureUrl": "assets/textures/tree_leaf_chop_burst_leaf_atlas.png",
+      "emitterCount": 1,
+      "effectFile": "tree_leaf_chop_burst.json",
+      "normalizedVfx": "source/02-normalized-vfx.json"
+    }
+  },
+  "review": {
+    "status": "tweaked",
+    "artistNotes": [
+      "Built from the local Babylon tree leaf burst prototype.",
+      "Includes a 4x4 transparent leaf spritesheet and spatial effectScale support."
+    ],
+    "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.25,
+    "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",
+      "leaf",
+      "chop",
+      "burst"
+    ],
+    "descriptionZh": "砍树命中时从树干附近喷出的手绘树叶粒子，带随机叶片 sprite、旋转、下落和短暂淡出。",
+    "descriptionEn": "Hand-painted leaf particles burst from the tree impact point with randomized leaf sprites, rotation, falling motion, and a short fade.",
+    "useCases": [
+      "tree chopping impact",
+      "wood gathering feedback",
+      "forest game hit effect"
+    ],
+    "negativeUseCases": [
+      "continuous foliage wind",
+      "heavy explosion",
+      "smoke-only dust"
+    ]
+  },
+  "legacyIds": [],
+  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.tree_leaf_chop_burst",
+  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.tree_leaf_chop_burst/source",
+  "fullProvenancePrefix": "gs://fps-vfx-library/packages/build.particle.tree_leaf_chop_burst/provenance"
+}