@fps-games/vfx 0.1.1

package/dist/effects/wood_peel_material_test/index.js

@@ -0,0 +1,157 @@
+import { c as createManifestRuntimeEffectPackage } from "../../chunks/manifestRuntimePackage-CXQFSTo2.js";
+const schemaVersion = "vfx-effect-package/1.0";
+const id = "build.material.wood_peel_material_test";
+const name = {
+  zh: "木材剥皮材质测试",
+  en: "Wood Peel Material Test"
+};
+const assets = {
+  textures: [],
+  materials: [],
+  meshes: [],
+  shaders: [],
+  sounds: [],
+  scripts: [
+    {
+      kind: "script",
+      id: "wood_peel_material_test_v1",
+      packagePath: "assets/runtime/woodPeelMaterialTest.v1.js",
+      runtimeId: "woodPeelMaterialTest/v1",
+      engine: "babylon",
+      moduleFormat: "esm",
+      exports: [
+        "createWoodPeelMaterialTestRuntime",
+        "runtimeContract"
+      ],
+      mimeType: "text/javascript"
+    }
+  ],
+  raw: []
+};
+const emitters = [
+  {
+    name: "wood_peel_material_test_main",
+    enabled: true,
+    type: "WoodPeelMaterialTest",
+    height: 1.55,
+    diameter: 0.42,
+    peelProgress: 0,
+    blendWidth: 0.08,
+    barkColor: {
+      r: 0.76,
+      g: 0.34,
+      b: 0.13,
+      a: 1
+    },
+    peeledColor: {
+      r: 0.98,
+      g: 0.79,
+      b: 0.43,
+      a: 1
+    },
+    runtime: {
+      adapter: "woodPeelMaterialTest/v1",
+      disposeOnComplete: false
+    }
+  }
+];
+const runtime = {
+  driver: "woodPeelMaterialTest",
+  adapters: [
+    {
+      id: "woodPeelMaterialTest/v1",
+      engine: "babylon",
+      entry: "assets/runtime/woodPeelMaterialTest.v1.js",
+      moduleFormat: "esm",
+      exports: [
+        "createWoodPeelMaterialTestRuntime",
+        "runtimeContract"
+      ]
+    }
+  ]
+};
+const debug = {
+  playAnchor: "playerRight",
+  livePreview: true
+};
+const tunableParams = [
+  {
+    key: "wood_peel_material_test.peelProgress",
+    labelZh: "剥皮进度",
+    type: "number",
+    "default": 0,
+    min: 0,
+    max: 1,
+    step: 0.01,
+    target: {
+      emitter: "wood_peel_material_test_main",
+      property: "peelProgress",
+      operator: "set"
+    }
+  },
+  {
+    key: "wood_peel_material_test.blendWidth",
+    labelZh: "柔边",
+    type: "number",
+    "default": 0.08,
+    min: 1e-3,
+    max: 0.35,
+    step: 5e-3,
+    target: {
+      emitter: "wood_peel_material_test_main",
+      property: "blendWidth",
+      operator: "set"
+    }
+  },
+  {
+    key: "wood_peel_material_test.barkColor",
+    labelZh: "带皮颜色",
+    type: "color",
+    "default": "#c25721",
+    target: {
+      emitter: "wood_peel_material_test_main",
+      property: "barkColor",
+      operator: "set"
+    }
+  },
+  {
+    key: "wood_peel_material_test.peeledColor",
+    labelZh: "去皮颜色",
+    type: "color",
+    "default": "#fac96d",
+    target: {
+      emitter: "wood_peel_material_test_main",
+      property: "peeledColor",
+      operator: "set"
+    }
+  }
+];
+const review = {
+  status: "draft",
+  artistNotes: [
+    "Runtime-only material preview for testing a 0-1 bottom-to-top bark peeling parameter.",
+    "This package does not change gameplay logic or scene.json static layout."
+  ]
+};
+const manifest = {
+  schemaVersion,
+  id,
+  name,
+  assets,
+  emitters,
+  runtime,
+  debug,
+  tunableParams,
+  review
+};
+const runtimeUrl = "data:text/javascript;base64,ZXhwb3J0IGNvbnN0IHJ1bnRpbWVDb250cmFjdCA9IHsKICBpZDogIndvb2RQZWVsTWF0ZXJpYWxUZXN0L3YxIiwKICBlbmdpbmU6ICJiYWJ5bG9uIiwKICBleHBvcnRzOiBbImNyZWF0ZVdvb2RQZWVsTWF0ZXJpYWxUZXN0UnVudGltZSJdLAp9OwoKY29uc3QgUFJFVklFV19ST09UX05BTUUgPSAidmZ4X3dvb2RfcGVlbF9tYXRlcmlhbF90ZXN0X3ByZXZpZXdfcm9vdCI7CgpmdW5jdGlvbiBjbGFtcDAxKHZhbHVlKSB7CiAgY29uc3QgbiA9IE51bWJlcih2YWx1ZSk7CiAgaWYgKCFOdW1iZXIuaXNGaW5pdGUobikpIHJldHVybiAwOwogIHJldHVybiBNYXRoLm1pbigxLCBNYXRoLm1heCgwLCBuKSk7Cn0KCmZ1bmN0aW9uIHJlYWROdW1iZXIodmFsdWUsIGZhbGxiYWNrKSB7CiAgY29uc3QgbiA9IE51bWJlcih2YWx1ZSk7CiAgcmV0dXJuIE51bWJlci5pc0Zpbml0ZShuKSA/IG4gOiBmYWxsYmFjazsKfQoKZnVuY3Rpb24gcmVhZENvbG9yKEJBQllMT04sIHZhbHVlLCBmYWxsYmFjaykgewogIGlmICh0eXBlb2YgdmFsdWUgPT09ICJzdHJpbmciICYmIC9eI1swLTlhLWZdezZ9JC9pLnRlc3QodmFsdWUpKSB7CiAgICByZXR1cm4gQkFCWUxPTi5Db2xvcjMuRnJvbUhleFN0cmluZyh2YWx1ZSk7CiAgfQogIGlmICh2YWx1ZSAmJiB0eXBlb2YgdmFsdWUgPT09ICJvYmplY3QiKSB7CiAgICBjb25zdCByID0gTnVtYmVyKHZhbHVlLnIpOwogICAgY29uc3QgZyA9IE51bWJlcih2YWx1ZS5nKTsKICAgIGNvbnN0IGIgPSBOdW1iZXIodmFsdWUuYik7CiAgICBpZiAoTnVtYmVyLmlzRmluaXRlKHIpICYmIE51bWJlci5pc0Zpbml0ZShnKSAmJiBOdW1iZXIuaXNGaW5pdGUoYikpIHsKICAgICAgcmV0dXJuIG5ldyBCQUJZTE9OLkNvbG9yMyhyLCBnLCBiKTsKICAgIH0KICB9CiAgcmV0dXJuIGZhbGxiYWNrLmNsb25lKCk7Cn0KCmZ1bmN0aW9uIGNyZWF0ZVdvb2RQZWVsUGJyQmxlbmRQbHVnaW4oQkFCWUxPTiwgbWF0ZXJpYWwsIG9wdGlvbnMpIHsKICBjbGFzcyBXb29kUGVlbFBickJsZW5kUGx1Z2luIGV4dGVuZHMgQkFCWUxPTi5NYXRlcmlhbFBsdWdpbkJhc2UgewogICAgY29uc3RydWN0b3IoKSB7CiAgICAgIHN1cGVyKG1hdGVyaWFsLCAiV29vZFBlZWxQYnJCbGVuZCIsIDIxMCwgeyBXT09EUEVFTF9QQlJfQkxFTkQ6IGZhbHNlIH0sIHRydWUsIHRydWUpOwogICAgICB0aGlzLnBlZWxQcm9ncmVzcyA9IGNsYW1wMDEob3B0aW9ucy5wZWVsUHJvZ3Jlc3MpOwogICAgfQoKICAgIGlzUmVhZHlGb3JTdWJNZXNoKCkgewogICAgICByZXR1cm4gdHJ1ZTsKICAgIH0KCiAgICBwcmVwYXJlRGVmaW5lcyhkZWZpbmVzKSB7CiAgICAgIGRlZmluZXMuV09PRFBFRUxfUEJSX0JMRU5EID0gdHJ1ZTsKICAgIH0KCiAgICBiaW5kRm9yU3ViTWVzaCh1bmlmb3JtQnVmZmVyKSB7CiAgICAgIHVuaWZvcm1CdWZmZXIudXBkYXRlRmxvYXQyKCJ3b29kUGVlbFByb2dyZXNzQmxlbmQiLCB0aGlzLnBlZWxQcm9ncmVzcywgTWF0aC5tYXgoMC4wMDEsIG9wdGlvbnMuYmxlbmRXaWR0aCkpOwogICAgICB1bmlmb3JtQnVmZmVyLnVwZGF0ZVZlY3RvcjMoIndvb2RQZWVsQXhpcyIsIG9wdGlvbnMuYXhpcyk7CiAgICAgIHVuaWZvcm1CdWZmZXIudXBkYXRlVmVjdG9yMygid29vZFBlZWxBeGlzQ2VudGVyIiwgb3B0aW9ucy5heGlzQ2VudGVyKTsKICAgICAgdW5pZm9ybUJ1ZmZlci51cGRhdGVGbG9hdCgid29vZFBlZWxMb2dMZW5ndGgiLCBvcHRpb25zLmxvZ0xlbmd0aCk7CiAgICAgIHVuaWZvcm1CdWZmZXIudXBkYXRlQ29sb3IzKCJ3b29kUGVlbEJhcmtDb2xvciIsIG9wdGlvbnMuYmFya0NvbG9yKTsKICAgICAgdW5pZm9ybUJ1ZmZlci51cGRhdGVDb2xvcjMoIndvb2RQZWVsUGVlbGVkQ29sb3IiLCBvcHRpb25zLnBlZWxlZENvbG9yKTsKICAgIH0KCiAgICBnZXRVbmlmb3JtcygpIHsKICAgICAgcmV0dXJuIHsKICAgICAgICB1Ym86IFsKICAgICAgICAgIHsgbmFtZTogIndvb2RQZWVsUHJvZ3Jlc3NCbGVuZCIsIHNpemU6IDIsIHR5cGU6ICJ2ZWMyIiB9LAogICAgICAgICAgeyBuYW1lOiAid29vZFBlZWxBeGlzIiwgc2l6ZTogMywgdHlwZTogInZlYzMiIH0sCiAgICAgICAgICB7IG5hbWU6ICJ3b29kUGVlbEF4aXNDZW50ZXIiLCBzaXplOiAzLCB0eXBlOiAidmVjMyIgfSwKICAgICAgICAgIHsgbmFtZTogIndvb2RQZWVsTG9nTGVuZ3RoIiwgc2l6ZTogMSwgdHlwZTogImZsb2F0IiB9LAogICAgICAgICAgeyBuYW1lOiAid29vZFBlZWxCYXJrQ29sb3IiLCBzaXplOiAzLCB0eXBlOiAidmVjMyIgfSwKICAgICAgICAgIHsgbmFtZTogIndvb2RQZWVsUGVlbGVkQ29sb3IiLCBzaXplOiAzLCB0eXBlOiAidmVjMyIgfSwKICAgICAgICBdLAogICAgICB9OwogICAgfQoKICAgIGdldEN1c3RvbUNvZGUoc2hhZGVyVHlwZSkgewogICAgICBpZiAoc2hhZGVyVHlwZSA9PT0gInZlcnRleCIpIHsKICAgICAgICByZXR1cm4gewogICAgICAgICAgQ1VTVE9NX1ZFUlRFWF9ERUZJTklUSU9OUzogYAogICAgICAgICAgICB2YXJ5aW5nIHZlYzMgdldvb2RQZWVsTG9jYWxQb3NpdGlvbjsKICAgICAgICAgIGAsCiAgICAgICAgICBDVVNUT01fVkVSVEVYX1VQREFURV9QT1NJVElPTjogYAogICAgICAgICAgICB2V29vZFBlZWxMb2NhbFBvc2l0aW9uID0gcG9zaXRpb25VcGRhdGVkOwogICAgICAgICAgYCwKICAgICAgICB9OwogICAgICB9CiAgICAgIGlmIChzaGFkZXJUeXBlICE9PSAiZnJhZ21lbnQiKSByZXR1cm4gbnVsbDsKICAgICAgcmV0dXJuIHsKICAgICAgICBDVVNUT01fRlJBR01FTlRfREVGSU5JVElPTlM6IGAKICAgICAgICAgIHZhcnlpbmcgdmVjMyB2V29vZFBlZWxMb2NhbFBvc2l0aW9uOwogICAgICAgIGAsCiAgICAgICAgQ1VTVE9NX0ZSQUdNRU5UX1VQREFURV9BTEJFRE86IGAKICAgICAgICAgIGZsb2F0IHdvb2RQZWVsQXhpc0Rpc3RhbmNlID0gZG90KHZXb29kUGVlbExvY2FsUG9zaXRpb24gLSB3b29kUGVlbEF4aXNDZW50ZXIsIG5vcm1hbGl6ZSh3b29kUGVlbEF4aXMpKTsKICAgICAgICAgIGZsb2F0IHdvb2RQZWVsTm9ybWFsaXplZEF4aXMgPSBjbGFtcCgod29vZFBlZWxBeGlzRGlzdGFuY2UgLyBtYXgod29vZFBlZWxMb2dMZW5ndGgsIDAuMDAwMSkpICsgMC41LCAwLjAsIDEuMCk7CiAgICAgICAgICBmbG9hdCB3b29kUGVlbFdpZHRoID0gbWF4KHdvb2RQZWVsUHJvZ3Jlc3NCbGVuZC55LCAwLjAwMSk7CiAgICAgICAgICBmbG9hdCB3b29kUGVlbEhlYWQgPSBtaXgoLXdvb2RQZWVsV2lkdGgsIDEuMCArIHdvb2RQZWVsV2lkdGgsIGNsYW1wKHdvb2RQZWVsUHJvZ3Jlc3NCbGVuZC54LCAwLjAsIDEuMCkpOwogICAgICAgICAgZmxvYXQgd29vZFBlZWxQZWVsZWQgPSAxLjAgLSBzbW9vdGhzdGVwKHdvb2RQZWVsSGVhZCAtIHdvb2RQZWVsV2lkdGgsIHdvb2RQZWVsSGVhZCwgd29vZFBlZWxOb3JtYWxpemVkQXhpcyk7CiAgICAgICAgICB2ZWMzIHdvb2RQZWVsQmFyayA9IHRvTGluZWFyU3BhY2Uod29vZFBlZWxCYXJrQ29sb3IpOwogICAgICAgICAgdmVjMyB3b29kUGVlbFBlZWxlZFdvb2QgPSB0b0xpbmVhclNwYWNlKHdvb2RQZWVsUGVlbGVkQ29sb3IpOwogICAgICAgICAgc3VyZmFjZUFsYmVkbyA9IG1peCh3b29kUGVlbEJhcmssIHdvb2RQZWVsUGVlbGVkV29vZCwgd29vZFBlZWxQZWVsZWQpOwogICAgICAgIGAsCiAgICAgIH07CiAgICB9CiAgfQoKICByZXR1cm4gbmV3IFdvb2RQZWVsUGJyQmxlbmRQbHVnaW4oKTsKfQoKZnVuY3Rpb24gY3JlYXRlTWF0ZXJpYWwoQkFCWUxPTiwgc2NlbmUsIGVtaXR0ZXIsIGhlaWdodCwgcm9vdFBvc2l0aW9uKSB7CiAgY29uc3QgbWF0ZXJpYWwgPSBuZXcgQkFCWUxPTi5QQlJNYXRlcmlhbCgKICAgICJ2Znhfd29vZF9wZWVsX21hdGVyaWFsX3Rlc3RfbWF0IiwKICAgIHNjZW5lCiAgKTsKICBtYXRlcmlhbC5hbGJlZG9Db2xvciA9IEJBQllMT04uQ29sb3IzLldoaXRlKCk7CiAgbWF0ZXJpYWwubWV0YWxsaWMgPSAwOwogIG1hdGVyaWFsLnJvdWdobmVzcyA9IDAuODI7CiAgbWF0ZXJpYWwuZW52aXJvbm1lbnRJbnRlbnNpdHkgPSAxOwogIG1hdGVyaWFsLnVzZVBoeXNpY2FsTGlnaHRGYWxsb2ZmID0gZmFsc2U7CiAgY29uc3QgcGx1Z2luID0gY3JlYXRlV29vZFBlZWxQYnJCbGVuZFBsdWdpbihCQUJZTE9OLCBtYXRlcmlhbCwgewogICAgcGVlbFByb2dyZXNzOiBlbWl0dGVyLnBlZWxQcm9ncmVzcywKICAgIGJsZW5kV2lkdGg6IE1hdGgubWF4KDAuMDAxLCByZWFkTnVtYmVyKGVtaXR0ZXIuYmxlbmRXaWR0aCwgMC4wOCkpLAogICAgYXhpczogbmV3IEJBQllMT04uVmVjdG9yMygwLCAxLCAwKSwKICAgIGF4aXNDZW50ZXI6IG5ldyBCQUJZTE9OLlZlY3RvcjMocm9vdFBvc2l0aW9uLngsIHJvb3RQb3NpdGlvbi55ICsgaGVpZ2h0ICogMC41LCByb290UG9zaXRpb24ueiksCiAgICBsb2dMZW5ndGg6IGhlaWdodCwKICAgIGJhcmtDb2xvcjogcmVhZENvbG9yKEJBQllMT04sIGVtaXR0ZXIuYmFya0NvbG9yLCBuZXcgQkFCWUxPTi5Db2xvcjMoMC43NiwgMC4zNCwgMC4xMykpLAogICAgcGVlbGVkQ29sb3I6IHJlYWRDb2xvcihCQUJZTE9OLCBlbWl0dGVyLnBlZWxlZENvbG9yLCBuZXcgQkFCWUxPTi5Db2xvcjMoMC45OCwgMC43OSwgMC40MykpLAogIH0pOwogIHJldHVybiB7IG1hdGVyaWFsLCBwbHVnaW4gfTsKfQoKZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGNyZWF0ZVdvb2RQZWVsTWF0ZXJpYWxUZXN0UnVudGltZSh7IEJBQllMT04sIHNjZW5lLCBlbWl0dGVyIH0pIHsKICBjb25zdCBwcmV2aW91cyA9IHNjZW5lLmdldFRyYW5zZm9ybU5vZGVCeU5hbWUoUFJFVklFV19ST09UX05BTUUpOwogIGlmIChwcmV2aW91cykgcHJldmlvdXMuZGlzcG9zZShmYWxzZSwgdHJ1ZSk7CgogIGNvbnN0IGhlaWdodCA9IE1hdGgubWF4KDAuMiwgcmVhZE51bWJlcihlbWl0dGVyLmhlaWdodCwgMS41NSkpOwogIGNvbnN0IGRpYW1ldGVyID0gTWF0aC5tYXgoMC4wNSwgcmVhZE51bWJlcihlbWl0dGVyLmRpYW1ldGVyLCAwLjQyKSk7CiAgY29uc3Qgb3JpZ2luID0gZW1pdHRlci5vcmlnaW4gJiYgdHlwZW9mIGVtaXR0ZXIub3JpZ2luID09PSAib2JqZWN0IgogICAgPyBlbWl0dGVyLm9yaWdpbgogICAgOiB7IHg6IDAsIHk6IDAsIHo6IDAgfTsKCiAgY29uc3Qgcm9vdCA9IG5ldyBCQUJZTE9OLlRyYW5zZm9ybU5vZGUoUFJFVklFV19ST09UX05BTUUsIHNjZW5lKTsKICByb290LnBvc2l0aW9uLnNldCgKICAgIHJlYWROdW1iZXIob3JpZ2luLngsIDApLAogICAgcmVhZE51bWJlcihvcmlnaW4ueSwgMC4wMiksCiAgICByZWFkTnVtYmVyKG9yaWdpbi56LCAwKQogICk7CgogIGNvbnN0IG1hdGVyaWFsSGFuZGxlID0gY3JlYXRlTWF0ZXJpYWwoQkFCWUxPTiwgc2NlbmUsIGVtaXR0ZXIsIGhlaWdodCwgcm9vdC5wb3NpdGlvbik7CiAgY29uc3QgbWF0ZXJpYWwgPSBtYXRlcmlhbEhhbmRsZS5tYXRlcmlhbDsKCiAgY29uc3QgbG9nID0gQkFCWUxPTi5NZXNoQnVpbGRlci5DcmVhdGVDeWxpbmRlcigKICAgICJ2Znhfd29vZF9wZWVsX21hdGVyaWFsX3Rlc3RfbG9nIiwKICAgIHsKICAgICAgaGVpZ2h0LAogICAgICBkaWFtZXRlciwKICAgICAgdGVzc2VsbGF0aW9uOiA0OCwKICAgICAgc3ViZGl2aXNpb25zOiAxMiwKICAgICAgY2FwOiBCQUJZTE9OLk1lc2guQ0FQX0FMTCwKICAgIH0sCiAgICBzY2VuZQogICk7CiAgbG9nLnBhcmVudCA9IHJvb3Q7CiAgbG9nLnBvc2l0aW9uLnkgPSBoZWlnaHQgKiAwLjU7CiAgbG9nLm1hdGVyaWFsID0gbWF0ZXJpYWw7CgogIGNvbnN0IGJhc2UgPSBCQUJZTE9OLk1lc2hCdWlsZGVyLkNyZWF0ZURpc2MoCiAgICAidmZ4X3dvb2RfcGVlbF9tYXRlcmlhbF90ZXN0X2Zsb29yX21hcmtlciIsCiAgICB7CiAgICAgIHJhZGl1czogZGlhbWV0ZXIgKiAwLjYyLAogICAgICB0ZXNzZWxsYXRpb246IDQ4LAogICAgfSwKICAgIHNjZW5lCiAgKTsKICBiYXNlLnBhcmVudCA9IHJvb3Q7CiAgYmFzZS5yb3RhdGlvbi54ID0gTWF0aC5QSSAqIDAuNTsKICBiYXNlLnBvc2l0aW9uLnkgPSAwLjAwNjsKCiAgY29uc3QgbWFya2VyTWF0ZXJpYWwgPSBuZXcgQkFCWUxPTi5TdGFuZGFyZE1hdGVyaWFsKCJ2Znhfd29vZF9wZWVsX21hdGVyaWFsX3Rlc3RfZmxvb3JfbWFya2VyX21hdCIsIHNjZW5lKTsKICBtYXJrZXJNYXRlcmlhbC5kaWZmdXNlQ29sb3IgPSBuZXcgQkFCWUxPTi5Db2xvcjMoMC4wOCwgMC4xMiwgMC4xMik7CiAgbWFya2VyTWF0ZXJpYWwuZW1pc3NpdmVDb2xvciA9IG5ldyBCQUJZTE9OLkNvbG9yMygwLjAyLCAwLjA1NSwgMC4wNDUpOwogIG1hcmtlck1hdGVyaWFsLmFscGhhID0gMC4zODsKICBtYXJrZXJNYXRlcmlhbC5iYWNrRmFjZUN1bGxpbmcgPSBmYWxzZTsKICBtYXJrZXJNYXRlcmlhbC50cmFuc3BhcmVuY3lNb2RlID0gQkFCWUxPTi5NYXRlcmlhbC5NQVRFUklBTF9BTFBIQUJMRU5EOwogIGJhc2UubWF0ZXJpYWwgPSBtYXJrZXJNYXRlcmlhbDsKCiAgcmV0dXJuIHsKICAgIHN0YXJ0KCkge30sCiAgICBzdG9wKCkgewogICAgICByb290LnNldEVuYWJsZWQoZmFsc2UpOwogICAgfSwKICAgIGRpc3Bvc2UoKSB7CiAgICAgIHJvb3QuZGlzcG9zZShmYWxzZSwgdHJ1ZSk7CiAgICAgIG1hdGVyaWFsLmRpc3Bvc2UoKTsKICAgICAgbWFya2VyTWF0ZXJpYWwuZGlzcG9zZSgpOwogICAgfSwKICAgIGlzU3RhcnRlZCgpIHsKICAgICAgcmV0dXJuIHJvb3QuaXNFbmFibGVkKCk7CiAgICB9LAogIH07Cn0K";
+const woodPeelMaterialTestEffectPackage = createManifestRuntimeEffectPackage({
+  id: "wood_peel_material_test",
+  manifest,
+  assetUrls: {
+    "assets/runtime/woodPeelMaterialTest.v1.js": runtimeUrl
+  }
+});
+export {
+  woodPeelMaterialTestEffectPackage
+};

