@fps-games/vfx 0.1.1

package/packages/resource.particle.viscous_oil_suction/effect.json

@@ -0,0 +1,1254 @@
+{
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "resource.particle.viscous_oil_suction",
+  "name": {
+    "zh": "粘稠石油吸入",
+    "en": "Viscous Oil Suction"
+  },
+  "source": {
+    "engine": "cocos",
+    "engineVersion": "3.8.7",
+    "projectPath": "assets/ArtResources/Effect/GasTown_OilSuction",
+    "rootAsset": "assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab",
+    "sourceId": "29954e7e-d137-4c8b-a730-4f0320cbece8",
+    "extractedAt": "2026-05-21T12:28:45.255Z",
+    "extractorVersion": "normalized-vfx-to-babylon/0.1.0",
+    "canonicalSource": "gcs",
+    "sourceArchivePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos"
+  },
+  "assets": {
+    "textures": [
+      {
+        "kind": "texture",
+        "id": "glow_ad",
+        "packagePath": "assets/textures/Glow ad.png",
+        "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/Glow ad.png",
+        "sourceId": "dd44b0a9-0998-4c24-ba2e-d6ac9d1bebb7@6c48a",
+        "width": 512,
+        "height": 512
+      }
+    ],
+    "materials": [
+      {
+        "kind": "material",
+        "id": "asset",
+        "packagePath": "source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
+        "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
+        "sourceId": "4aabf2b0-1d20-4e13-9384-ae47eb8522aa"
+      }
+    ],
+    "shaders": [],
+    "meshes": [],
+    "sounds": [],
+    "scripts": [
+      {
+        "kind": "script",
+        "id": "particle_emitter_oil_suction_v1",
+        "packagePath": "assets/runtime/top_disk_suction/particleEmitter.v1.js",
+        "runtimeId": "particleEmitter/topDiskSuction/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": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/02-normalized-vfx.json"
+      },
+      {
+        "kind": "raw",
+        "id": "01-source-dump",
+        "packagePath": "source/01-source-dump.json",
+        "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/01-source-dump.json"
+      },
+      {
+        "kind": "raw",
+        "id": "asset",
+        "packagePath": "source/raw/吸石油.prefab",
+        "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab",
+        "sourceId": "29954e7e-d137-4c8b-a730-4f0320cbece8"
+      },
+      {
+        "kind": "raw",
+        "id": "asset.meta",
+        "packagePath": "source/raw/吸石油.prefab.meta",
+        "sourcePath": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source/cocos/assets/ArtResources/Effect/GasTown_OilSuction/吸石油.prefab.meta",
+        "sourceId": "29954e7e-d137-4c8b-a730-4f0320cbece8"
+      }
+    ]
+  },
+  "emitters": [
+    {
+      "name": "Particle",
+      "sourceNodeName": "Particle",
+      "enabled": true,
+      "blendMode": "STANDARD",
+      "particleTexturePath": "assets/textures/Glow ad.png",
+      "materialSourcePath": "assets/materials/石油.mtl",
+      "billboardMode": "BILLBOARDMODE_STRETCHED_LOCAL",
+      "stretchedBillboard": {
+        "velocityScale": 0,
+        "lengthScale": 2
+      },
+      "minScaleY": 1.81,
+      "maxScaleY": 2.51,
+      "capacity": 1000,
+      "manualEmitCount": 0,
+      "emitRate": 800,
+      "minSize": 1,
+      "maxSize": 1.245,
+      "minLifeTime": 0.6,
+      "maxLifeTime": 0.94,
+      "minEmitPower": 4.1,
+      "maxEmitPower": 7.1,
+      "updateSpeed": 0.01,
+      "gravity": {
+        "x": 0,
+        "y": 0,
+        "z": 0
+      },
+      "velocityOverLifetime": {
+        "axes": {
+          "x": [
+            {
+              "time": 0,
+              "value": 0
+            },
+            {
+              "time": 1,
+              "value": 0
+            }
+          ],
+          "y": [
+            {
+              "time": 0,
+              "value": 0
+            },
+            {
+              "time": 1,
+              "value": 0
+            }
+          ],
+          "z": [
+            {
+              "time": 0,
+              "value": -5
+            },
+            {
+              "time": 1,
+              "value": 0
+            }
+          ]
+        },
+        "speedModifier": {
+          "mode": "constant",
+          "min": 1,
+          "max": 1
+        },
+        "space": 0,
+        "axisRemap": "cocosLocalZToNegativeZ"
+      },
+      "transform": {
+        "position": {
+          "x": -0.037,
+          "y": 0,
+          "z": 0.671
+        },
+        "rotation": {
+          "x": 0,
+          "y": 0,
+          "z": 0
+        },
+        "scale": {
+          "x": 0.3,
+          "y": 0.3,
+          "z": 0.3
+        }
+      },
+      "shape": {
+        "sourceType": "Cone",
+        "sourceEnum": 2,
+        "radius": 2,
+        "radiusRange": 1,
+        "angle": 0.5235987755982988,
+        "length": 5,
+        "emitFrom": 3,
+        "type": "Cone",
+        "directionScale": -1,
+        "emitMode": "topDiskSuctionToTarget",
+        "preserveWorldShapeSize": true,
+        "direction1": {
+          "x": 0,
+          "y": 0,
+          "z": -1
+        },
+        "direction2": {
+          "x": 0,
+          "y": 0,
+          "z": -1
+        }
+      },
+      "topDiskSuction": {
+        "topDiskRadius": 3.02,
+        "topDiskRadiusRange": 1,
+        "suctionLength": 5
+      },
+      "renderColor": {
+        "color": {
+          "r": 0.08464436755094196,
+          "g": 0.12007689350249905,
+          "b": 0.1574778931180315,
+          "a": 1
+        },
+        "colorIntensity": 2,
+        "alphaIntensity": 2
+      },
+      "alphaKeys": [
+        {
+          "time": 0,
+          "alpha": 0
+        },
+        {
+          "time": 0.33,
+          "alpha": 1
+        },
+        {
+          "time": 1,
+          "alpha": 0
+        }
+      ],
+      "colorKeys": [],
+      "sizeKeys": [
+        {
+          "time": 0,
+          "size": 0.45
+        },
+        {
+          "time": 1,
+          "size": 0
+        }
+      ],
+      "runtime": {
+        "adapter": "particleEmitter/topDiskSuction/v1",
+        "stopAfterSeconds": 999999
+      },
+      "ui": {
+        "groups": [
+          {
+            "id": "topDiskSuction",
+            "title": "顶部圆盘吸附参数",
+            "hint": "专用控制 · 不改变通用 Cone 字段",
+            "mode": "controls",
+            "params": [
+              "topDiskSuction.topDiskRadius",
+              "topDiskSuction.topDiskRadiusRange",
+              "topDiskSuction.suctionLength"
+            ]
+          }
+        ],
+        "paramLabels": {
+          "topDiskSuction.topDiskRadius": "顶部圆盘半径",
+          "topDiskSuction.topDiskRadiusRange": "顶部圆盘采样范围",
+          "topDiskSuction.suctionLength": "吸附距离"
+        },
+        "paramTips": {
+          "topDiskSuction.topDiskRadius": "顶部圆盘吸附采样半径，只影响顶部出生圆盘，不改 Babylon Cone emitter.radius / 通用 gizmo。",
+          "topDiskSuction.topDiskRadiusRange": "顶部圆盘吸附采样范围。1=完整圆盘，越小越接近外圈；不改 Babylon Cone emitter.radiusRange。",
+          "topDiskSuction.suctionLength": "顶部圆盘到目标中心点距离，不改 Babylon Cone emitter.length / 通用 gizmo。"
+        }
+      },
+      "source": {
+        "simulationSpace": 1,
+        "renderMode": 1,
+        "velocityScale": 0,
+        "lengthScale": 2,
+        "alignSpace": 0,
+        "normalizedVfxEmitterId": "Particle"
+      },
+      "sourceMap": null,
+      "mapping": [
+        {
+          "cocos": "$[3]._capacity",
+          "babylon": "capacity"
+        },
+        {
+          "cocos": "$[3].rateOverTime",
+          "babylon": "emitRate"
+        },
+        {
+          "cocos": "$[3].bursts[0].count",
+          "babylon": "manualEmitCount"
+        },
+        {
+          "cocos": "$[3].startSize",
+          "babylon": "minSize/maxSize"
+        },
+        {
+          "cocos": "$[3].startLifetime",
+          "babylon": "minLifeTime/maxLifeTime"
+        },
+        {
+          "cocos": "$[3].startSpeed",
+          "babylon": "minEmitPower/maxEmitPower"
+        },
+        {
+          "cocos": "$[3].velocityOvertimeModule",
+          "babylon": "velocityOverLifetime"
+        },
+        {
+          "cocos": "$[3].rotationOverLifetime.z",
+          "babylon": "minAngularSpeed/maxAngularSpeed"
+        },
+        {
+          "cocos": "$[3].simulationSpeed",
+          "babylon": "updateSpeed"
+        },
+        {
+          "cocos": "$[3].gravityModifier",
+          "babylon": "gravity"
+        },
+        {
+          "cocos": "$[3]._renderMode",
+          "babylon": "billboardMode"
+        },
+        {
+          "cocos": "$[3]._velocityScale",
+          "babylon": "stretchedBillboard.velocityScale"
+        },
+        {
+          "cocos": "$[3]._lengthScale",
+          "babylon": "stretchedBillboard.lengthScale"
+        },
+        {
+          "cocos": "$[3]._velocityScale + $[3]._lengthScale + $[3].startSpeed",
+          "babylon": "minScaleY/maxScaleY"
+        },
+        {
+          "cocos": "$[3].startColor + material._props[0].tintColor",
+          "babylon": "renderColor.color + renderColor.colorIntensity/renderColor.alphaIntensity -> color1/color2/colorDead"
+        },
+        {
+          "cocos": "$[3]._shapeModule",
+          "babylon": "shape"
+        }
+      ],
+      "colorMapping": {
+        "renderFormula": "2.0 * startColor * materialTintColor * texture",
+        "multiplier": 2,
+        "alphaMultiplier": 2,
+        "cocosStartColor": {
+          "r": 0.16862745098039217,
+          "g": 0.23921568627450981,
+          "b": 0.3137254901960784,
+          "a": 1
+        },
+        "cocosMaterialTintColor": {
+          "r": 0.5019607843137255,
+          "g": 0.5019607843137255,
+          "b": 0.5019607843137255,
+          "a": 1
+        },
+        "renderColor": {
+          "r": 0.08464436755094196,
+          "g": 0.12007689350249905,
+          "b": 0.1574778931180315,
+          "a": 1
+        },
+        "babylonColor": {
+          "r": 0.1692887351018839,
+          "g": 0.2401537870049981,
+          "b": 0.314955786236063,
+          "a": 1
+        },
+        "babylonColorDead": {
+          "r": 0.1692887351018839,
+          "g": 0.2401537870049981,
+          "b": 0.314955786236063,
+          "a": 0
+        }
+      },
+      "cocosSource": {
+        "source": {
+          "engine": "cocos",
+          "componentIndex": 3,
+          "componentPath": "$[3]",
+          "nodeIndex": 2,
+          "rendererIndex": 61,
+          "componentType": "cc.ParticleSystem"
+        },
+        "lifecycle": {
+          "duration": 1,
+          "loop": true,
+          "playOnAwake": true,
+          "prewarm": false,
+          "simulationSpeed": 1,
+          "simulationSpace": 1
+        },
+        "transform": {
+          "position": {
+            "x": -0.037,
+            "y": 0,
+            "z": 0.671
+          },
+          "rotation": {
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "scale": {
+            "x": 0.3,
+            "y": 0.3,
+            "z": 0.3
+          }
+        },
+        "emission": {
+          "capacity": 1000,
+          "rateOverTime": 800,
+          "rateOverDistance": 0,
+          "bursts": []
+        },
+        "lifetime": {
+          "startLifetime": {
+            "mode": "twoConstants",
+            "min": 0.2,
+            "max": 0.5
+          },
+          "min": 0.2,
+          "max": 0.5
+        },
+        "size": {
+          "startSize": {
+            "mode": "twoConstants",
+            "min": 1,
+            "max": 3
+          },
+          "min": 1,
+          "max": 3,
+          "overLifetime": {
+            "enabled": true,
+            "keys": [
+              {
+                "time": 0,
+                "size": 0.5492424242424242
+              },
+              {
+                "time": 1,
+                "size": 0
+              }
+            ],
+            "separateAxes": false,
+            "axisKeys": null
+          }
+        },
+        "speed": {
+          "startSpeed": {
+            "mode": "twoConstants",
+            "min": -5,
+            "max": -10
+          },
+          "min": -10,
+          "max": -5
+        },
+        "velocity": {
+          "overLifetime": {
+            "enabled": true,
+            "axes": {
+              "x": [
+                {
+                  "time": 0,
+                  "value": 0
+                },
+                {
+                  "time": 1,
+                  "value": 0
+                }
+              ],
+              "y": [
+                {
+                  "time": 0,
+                  "value": 0
+                },
+                {
+                  "time": 1,
+                  "value": 0
+                }
+              ],
+              "z": [
+                {
+                  "time": 0,
+                  "value": 5
+                },
+                {
+                  "time": 1,
+                  "value": 0
+                }
+              ]
+            },
+            "speedModifier": {
+              "mode": "constant",
+              "min": 1,
+              "max": 1
+            },
+            "space": 0
+          }
+        },
+        "gravity": {
+          "modifier": 0,
+          "vector": {
+            "x": 0,
+            "y": 0,
+            "z": 0
+          }
+        },
+        "shape": {
+          "enabled": true,
+          "type": "Cone",
+          "sourceEnum": 2,
+          "radius": 2,
+          "radiusThickness": 1,
+          "angle": 0.5235987755982988,
+          "length": 5,
+          "emitFrom": 3,
+          "scale": {
+            "__type__": "cc.Vec3",
+            "x": 1,
+            "y": 1,
+            "z": 1
+          },
+          "position": {
+            "__type__": "cc.Vec3",
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "rotation": {
+            "__type__": "cc.Vec3",
+            "x": 0,
+            "y": 0,
+            "z": 0
+          },
+          "direction1": {
+            "x": 0,
+            "y": 0,
+            "z": -1
+          },
+          "direction2": {
+            "x": 0,
+            "y": 0,
+            "z": -1
+          }
+        },
+        "render": {
+          "mode": 1,
+          "velocityScale": 0,
+          "lengthScale": 2,
+          "alignSpace": 0,
+          "blendMode": "STANDARD",
+          "material": {
+            "uuid": "4aabf2b0-1d20-4e13-9384-ae47eb8522aa",
+            "path": "assets/ArtResources/Effect/GasTown_OilSuction/石油.mtl",
+            "techIdx": 1
+          },
+          "texture": {
+            "uuid": "dd44b0a9-0998-4c24-ba2e-d6ac9d1bebb7@6c48a",
+            "path": "assets/ArtResources/Effect/GasTown_OilSuction/Glow ad.png",
+            "width": 512,
+            "height": 512
+          },
+          "mesh": null,
+          "effectAsset": {
+            "uuid": "d1346436-ac96-4271-b863-1f4fdead95b0",
+            "name": "particles/builtin-particle",
+            "classification": "builtin-effect"
+          }
+        },
+        "color": {
+          "startColor": {
+            "r": 0.16862745098039217,
+            "g": 0.23921568627450981,
+            "b": 0.3137254901960784,
+            "a": 1
+          },
+          "materialTintColor": {
+            "r": 0.5019607843137255,
+            "g": 0.5019607843137255,
+            "b": 0.5019607843137255,
+            "a": 1
+          },
+          "renderFormula": "2.0 * startColor * materialTintColor * texture",
+          "overLifetime": {
+            "enabled": true,
+            "alphaKeys": [
+              {
+                "time": 0,
+                "alpha": 0
+              },
+              {
+                "time": 0.4788732394366197,
+                "alpha": 1
+              },
+              {
+                "time": 1,
+                "alpha": 0
+              }
+            ],
+            "colorKeys": []
+          }
+        },
+        "rotation": {
+          "overLifetime": {
+            "enabled": false,
+            "z": {
+              "mode": "constant",
+              "min": 0,
+              "max": 0
+            }
+          }
+        },
+        "modules": {
+          "colorOverLifetime": {
+            "enabled": true,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "sizeOvertime": {
+            "enabled": true,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "rotationOvertime": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "velocityOvertime": {
+            "enabled": true,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "forceOvertime": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "limitVelocityOvertime": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "textureAnimation": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "noise": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          },
+          "trail": {
+            "enabled": false,
+            "sourcePreservedIn": "source/02-normalized-vfx.json"
+          }
+        }
+      }
+    }
+  ],
+  "runtime": {
+    "space": "world",
+    "lifecycle": "sustained",
+    "anchor": {
+      "defaultBone": null,
+      "defaultMesh": null,
+      "defaultOffset": {
+        "x": 0,
+        "y": 1,
+        "z": 0
+      }
+    },
+    "start": [
+      "Instantiate Babylon particle systems from 03-effect.json emitters"
+    ],
+    "update": [
+      "Apply Babylon tunable parameter overrides"
+    ],
+    "stop": [
+      "Stop and dispose particle systems"
+    ],
+    "adapters": [
+      {
+        "id": "particleEmitter/topDiskSuction/v1",
+        "engine": "babylon",
+        "entry": "assets/runtime/top_disk_suction/particleEmitter.v1.js",
+        "moduleFormat": "esm",
+        "exports": [
+          "createParticleEmitterRuntime",
+          "runtimeContract"
+        ]
+      }
+    ]
+  },
+  "tunableParams": [
+    {
+      "key": "Particle.capacity",
+      "labelZh": "Particle 容量",
+      "type": "number",
+      "default": 1000,
+      "min": 1,
+      "max": 3000,
+      "step": 1,
+      "target": {
+        "emitter": "Particle",
+        "property": "capacity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.manualEmitCount",
+      "labelZh": "Particle 一次性爆发数量",
+      "type": "number",
+      "default": 0,
+      "min": 0,
+      "max": 100,
+      "step": 1,
+      "target": {
+        "emitter": "Particle",
+        "property": "manualEmitCount",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.emitRate",
+      "labelZh": "Particle 发射率",
+      "type": "number",
+      "default": 800,
+      "min": 0,
+      "max": 3200,
+      "step": 1,
+      "unit": "particles/s",
+      "target": {
+        "emitter": "Particle",
+        "property": "emitRate",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.minSize",
+      "labelZh": "Particle 最小尺寸",
+      "type": "number",
+      "default": 1,
+      "min": 0,
+      "max": 9,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "minSize",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.maxSize",
+      "labelZh": "Particle 最大尺寸",
+      "type": "number",
+      "default": 3,
+      "min": 0,
+      "max": 9,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "maxSize",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.minLifeTime",
+      "labelZh": "Particle 最小生命周期",
+      "type": "number",
+      "default": 0.2,
+      "min": 0,
+      "max": 2,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "Particle",
+        "property": "minLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.maxLifeTime",
+      "labelZh": "Particle 最大生命周期",
+      "type": "number",
+      "default": 0.5,
+      "min": 0,
+      "max": 2,
+      "step": 0.01,
+      "unit": "s",
+      "target": {
+        "emitter": "Particle",
+        "property": "maxLifeTime",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.minEmitPower",
+      "labelZh": "Particle 最小发射力",
+      "type": "number",
+      "default": 5,
+      "min": 0,
+      "max": 30,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "minEmitPower",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.maxEmitPower",
+      "labelZh": "Particle 最大发射力",
+      "type": "number",
+      "default": 10,
+      "min": 0,
+      "max": 30,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "maxEmitPower",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.updateSpeed",
+      "labelZh": "Particle 模拟步长",
+      "type": "number",
+      "default": 0.01,
+      "min": 0.0005,
+      "max": 0.04,
+      "step": 0.0005,
+      "target": {
+        "emitter": "Particle",
+        "property": "updateSpeed",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.runtime.stopAfterSeconds",
+      "labelZh": "Particle 播放时长",
+      "type": "number",
+      "default": 999999,
+      "min": 0.1,
+      "max": 10,
+      "step": 0.1,
+      "unit": "s",
+      "target": {
+        "emitter": "Particle",
+        "property": "runtime.stopAfterSeconds",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.gravity",
+      "labelZh": "Particle 重力",
+      "type": "vector3",
+      "default": {
+        "x": 0,
+        "y": 0,
+        "z": 0
+      },
+      "target": {
+        "emitter": "Particle",
+        "property": "gravity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.renderColor.color",
+      "labelZh": "Particle renderColor.color",
+      "type": "color",
+      "default": {
+        "r": 0.08464436755094196,
+        "g": 0.12007689350249905,
+        "b": 0.1574778931180315,
+        "a": 1
+      },
+      "target": {
+        "emitter": "Particle",
+        "property": "renderColor.color",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.renderColor.colorIntensity",
+      "labelZh": "Particle renderColor.colorIntensity",
+      "type": "number",
+      "default": 2,
+      "min": 0,
+      "max": 8,
+      "step": 0.05,
+      "target": {
+        "emitter": "Particle",
+        "property": "renderColor.colorIntensity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.renderColor.alphaIntensity",
+      "labelZh": "Particle renderColor.alphaIntensity",
+      "type": "number",
+      "default": 2,
+      "min": 0,
+      "max": 8,
+      "step": 0.05,
+      "target": {
+        "emitter": "Particle",
+        "property": "renderColor.alphaIntensity",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.shape.radius",
+      "labelZh": "Particle Cone 半径",
+      "type": "number",
+      "default": 2,
+      "min": 0.01,
+      "max": 10,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "shape.radius",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.shape.radiusRange",
+      "labelZh": "Particle Cone 半径范围",
+      "type": "number",
+      "default": 1,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "shape.radiusRange",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.shape.length",
+      "labelZh": "Particle Cone 高度",
+      "type": "number",
+      "default": 5,
+      "min": 0.01,
+      "max": 20,
+      "step": 0.05,
+      "target": {
+        "emitter": "Particle",
+        "property": "shape.length",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.topDiskSuction.topDiskRadius",
+      "labelZh": "Particle 顶部圆盘半径",
+      "type": "number",
+      "default": 2,
+      "min": 0.01,
+      "max": 10,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "topDiskSuction.topDiskRadius",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.topDiskSuction.topDiskRadiusRange",
+      "labelZh": "Particle 顶部圆盘采样范围",
+      "type": "number",
+      "default": 1,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "target": {
+        "emitter": "Particle",
+        "property": "topDiskSuction.topDiskRadiusRange",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.topDiskSuction.suctionLength",
+      "labelZh": "Particle 吸附距离",
+      "type": "number",
+      "default": 5,
+      "min": 0.01,
+      "max": 20,
+      "step": 0.05,
+      "target": {
+        "emitter": "Particle",
+        "property": "topDiskSuction.suctionLength",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "Particle.shape.type",
+      "labelZh": "Particle 发射器形状",
+      "type": "enum",
+      "default": "Cone",
+      "options": [
+        "Box",
+        "Sphere",
+        "Cone",
+        "SphereDirected",
+        "Hemisphere",
+        "Mesh",
+        "Unknown"
+      ],
+      "target": {
+        "emitter": "Particle",
+        "property": "shape.type",
+        "operator": "set"
+      }
+    }
+  ],
+  "babylon": {
+    "driver": "particle",
+    "entryFile": "assets/runtime/top_disk_suction/particleEmitter.v1.js",
+    "previewConfig": {
+      "textureUrl": "assets/textures/Glow ad.png",
+      "emitterCount": 1,
+      "effectFile": "effect.json",
+      "normalizedVfx": "source/02-normalized-vfx.json"
+    }
+  },
+  "review": {
+    "status": "tweaked",
+    "artistNotes": [
+      "Stage 3 auto-built from 02-normalized-vfx.json.",
+      "Needs Babylon visual review and Stage 4 tuning before approval."
+    ],
+    "approvedBy": null,
+    "approvedAt": null,
+    "history": [
+      {
+        "at": "2026-05-21T13:04:29.642Z",
+        "from": "auto",
+        "to": "tweaked",
+        "note": "Stage 4 static preview tuning."
+      }
+    ]
+  },
+  "recording": {
+    "provider": "browser-mediarecorder",
+    "recordedAt": "2026-05-21T13:04:30.575Z",
+    "mimeType": "video/webm;codecs=vp9",
+    "durationSec": 10,
+    "fps": 30,
+    "media": {
+      "previewVideo": "media/preview.webm",
+      "previewWebm": "media/preview.webm",
+      "previewMp4": "media/preview.mp4",
+      "previewGif": "media/preview.gif",
+      "thumbnail": "media/thumbnail.png",
+      "gcsUri": null
+    }
+  },
+  "aiDescription": {
+    "provider": "litellm",
+    "model": "gemini-3.1-pro-preview",
+    "generatedAt": "2026-05-21T13:30:34.263Z",
+    "summaryZh": "深色粘稠油滴从圆盘区域向中心点汇聚的吸入特效，适用于石油采集与管道抽取场景。",
+    "visualTags": [
+      "石油",
+      "oil",
+      "粘稠液体",
+      "viscous liquid",
+      "深色液滴",
+      "dark droplets",
+      "半透明",
+      "translucent",
+      "汇聚",
+      "converging",
+      "吸入",
+      "suction",
+      "锥形范围",
+      "cone shape",
+      "圆盘采样",
+      "disk emission",
+      "速度衰减",
+      "velocity decay",
+      "粒子流",
+      "particle stream",
+      "蓝灰色",
+      "blue-gray",
+      "动态吸附",
+      "dynamic absorption",
+      "抽取感",
+      "extraction feel",
+      "液体特效",
+      "liquid effect"
+    ],
+    "timeline": [
+      {
+        "timeStart": 0,
+        "timeEnd": 1.5,
+        "descriptionZh": "深色半透明油滴在较宽的圆盘区域持续生成，并快速向中心目标点汇聚，呈现出强烈的粘稠液体被吸入和抽取的动态效果。"
+      }
+    ],
+    "integrationHints": [
+      "锚点建议放置在吸入目标点（如管道口或收集器中心），以便油滴准确向该点汇聚。",
+      "调整 topDiskSuction.topDiskRadius 和 topDiskSuction.topDiskRadiusRange 参数，可控制油滴生成的圆盘区域大小。",
+      "调整 topDiskSuction.suctionLength 参数，可控制吸入的距离和整体锥形轨迹的长度。",
+      "特效使用 topDiskSuction 行为 runtime adapter，请确保在引擎中正确加载 particleEmitter/topDiskSuction/v1 以实现顶部圆盘到目标中心的采样路径。",
+      "粒子颜色目前偏蓝灰，可根据游戏内的光照环境或具体的液体材质（如纯黑原油、异星粘液）通过粒子颜色属性进行微调。"
+    ]
+  },
+  "search": {
+    "tags": [
+      "粘稠石油吸入",
+      "Viscous Oil Suction",
+      "石油",
+      "oil",
+      "粘稠液体",
+      "viscous liquid",
+      "深色液滴",
+      "dark droplets",
+      "半透明",
+      "translucent",
+      "汇聚",
+      "converging",
+      "吸入",
+      "suction",
+      "锥形范围",
+      "cone shape",
+      "圆盘采样",
+      "disk emission",
+      "速度衰减",
+      "velocity decay",
+      "粒子流",
+      "particle stream",
+      "蓝灰色",
+      "blue-gray",
+      "动态吸附",
+      "dynamic absorption",
+      "抽取感",
+      "extraction feel",
+      "液体特效",
+      "liquid effect",
+      "资源采集",
+      "resource gathering",
+      "加油小镇",
+      "gas town",
+      "抽油",
+      "oil pumping",
+      "管道吸入",
+      "pipeline suction",
+      "液体吸附",
+      "liquid absorption",
+      "收集特效",
+      "collection effect",
+      "工业设施",
+      "industrial facility",
+      "燃料补充",
+      "refueling",
+      "粘液",
+      "slime",
+      "吸收",
+      "absorb"
+    ],
+    "descriptionZh": "这是一款表现深色粘稠液体被吸入的粒子特效。大量半透明的深色油滴从较宽的圆盘区域生成，随后受吸力影响向一个中心目标点快速汇聚，整体呈现出锥形的吸附轨迹。特效内置了专用的采样模式与速度衰减逻辑，完美模拟了石油或粘稠液体被管道抽取、收集的物理感，非常适合用于资源采集、抽油机工作、加油站或工业管道吸入等游戏场景。",
+    "descriptionEn": "A particle effect showcasing the suction of dark, viscous liquid. Numerous translucent dark oil droplets spawn from a wide disk area and rapidly converge towards a central target point, forming a cone-shaped suction trajectory. With custom sampling modes and velocity decay logic, it perfectly simulates the physical sensation of oil or thick liquids being extracted or collected by pipelines. Highly suitable for resource gathering, oil pumping, gas stations, or industrial pipeline suction scenarios in games.",
+    "useCases": [
+      "加油小镇的抽油机工作特效",
+      "工业管道吸入粘稠液体",
+      "玩家收集石油资源的反馈特效",
+      "飞船或载具补充燃料时的吸附表现",
+      "击败泥怪/油怪后的核心物质吸收",
+      "场景中漏油回收的交互表现"
+    ],
+    "negativeUseCases": [
+      "清水或瀑布流淌场景",
+      "烟雾消散或爆炸扩散",
+      "火焰燃烧或魔法光束发射",
+      "干燥沙尘或碎石掉落"
+    ]
+  },
+  "gcsPrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction",
+  "sourceArchivePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/source",
+  "fullProvenancePrefix": "gs://fps-vfx-library/packages/resource.particle.viscous_oil_suction/provenance",
+  "nonStandard": {
+    "summaryZh": "此 package 包含非默认 Cocos->Babylon 行为 adapter：当前效果使用可复用的 topDiskSuction runtime adapter、emitter 参数和预览 UI。",
+    "items": [
+      {
+        "kind": "runtimeAdapter",
+        "id": "particleEmitter/topDiskSuction/v1",
+        "scope": "effect",
+        "adapter": "particleEmitter/topDiskSuction/v1",
+        "adapterEntry": "assets/runtime/top_disk_suction/particleEmitter.v1.js",
+        "affectedEmitters": [
+          "Particle"
+        ],
+        "summaryZh": "使用可复用 topDiskSuction ParticleEmitter adapter，而不是默认通用 particleEmitter/v1。",
+        "reasonZh": "原 Cocos 效果需要从顶部圆盘采样并吸附到中心点，Babylon 通用 Cone emitter 无法直接表达该出生点和方向组合。"
+      },
+      {
+        "kind": "emitterConfig",
+        "path": "emitters[].topDiskSuction",
+        "scope": "emitter",
+        "affectedEmitters": [
+          "Particle"
+        ],
+        "fields": [
+          "topDiskSuction.topDiskRadius",
+          "topDiskSuction.topDiskRadiusRange",
+          "topDiskSuction.suctionLength"
+        ],
+        "summaryZh": "新增 topDiskSuction 专用参数命名空间。",
+        "reasonZh": "避免把 shape.radius / shape.radiusRange / shape.length 这类已有通用语义的字段挪作专用业务控制。"
+      },
+      {
+        "kind": "previewUi",
+        "path": "emitters[].ui.groups[id=topDiskSuction]",
+        "scope": "emitter",
+        "affectedEmitters": [
+          "Particle"
+        ],
+        "fields": [
+          "ui.groups[].params",
+          "ui.paramLabels",
+          "ui.paramTips"
+        ],
+        "summaryZh": "预览面板通过 emitter.ui 声明顶部圆盘吸附参数。",
+        "reasonZh": "preview 页面按 03-effect.json 动态加载专用 UI，不需要把该效果写死在通用面板逻辑里。"
+      },
+      {
+        "kind": "runtimeMethodOverride",
+        "path": "tools/cocos/behavior-adapters/top_disk_suction/runtime/particleEmitter.v1.js -> assets/runtime/top_disk_suction/particleEmitter.v1.js",
+        "scope": "runtime",
+        "affectedEmitters": [
+          "Particle"
+        ],
+        "methods": [
+          "ParticleSystem.startPositionFunction",
+          "ParticleSystem.startDirectionFunction",
+          "ParticleSystem.updateFunction"
+        ],
+        "summaryZh": "专用 adapter 覆盖粒子出生位置、出生方向，并包装 updateFunction 叠加 Cocos VelocityOvertime。",
+        "reasonZh": "用于实现顶部圆盘随机出生、向底部中心吸附，以及生命周期内速度衰减。"
+      },
+      {
+        "kind": "shapeMode",
+        "path": "emitters[].shape.emitMode",
+        "scope": "emitter",
+        "affectedEmitters": [
+          "Particle"
+        ],
+        "fields": [
+          "shape.emitMode=topDiskSuctionToTarget",
+          "shape.preserveWorldShapeSize"
+        ],
+        "summaryZh": "Cone shape 使用专用采样模式标记。",
+        "reasonZh": "保留 shape.* 的通用含义，同时显式告诉 topDiskSuction adapter 使用顶部圆盘到目标中心点的采样路径。"
+      }
+    ]
+  }
+}