package/dist/effects/wood_peel_material_test/wood_peel_material_test.json.d.ts

@@ -0,0 +1,139 @@
+declare const _default: {
+  "schemaVersion": "vfx-effect-package/1.0",
+  "id": "build.material.wood_peel_material_test",
+  "name": {
+    "zh": "木材剥皮材质测试",
+    "en": "Wood Peel Material Test"
+  },
+  "assets": {
+    "textures": [],
+    "materials": [],
+    "meshes": [],
+    "shaders": [],
+    "sounds": [],
+    "scripts": [
+      {
+        "kind": "script",
+        "id": "wood_peel_material_test_v1",
+        "packagePath": "assets/runtime/woodPeelMaterialTest.v1.js",
+        "runtimeId": "woodPeelMaterialTest/v1",
+        "engine": "babylon",
+        "moduleFormat": "esm",
+        "exports": [
+          "createWoodPeelMaterialTestRuntime",
+          "runtimeContract"
+        ],
+        "mimeType": "text/javascript"
+      }
+    ],
+    "raw": []
+  },
+  "emitters": [
+    {
+      "name": "wood_peel_material_test_main",
+      "enabled": true,
+      "type": "WoodPeelMaterialTest",
+      "height": 1.55,
+      "diameter": 0.42,
+      "peelProgress": 0,
+      "blendWidth": 0.08,
+      "barkColor": {
+        "r": 0.76,
+        "g": 0.34,
+        "b": 0.13,
+        "a": 1
+      },
+      "peeledColor": {
+        "r": 0.98,
+        "g": 0.79,
+        "b": 0.43,
+        "a": 1
+      },
+      "runtime": {
+        "adapter": "woodPeelMaterialTest/v1",
+        "disposeOnComplete": false
+      }
+    }
+  ],
+  "runtime": {
+    "driver": "woodPeelMaterialTest",
+    "adapters": [
+      {
+        "id": "woodPeelMaterialTest/v1",
+        "engine": "babylon",
+        "entry": "assets/runtime/woodPeelMaterialTest.v1.js",
+        "moduleFormat": "esm",
+        "exports": [
+          "createWoodPeelMaterialTestRuntime",
+          "runtimeContract"
+        ]
+      }
+    ]
+  },
+  "debug": {
+    "playAnchor": "playerRight",
+    "livePreview": true
+  },
+  "tunableParams": [
+    {
+      "key": "wood_peel_material_test.peelProgress",
+      "labelZh": "剥皮进度",
+      "type": "number",
+      "default": 0,
+      "min": 0,
+      "max": 1,
+      "step": 0.01,
+      "target": {
+        "emitter": "wood_peel_material_test_main",
+        "property": "peelProgress",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "wood_peel_material_test.blendWidth",
+      "labelZh": "柔边",
+      "type": "number",
+      "default": 0.08,
+      "min": 0.001,
+      "max": 0.35,
+      "step": 0.005,
+      "target": {
+        "emitter": "wood_peel_material_test_main",
+        "property": "blendWidth",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "wood_peel_material_test.barkColor",
+      "labelZh": "带皮颜色",
+      "type": "color",
+      "default": "#c25721",
+      "target": {
+        "emitter": "wood_peel_material_test_main",
+        "property": "barkColor",
+        "operator": "set"
+      }
+    },
+    {
+      "key": "wood_peel_material_test.peeledColor",
+      "labelZh": "去皮颜色",
+      "type": "color",
+      "default": "#fac96d",
+      "target": {
+        "emitter": "wood_peel_material_test_main",
+        "property": "peeledColor",
+        "operator": "set"
+      }
+    }
+  ],
+  "review": {
+    "status": "draft",
+    "artistNotes": [
+      "Runtime-only material preview for testing a 0-1 bottom-to-top bark peeling parameter.",
+      "This package does not change gameplay logic or scene.json static layout."
+    ]
+  }
+}
+;
+
+export default _default;

package/dist/generation.d.ts

@@ -0,0 +1,7 @@
+import { VfxParamValues } from './types';
+export declare const VFX_GENERATION_PARAM_KEYS: {
+    readonly offsetX: "__generation.offsetX";
+    readonly offsetY: "__generation.offsetY";
+    readonly offsetZ: "__generation.offsetZ";
+};
+export declare const VFX_DEFAULT_GENERATION_PARAMS: VfxParamValues;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types';
+export * from './generation';
+export * from './registry';
+export { VFX_RENDERING_GROUP_ID, configureVfxParticleSystem, configureVfxSpriteManager } from './rendering';
+export { EffectPackageService, type EffectPackageServiceOptions } from './EffectPackageService';
+export { SceneVfxService, type SceneVfxServiceOptions, type SceneVfxWarmupEntry } from './SceneVfxService';
+export { createManifestRuntimeEffectPackage, createManifestRuntimeEffectPackage as createDataDrivenEffectPackage, type ManifestRuntimeEffectPackageOptions, } from './manifestRuntimePackage';
+export * from './legacy-particle-runtime';

package/dist/index.js

@@ -0,0 +1,309 @@
+import { V, c, a } from "./chunks/rendering-CV3nhygX.js";
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+import { TransformNode } from "@babylonjs/core/Meshes/transformNode";
+import { c as c2, c as c3 } from "./chunks/manifestRuntimePackage-CXQFSTo2.js";
+import { c as c4, f, a as a2, s } from "./chunks/legacy-particle-runtime-CbJYVxdd.js";
+const VFX_GENERATION_PARAM_KEYS = {
+  offsetX: "__generation.offsetX",
+  offsetY: "__generation.offsetY",
+  offsetZ: "__generation.offsetZ"
+};
+const VFX_DEFAULT_GENERATION_PARAMS = {
+  [VFX_GENERATION_PARAM_KEYS.offsetX]: 0,
+  [VFX_GENERATION_PARAM_KEYS.offsetY]: 0,
+  [VFX_GENERATION_PARAM_KEYS.offsetZ]: 0
+};
+function isVfxEffectPackage(value) {
+  return !!value && typeof value === "object" && typeof value.id === "string" && typeof value.create === "function";
+}
+function pickPackage(mod) {
+  if (isVfxEffectPackage(mod.default)) {
+    return mod.default;
+  }
+  for (const value of Object.values(mod)) if (isVfxEffectPackage(value)) return value;
+  return null;
+}
+function dirOf(path) {
+  const m = path.match(/\/effects\/([^/]+)\//) ?? path.match(/^\.\/effects\/([^/]+)\//);
+  return m ? m[1] : path;
+}
+function sanitizeParamsFile(value) {
+  const v = value && typeof value === "object" && "default" in value ? value.default : value;
+  if (!v || typeof v !== "object" || Array.isArray(v)) return {};
+  const params = v.params;
+  if (params && typeof params === "object" && !Array.isArray(params)) return params;
+  return v;
+}
+function buildRegistry(input) {
+  const paramsByDir = {};
+  for (const [path, mod] of Object.entries(input.params ?? {})) {
+    paramsByDir[dirOf(path)] = sanitizeParamsFile(mod);
+  }
+  const map = /* @__PURE__ */ new Map();
+  const savedParams = {};
+  for (const [path, mod] of Object.entries(input.modules)) {
+    const dir = dirOf(path);
+    if (input.prod && input.isDebugOnly?.(dir)) continue;
+    const pkg = pickPackage(mod);
+    if (!pkg) {
+      console.warn("[vfx] no VfxEffectPackage export found in", path);
+      continue;
+    }
+    if (map.has(pkg.id)) {
+      throw new Error(`[vfx] duplicate effect id "${pkg.id}" (dir: ${dir})`);
+    }
+    const saved = paramsByDir[dir] ?? {};
+    pkg.savedParams = saved;
+    savedParams[pkg.id] = saved;
+    map.set(pkg.id, pkg);
+  }
+  const list = [...map.values()].sort((a3, b) => a3.id.localeCompare(b.id));
+  return {
+    getEffectPackage: (id) => map.get(id),
+    getEffectPackages: () => list,
+    savedParams
+  };
+}
+const DEFAULT_SPAWN_PARAM_KEYS = {
+  offsetX: VFX_GENERATION_PARAM_KEYS.offsetX,
+  offsetY: VFX_GENERATION_PARAM_KEYS.offsetY,
+  offsetZ: VFX_GENERATION_PARAM_KEYS.offsetZ
+};
+class EffectPackageService {
+  constructor(scene, options) {
+    this.activeHandles = /* @__PURE__ */ new Set();
+    this.scene = scene;
+    this.registry = options.registry;
+    this.getDebugAnchorPosition = options.getDebugAnchorPosition;
+    this.savedParams = cloneOverrideMap(options.registry.savedParams);
+  }
+  getEffectPackages() {
+    return this.registry.getEffectPackages();
+  }
+  getEffectPackage(effectId) {
+    return this.registry.getEffectPackage(effectId);
+  }
+  getMergedParams(effectId, explicitParams) {
+    const effectPackage = this.getEffectPackage(effectId);
+    if (!effectPackage) return null;
+    return mergeVfxParams(
+      VFX_DEFAULT_GENERATION_PARAMS,
+      effectPackage.defaultParams,
+      effectPackage.savedParams,
+      this.savedParams[effectId],
+      explicitParams
+    );
+  }
+  getDebugOverride(effectId) {
+    return cloneParams(this.savedParams[effectId]);
+  }
+  setDebugOverride(effectId, params) {
+    this.savedParams[effectId] = cloneParams(params);
+    const effectPackage = this.getEffectPackage(effectId);
+    if (effectPackage) effectPackage.savedParams = cloneParams(params);
+  }
+  playEffectPackage(effectId, explicitParams, spawnTransform) {
+    const effectPackage = this.getEffectPackage(effectId);
+    if (!effectPackage) {
+      console.warn(`[EffectPackageService] Unknown VFX effect package: ${effectId}`);
+      return null;
+    }
+    const params = this.getMergedParams(effectId, explicitParams);
+    if (!params) return null;
+    const spawn = this.resolveSpawnTransform(effectPackage, params, spawnTransform);
+    const runtimeParams = stripSpawnParams(params, effectPackage.spawnParams);
+    const root = new TransformNode(`vfx_package_${effectId}`, this.scene);
+    root.position.copyFrom(spawn.position);
+    root.rotation.y = spawn.rotationY;
+    let handle;
+    try {
+      handle = effectPackage.create({
+        scene: this.scene,
+        root,
+        position: spawn.position.clone(),
+        rotationY: spawn.rotationY,
+        renderingGroupId: spawn.renderingGroupId,
+        params: runtimeParams
+      });
+    } catch (error) {
+      console.warn(`[EffectPackageService] effect "${effectId}" create() failed; skipped.`, error);
+      try {
+        root.dispose();
+      } catch {
+      }
+      return null;
+    }
+    this.activeHandles.add(handle);
+    const originalDispose = handle.dispose.bind(handle);
+    handle.dispose = () => {
+      this.activeHandles.delete(handle);
+      originalDispose();
+    };
+    return handle;
+  }
+  dispose() {
+    for (const handle of this.activeHandles) {
+      handle.dispose();
+    }
+    this.activeHandles.clear();
+  }
+  resolveDebugPosition(effectPackage) {
+    const anchor = effectPackage.debugAnchor ?? "playerRight";
+    const anchorPosition = this.getDebugAnchorPosition?.(anchor);
+    if (anchorPosition) return anchorPosition.clone();
+    const cameraTarget = this.scene.activeCamera?.target;
+    if (cameraTarget?.clone) return cameraTarget.clone().addInPlace(new Vector3(1.2, 0, 0));
+    return new Vector3(0, 0, 0);
+  }
+  resolveSpawnTransform(effectPackage, params, spawnTransform) {
+    const normalized = normalizeSpawnTransform(spawnTransform);
+    const basePosition = normalized.position?.clone() ?? this.resolveDebugPosition(effectPackage);
+    const rotationY = readFiniteNumber(normalized.rotationY, 0);
+    const renderingGroupId = readOptionalFiniteNumber(normalized.renderingGroupId);
+    const offset = readSpawnOffset(params, effectPackage.spawnParams);
+    if (offset.lengthSquared() <= 1e-7) {
+      return { position: basePosition, rotationY, renderingGroupId };
+    }
+    const cos = Math.cos(rotationY);
+    const sin = Math.sin(rotationY);
+    return {
+      position: basePosition.addInPlace(new Vector3(
+        offset.x * cos - offset.z * sin,
+        offset.y,
+        offset.x * sin + offset.z * cos
+      )),
+      rotationY,
+      renderingGroupId
+    };
+  }
+}
+function normalizeSpawnTransform(spawnTransform) {
+  if (!spawnTransform) return {};
+  if (spawnTransform instanceof Vector3) return { position: spawnTransform };
+  return spawnTransform;
+}
+function readSpawnOffset(params, spawnParams) {
+  const keys = resolveSpawnParamKeys(spawnParams);
+  return new Vector3(
+    readParamNumber(params[keys.offsetX ?? ""], 0),
+    readParamNumber(params[keys.offsetY ?? ""], 0),
+    readParamNumber(params[keys.offsetZ ?? ""], 0)
+  );
+}
+function stripSpawnParams(params, spawnParams) {
+  const result = cloneParams(params);
+  const keys = resolveSpawnParamKeys(spawnParams);
+  for (const key of [keys.offsetX, keys.offsetY, keys.offsetZ]) {
+    if (key) delete result[key];
+  }
+  return result;
+}
+function resolveSpawnParamKeys(spawnParams) {
+  return spawnParams ?? DEFAULT_SPAWN_PARAM_KEYS;
+}
+function readParamNumber(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function readFiniteNumber(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function readOptionalFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function mergeVfxParams(...sources) {
+  const result = {};
+  for (const source of sources) {
+    Object.assign(result, cloneParams(source));
+  }
+  return result;
+}
+function cloneParams(value) {
+  if (!value) return {};
+  const result = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (item === void 0) continue;
+    result[key] = cloneParamValue(item);
+  }
+  return result;
+}
+function cloneOverrideMap(value) {
+  const result = {};
+  for (const [effectId, params] of Object.entries(value)) {
+    result[effectId] = cloneParams(params);
+  }
+  return result;
+}
+function cloneParamValue(value) {
+  if (isColorValue(value)) return { ...value };
+  return value;
+}
+function isColorValue(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value) && typeof value.r === "number" && typeof value.g === "number" && typeof value.b === "number";
+}
+class SceneVfxService {
+  constructor(scene, options) {
+    this.effectPackageService = new EffectPackageService(scene, {
+      registry: options.registry,
+      getDebugAnchorPosition: options.getDebugAnchorPosition
+    });
+  }
+  getEffectPackageService() {
+    return this.effectPackageService;
+  }
+  getEffectPackages() {
+    return this.effectPackageService.getEffectPackages();
+  }
+  getMergedParams(effectId, explicitParams) {
+    return this.effectPackageService.getMergedParams(effectId, explicitParams);
+  }
+  playEffectPackage(effectId, params = {}, spawnTransform) {
+    return this.effectPackageService.playEffectPackage(effectId, params, spawnTransform);
+  }
+  async warmupEffectPackages(entries) {
+    await Promise.all(entries.map((entry) => this.warmupEffectPackage(entry)));
+  }
+  async warmupEffectPackage(entry) {
+    let handle = null;
+    try {
+      handle = this.playEffectPackage(entry.effectId, entry.params ?? {}, entry.spawnTransform);
+      if (!handle) return;
+      await handle.ready;
+      await this.waitForAnimationFrames(2);
+    } catch (error) {
+      console.warn(`[SceneVfxService] Failed to warm up effect package "${entry.effectId}".`, error);
+    } finally {
+      handle?.dispose();
+    }
+  }
+  async waitForAnimationFrames(frameCount) {
+    for (let i = 0; i < frameCount; i += 1) {
+      await new Promise((resolve) => {
+        if (typeof requestAnimationFrame === "function") {
+          requestAnimationFrame(() => resolve());
+          return;
+        }
+        window.setTimeout(resolve, 0);
+      });
+    }
+  }
+  dispose() {
+    this.effectPackageService.dispose();
+  }
+}
+export {
+  EffectPackageService,
+  SceneVfxService,
+  VFX_DEFAULT_GENERATION_PARAMS,
+  VFX_GENERATION_PARAM_KEYS,
+  V as VFX_RENDERING_GROUP_ID,
+  buildRegistry,
+  c4 as cloneLegacyEmitters,
+  c as configureVfxParticleSystem,
+  a as configureVfxSpriteManager,
+  c2 as createDataDrivenEffectPackage,
+  c3 as createManifestRuntimeEffectPackage,
+  f as findEmitter,
+  isVfxEffectPackage,
+  a2 as setNestedValue,
+  s as startLegacyParticleRuntime
+};

package/dist/legacy-particle-runtime.d.ts

@@ -0,0 +1,30 @@
+import { ParticleSystem } from '@babylonjs/core/Particles/particleSystem';
+import { Scene } from '@babylonjs/core/scene';
+export interface LegacyParticleEmitterConfig {
+    name?: string;
+    runtime?: {
+        stopAfterSeconds?: number;
+        disposeOnComplete?: boolean;
+    };
+    [key: string]: unknown;
+}
+export interface LegacyParticlePreview {
+    start(): void;
+    stop(): void;
+    dispose(): void;
+    duration: number;
+    system: ParticleSystem;
+}
+export interface LegacyParticleRuntimeOptions {
+    scene: Scene;
+    runtimeUrl: string;
+    emitters: LegacyParticleEmitterConfig[];
+    assetUrls: Record<string, string>;
+    onError?: (error: unknown) => void;
+}
+export declare function startLegacyParticleRuntime(options: LegacyParticleRuntimeOptions): {
+    dispose(): void;
+};
+export declare function cloneLegacyEmitters(value: unknown): LegacyParticleEmitterConfig[];
+export declare function setNestedValue(target: Record<string, unknown>, path: string, value: unknown): void;
+export declare function findEmitter(emitters: LegacyParticleEmitterConfig[], name: string): LegacyParticleEmitterConfig | null;