@fps-games/vfx 0.1.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/CHANGELOG.md +115 -0
  2. package/README.md +41 -0
  3. package/dist/effects/coin-burst/index.js +6 -2
  4. package/dist/effects/comet-trail-flame/index.js +3 -1
  5. package/dist/effects/debris-smoke/index.js +1 -0
  6. package/dist/effects/electric-arc/index.js +1 -0
  7. package/dist/effects/energy-shield/index.js +1 -0
  8. package/dist/effects/explosion/index.js +3 -2
  9. package/dist/effects/hit-flash/index.js +12 -4
  10. package/dist/effects/laser-beam/index.js +14 -2
  11. package/dist/effects/lumber_vehicle_upgrade_aura/index.js +1 -0
  12. package/dist/effects/monster-hit/index.js +2 -1
  13. package/dist/effects/player-upgrade/index.js +5 -3
  14. package/dist/effects/pulse-laser-volley/index.js +14 -4
  15. package/dist/effects/thruster-flame/index.js +3 -1
  16. package/dist/effects/treasure-attention/index.d.ts +54 -0
  17. package/dist/effects/treasure-attention/index.js +535 -0
  18. package/dist/effects/ufo-thread-flame/index.js +1 -0
  19. package/dist/effects/vehicle-upgrade/index.js +4 -1
  20. package/dist/effects/weapon-trail/index.js +8 -3
  21. package/dist/effects/wood_crusher_sawdust/index.d.ts +4 -0
  22. package/dist/effects/wood_cutter_sawdust/index.d.ts +4 -0
  23. package/dist/index.js +85 -17
  24. package/dist/types.d.ts +80 -0
  25. package/index.json +19 -1
  26. package/package.json +9 -4
  27. package/packages/effects/treasure-attention/vfx-params.json +49 -0
  28. package/tooling/vfx-cli.mjs +8 -1
  29. package/docs/AUTHORING_EFFECTS.md +0 -297
  30. package/docs/VFX_LIBRARY_ARCHITECTURE_chatgpt.md +0 -1580
  31. package/docs/VFX_LIBRARY_EXECUTION_PLAN.md +0 -229
  32. package/docs/VFX_LIBRARY_PLAN.md +0 -546
  33. package/docs/vfx-ab/RESULTS.md +0 -35
  34. package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/after.png +0 -0
  35. package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/before.png +0 -0
  36. package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/after.png +0 -0
  37. package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/before.png +0 -0
  38. package/docs/vfx-integration_chatgpt.md +0 -462
  39. package/docs/weapon-trail-visualization.html +0 -241
  40. package/packages/EffectPackageService.ts +0 -240
  41. package/packages/SceneVfxService.ts +0 -96
  42. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/runtime/simpleMeshEffect.v1.js +0 -333
  43. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.frag.glsl +0 -25
  44. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.vert.glsl +0 -11
  45. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/textures/effect_jianbian.png +0 -0
  46. package/packages/build.mesh.yellow_build_upgrade_indicator/effect.json +0 -927
  47. package/packages/build.mesh.yellow_build_upgrade_indicator/media/contact-sheet.png +0 -0
  48. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.gif +0 -0
  49. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.mp4 +0 -0
  50. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.webm +0 -0
  51. package/packages/build.mesh.yellow_build_upgrade_indicator/media/thumbnail.png +0 -0
  52. package/packages/build.mesh.yellow_build_upgrade_indicator/metadata/description.json +0 -197
  53. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-effect.original.json +0 -895
  54. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-normalized-vfx-to-babylon-report.json +0 -241
  55. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-overrides.json +0 -542
  56. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-tuning-report.json +0 -69
  57. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/asset-map.json +0 -125
  58. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/lineage.json +0 -44
  59. package/packages/build.particle.golden_upgrade_starburst/assets/runtime/particleEmitter.v1.js +0 -210
  60. package/packages/build.particle.golden_upgrade_starburst/assets/textures/effect_guangdian.png +0 -0
  61. package/packages/build.particle.golden_upgrade_starburst/effect.json +0 -880
  62. package/packages/build.particle.golden_upgrade_starburst/media/contact-sheet.png +0 -0
  63. package/packages/build.particle.golden_upgrade_starburst/media/preview.gif +0 -0
  64. package/packages/build.particle.golden_upgrade_starburst/media/preview.mp4 +0 -0
  65. package/packages/build.particle.golden_upgrade_starburst/media/preview.webm +0 -0
  66. package/packages/build.particle.golden_upgrade_starburst/media/thumbnail.png +0 -0
  67. package/packages/build.particle.golden_upgrade_starburst/metadata/description.json +0 -161
  68. package/packages/build.particle.golden_upgrade_starburst/provenance/03-effect.original.json +0 -762
  69. package/packages/build.particle.golden_upgrade_starburst/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
  70. package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-overrides.json +0 -436
  71. package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-tuning-report.json +0 -40
  72. package/packages/build.particle.golden_upgrade_starburst/provenance/asset-map.json +0 -115
  73. package/packages/build.particle.golden_upgrade_starburst/provenance/lineage.json +0 -40
  74. package/packages/build.particle.orange_upgrade_transform_sparks/assets/runtime/particleEmitter.v1.js +0 -210
  75. package/packages/build.particle.orange_upgrade_transform_sparks/assets/textures/b5b27ab1-e740-4398-b407-848fc2b2c897.png +0 -0
  76. package/packages/build.particle.orange_upgrade_transform_sparks/effect.json +0 -887
  77. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.gif +0 -0
  78. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.mp4 +0 -0
  79. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.webm +0 -0
  80. package/packages/build.particle.orange_upgrade_transform_sparks/media/thumbnail.png +0 -0
  81. package/packages/build.particle.orange_upgrade_transform_sparks/metadata/description.json +0 -179
  82. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-effect.original.json +0 -859
  83. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
  84. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-overrides.json +0 -478
  85. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-tuning-report.json +0 -40
  86. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/asset-map.json +0 -114
  87. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/lineage.json +0 -41
  88. package/packages/build.particle.wood_chip_dust_burst/assets/runtime/particleEmitter.v1.js +0 -210
  89. package/packages/build.particle.wood_chip_dust_burst/assets/textures/effect_yanwu4.png +0 -0
  90. package/packages/build.particle.wood_chip_dust_burst/assets/textures/suipian3.png +0 -0
  91. package/packages/build.particle.wood_chip_dust_burst/effect.json +0 -1400
  92. package/packages/build.particle.wood_chip_dust_burst/media/contact-sheet.png +0 -0
  93. package/packages/build.particle.wood_chip_dust_burst/media/preview.gif +0 -0
  94. package/packages/build.particle.wood_chip_dust_burst/media/preview.mp4 +0 -0
  95. package/packages/build.particle.wood_chip_dust_burst/media/preview.webm +0 -0
  96. package/packages/build.particle.wood_chip_dust_burst/media/thumbnail.png +0 -0
  97. package/packages/build.particle.wood_chip_dust_burst/metadata/description.json +0 -173
  98. package/packages/build.particle.wood_chip_dust_burst/provenance/03-effect.original.json +0 -1277
  99. package/packages/build.particle.wood_chip_dust_burst/provenance/03-normalized-vfx-to-babylon-report.json +0 -329
  100. package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-overrides.json +0 -749
  101. package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-tuning-report.json +0 -60
  102. package/packages/build.particle.wood_chip_dust_burst/provenance/asset-map.json +0 -146
  103. package/packages/build.particle.wood_chip_dust_burst/provenance/lineage.json +0 -69
  104. package/packages/effects/building-upgrade/effect.json +0 -6
  105. package/packages/effects/building-upgrade/index.ts +0 -387
  106. package/packages/effects/character-entrance/effect.json +0 -6
  107. package/packages/effects/character-entrance/index.ts +0 -308
  108. package/packages/effects/coin-burst/index.ts +0 -43
  109. package/packages/effects/comet-trail-flame/assets/textures/trail_5x4.webp +0 -0
  110. package/packages/effects/comet-trail-flame/index.ts +0 -106
  111. package/packages/effects/conveyor-upgrade/effect.json +0 -6
  112. package/packages/effects/conveyor-upgrade/index.ts +0 -401
  113. package/packages/effects/debris-smoke/assets/models/rock_debris.glb +0 -0
  114. package/packages/effects/debris-smoke/assets/textures/smoke22.webp +0 -0
  115. package/packages/effects/debris-smoke/index.ts +0 -101
  116. package/packages/effects/door_open_gold_flakes/assets/runtime/goldFlakes.v1.js +0 -397
  117. package/packages/effects/door_open_gold_flakes/door_open_gold_flakes.json +0 -498
  118. package/packages/effects/door_open_gold_flakes/index.ts +0 -11
  119. package/packages/effects/electric-arc/assets/textures/spark_4x4.webp +0 -0
  120. package/packages/effects/electric-arc/index.ts +0 -62
  121. package/packages/effects/energy-shield/effect.json +0 -7
  122. package/packages/effects/energy-shield/index.ts +0 -431
  123. package/packages/effects/explosion/assets/textures/baozha29.webp +0 -0
  124. package/packages/effects/explosion/assets/textures/glow01.webp +0 -0
  125. package/packages/effects/explosion/assets/textures/lizi01.webp +0 -0
  126. package/packages/effects/explosion/assets/textures/xulie_lizibaozha02_5x5.webp +0 -0
  127. package/packages/effects/explosion/index.ts +0 -114
  128. package/packages/effects/ground-tile-upgrade/effect.json +0 -6
  129. package/packages/effects/ground-tile-upgrade/index.ts +0 -410
  130. package/packages/effects/hit-flash/index.ts +0 -69
  131. package/packages/effects/laser-beam/assets/textures/laser_glow.webp +0 -0
  132. package/packages/effects/laser-beam/assets/textures/laser_noise.webp +0 -0
  133. package/packages/effects/laser-beam/index.ts +0 -6
  134. package/packages/effects/laser-beam-factory.ts +0 -135
  135. package/packages/effects/lumber-cart-suction/effect.json +0 -6
  136. package/packages/effects/lumber-cart-suction/index.ts +0 -399
  137. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb +0 -0
  138. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/.active +0 -1
  139. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/1781589063890_upload.glb +0 -0
  140. package/packages/effects/lumber-debris-scatter/assets/runtime/solidParticleScatter.v1.js +0 -236
  141. package/packages/effects/lumber-debris-scatter/effect.json +0 -228
  142. package/packages/effects/lumber-debris-scatter/index.ts +0 -780
  143. package/packages/effects/lumber_vehicle_gear_spin/assets/runtime/gearSpin.v1.js +0 -202
  144. package/packages/effects/lumber_vehicle_gear_spin/index.ts +0 -11
  145. package/packages/effects/lumber_vehicle_gear_spin/lumber_vehicle_gear_spin.json +0 -338
  146. package/packages/effects/lumber_vehicle_upgrade_aura/assets/runtime/upgradeAura.v1.js +0 -353
  147. package/packages/effects/lumber_vehicle_upgrade_aura/index.ts +0 -11
  148. package/packages/effects/lumber_vehicle_upgrade_aura/lumber_vehicle_upgrade_aura.json +0 -365
  149. package/packages/effects/lumber_vehicle_wood_chips/assets/runtime/solidParticleScatter.v1.js +0 -310
  150. package/packages/effects/lumber_vehicle_wood_chips/index.ts +0 -11
  151. package/packages/effects/lumber_vehicle_wood_chips/lumber_vehicle_wood_chips.json +0 -335
  152. package/packages/effects/monster-hit/index.ts +0 -128
  153. package/packages/effects/player-upgrade/effect.json +0 -6
  154. package/packages/effects/player-upgrade/index.ts +0 -635
  155. package/packages/effects/pulse-laser-volley/assets/textures/bolt_guangshu.webp +0 -0
  156. package/packages/effects/pulse-laser-volley/index.ts +0 -204
  157. package/packages/effects/resource-collect-sparkles/effect.json +0 -6
  158. package/packages/effects/resource-collect-sparkles/index.ts +0 -254
  159. package/packages/effects/run-footstep-dust/assets/runtime/runFootstepDust.v1.js +0 -215
  160. package/packages/effects/run-footstep-dust/effect.json +0 -183
  161. package/packages/effects/run-footstep-dust/index.ts +0 -377
  162. package/packages/effects/space-shared.ts +0 -120
  163. package/packages/effects/thruster-flame/index.ts +0 -305
  164. package/packages/effects/tree-chop-dust/assets/textures/tree_chop_dust_atlas.png +0 -0
  165. package/packages/effects/tree-chop-dust/effect.json +0 -8
  166. package/packages/effects/tree-chop-dust/index.ts +0 -202
  167. package/packages/effects/tree-leaf-chop-burst/assets/runtime/particleEmitter.v1.js +0 -303
  168. package/packages/effects/tree-leaf-chop-burst/assets/textures/tree_leaf_chop_burst_leaf_atlas.png +0 -0
  169. package/packages/effects/tree-leaf-chop-burst/effect.json +0 -498
  170. package/packages/effects/tree-leaf-chop-burst/index.ts +0 -294
  171. package/packages/effects/tree_chop_dust_burst/assets/runtime/particleEmitter.v1.js +0 -318
  172. package/packages/effects/tree_chop_dust_burst/assets/textures/tree_chop_dust_burst_dust.png +0 -0
  173. package/packages/effects/tree_chop_dust_burst/index.ts +0 -13
  174. package/packages/effects/tree_chop_dust_burst/tree_chop_dust_burst.json +0 -412
  175. package/packages/effects/ufo-thread-flame/assets/textures/flame_flow.webp +0 -0
  176. package/packages/effects/ufo-thread-flame/assets/textures/flame_spike.webp +0 -0
  177. package/packages/effects/ufo-thread-flame/index.ts +0 -152
  178. package/packages/effects/vehicle-exhaust-smoke/assets/textures/vehicle_exhaust_smoke_atlas.png +0 -0
  179. package/packages/effects/vehicle-exhaust-smoke/effect.json +0 -8
  180. package/packages/effects/vehicle-exhaust-smoke/index.ts +0 -298
  181. package/packages/effects/vehicle-upgrade/effect.json +0 -6
  182. package/packages/effects/vehicle-upgrade/index.ts +0 -401
  183. package/packages/effects/weapon-trail/assets/textures/trail_wedge.png +0 -0
  184. package/packages/effects/weapon-trail/index.ts +0 -313
  185. package/packages/effects/wood-crusher-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
  186. package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
  187. package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
  188. package/packages/effects/wood-crusher-sawdust/index.ts +0 -43
  189. package/packages/effects/wood-crusher-sawdust/wood_crusher_sawdust.json +0 -592
  190. package/packages/effects/wood-cutter-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
  191. package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
  192. package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
  193. package/packages/effects/wood-cutter-sawdust/index.ts +0 -43
  194. package/packages/effects/wood-cutter-sawdust/wood_cutter_sawdust.json +0 -592
  195. package/packages/effects/wood-sawdust-effect-factory.ts +0 -194
  196. package/packages/effects/wood_crusher_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
  197. package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
  198. package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
  199. package/packages/effects/wood_crusher_sawdust/index.ts +0 -29
  200. package/packages/effects/wood_crusher_sawdust/wood_crusher_sawdust.json +0 -592
  201. package/packages/effects/wood_cutter_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
  202. package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
  203. package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
  204. package/packages/effects/wood_cutter_sawdust/index.ts +0 -29
  205. package/packages/effects/wood_cutter_sawdust/wood_cutter_sawdust.json +0 -592
  206. package/packages/effects/wood_peel_material_test/assets/runtime/woodPeelMaterialTest.v1.js +0 -196
  207. package/packages/effects/wood_peel_material_test/index.ts +0 -11
  208. package/packages/effects/wood_peel_material_test/wood_peel_material_test.json +0 -136
  209. package/packages/env.particle.forest_edge_fog/assets/runtime/particleEmitter.v1.js +0 -210
  210. package/packages/env.particle.forest_edge_fog/assets/textures/f12a23c4-b924-4322-a260-3d982428f1e8.png +0 -0
  211. package/packages/env.particle.forest_edge_fog/assets/textures/yuan.png +0 -0
  212. package/packages/env.particle.forest_edge_fog/effect.json +0 -854
  213. package/packages/env.particle.forest_edge_fog/media/preview.gif +0 -0
  214. package/packages/env.particle.forest_edge_fog/media/preview.mp4 +0 -0
  215. package/packages/env.particle.forest_edge_fog/media/preview.webm +0 -0
  216. package/packages/env.particle.forest_edge_fog/media/thumbnail.png +0 -0
  217. package/packages/env.particle.forest_edge_fog/metadata/description.json +0 -148
  218. package/packages/env.particle.forest_edge_fog/provenance/03-effect.original.json +0 -827
  219. package/packages/env.particle.forest_edge_fog/provenance/03-normalized-vfx-to-babylon-report.json +0 -196
  220. package/packages/env.particle.forest_edge_fog/provenance/04-preview-overrides.json +0 -432
  221. package/packages/env.particle.forest_edge_fog/provenance/04-preview-tuning-report.json +0 -28
  222. package/packages/env.particle.forest_edge_fog/provenance/asset-map.json +0 -124
  223. package/packages/env.particle.forest_edge_fog/provenance/lineage.json +0 -41
  224. package/packages/generation.ts +0 -14
  225. package/packages/index.ts +0 -14
  226. package/packages/legacy-particle-runtime.ts +0 -113
  227. package/packages/manifestRuntimePackage.ts +0 -519
  228. package/packages/registry.ts +0 -85
  229. package/packages/rendering.ts +0 -13
  230. package/packages/resource.particle.viscous_oil_suction/assets/runtime/top_disk_suction/particleEmitter.v1.js +0 -424
  231. package/packages/resource.particle.viscous_oil_suction/assets/textures/Glow ad.png +0 -0
  232. package/packages/resource.particle.viscous_oil_suction/effect.json +0 -1254
  233. package/packages/resource.particle.viscous_oil_suction/media/preview.gif +0 -0
  234. package/packages/resource.particle.viscous_oil_suction/media/preview.mp4 +0 -0
  235. package/packages/resource.particle.viscous_oil_suction/media/preview.webm +0 -0
  236. package/packages/resource.particle.viscous_oil_suction/media/thumbnail.png +0 -0
  237. package/packages/resource.particle.viscous_oil_suction/metadata/description.json +0 -122
  238. package/packages/resource.particle.viscous_oil_suction/provenance/03-effect.original.json +0 -1051
  239. package/packages/resource.particle.viscous_oil_suction/provenance/03-normalized-vfx-to-babylon-report.json +0 -200
  240. package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-overrides.json +0 -581
  241. package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-tuning-report.json +0 -28
  242. package/packages/resource.particle.viscous_oil_suction/provenance/asset-map.json +0 -111
  243. package/packages/resource.particle.viscous_oil_suction/provenance/lineage.json +0 -45
  244. package/packages/types.ts +0 -107
  245. package/tooling/check-dist-runtime.mjs +0 -166
  246. package/tooling/generate-index.mjs +0 -55
  247. package/tooling/test-guardrails.mjs +0 -157
  248. package/tooling/validate-boundary.mjs +0 -92
  249. package/tooling/validate-effects.mjs +0 -304
  250. package/tooling/validate.mjs +0 -53
@@ -1,397 +0,0 @@
1
- export const runtimeId = "goldFlakes/v1";
2
-
3
- export const runtimeContract = {
4
- runtimeId,
5
- kind: "goldFlakes",
6
- emitterFields: {
7
- origin: "World-space center of the gold flake field.",
8
- duration: "Total effect lifetime in seconds.",
9
- flakeCount: "Number of rising gold flakes.",
10
- areaRadius: "Horizontal distribution radius.",
11
- riseHeight: "Vertical travel height during lifetime.",
12
- flakeColor: "Gold flake color.",
13
- lightRayCount: "Number of rising light sheets.",
14
- glowColor: "Door opening light sheet color.",
15
- },
16
- };
17
-
18
- function num(value, fallback = 0) {
19
- const next = Number(value);
20
- return Number.isFinite(next) ? next : fallback;
21
- }
22
-
23
- function readVec(BABYLON, value, fallback = new BABYLON.Vector3(0, 0, 0)) {
24
- if (!value) return fallback.clone ? fallback.clone() : fallback;
25
- return new BABYLON.Vector3(num(value.x, fallback.x), num(value.y, fallback.y), num(value.z, fallback.z));
26
- }
27
-
28
- function readColor3(BABYLON, value, fallback = new BABYLON.Color3(1, 0.78, 0.18)) {
29
- if (typeof value === "string" && /^#[0-9a-f]{6}$/i.test(value)) {
30
- return new BABYLON.Color3(
31
- parseInt(value.slice(1, 3), 16) / 255,
32
- parseInt(value.slice(3, 5), 16) / 255,
33
- parseInt(value.slice(5, 7), 16) / 255
34
- );
35
- }
36
- if (!value) return fallback;
37
- return new BABYLON.Color3(num(value.r, fallback.r), num(value.g, fallback.g), num(value.b, fallback.b));
38
- }
39
-
40
- function colorByte(value) {
41
- return Math.max(0, Math.min(255, Math.round(num(value, 1) * 255)));
42
- }
43
-
44
- function scaleColor(BABYLON, color, intensity) {
45
- const next = color.clone ? color.clone() : new BABYLON.Color3(color.r, color.g, color.b);
46
- return next.scale(Math.max(0, num(intensity, 1)));
47
- }
48
-
49
- function sequence01(index, axis) {
50
- const strides = [0.618033988749895, 0.414213562373095, 0.732050807568877, 0.324717957244746];
51
- return (0.5 + index * strides[axis % strides.length] + axis * 0.173205080756888) % 1;
52
- }
53
-
54
- function createFlakeTexture(BABYLON, scene) {
55
- const width = 48;
56
- const height = 96;
57
- const texture = new BABYLON.DynamicTexture("vfx_door_gold_flake_texture", { width, height }, scene, false);
58
- texture.hasAlpha = true;
59
- const ctx = texture.getContext();
60
- const image = ctx.createImageData(width, height);
61
- const data = image.data;
62
-
63
- for (let y = 0; y < height; y += 1) {
64
- const v = y / Math.max(1, height - 1);
65
- for (let x = 0; x < width; x += 1) {
66
- const u = x / Math.max(1, width - 1);
67
- const edgeX = Math.min(u, 1 - u) * 2;
68
- const edgeY = Math.min(v, 1 - v) * 2;
69
- const alpha = Math.pow(Math.max(0, Math.min(edgeX * 1.4, edgeY * 1.7, 1)), 0.7);
70
- const center = 0.72 + Math.max(0, 1 - Math.abs(u - 0.5) * 2) * 0.28;
71
- const offset = (y * width + x) * 4;
72
- data[offset] = Math.round(255 * center);
73
- data[offset + 1] = Math.round(255 * center);
74
- data[offset + 2] = Math.round(255 * center);
75
- data[offset + 3] = Math.round(alpha * 255);
76
- }
77
- }
78
-
79
- ctx.putImageData(image, 0, 0);
80
- texture.update(false);
81
- return texture;
82
- }
83
-
84
- function createLightRayTexture(BABYLON, scene, color) {
85
- const width = 96;
86
- const height = 256;
87
- const texture = new BABYLON.DynamicTexture("vfx_door_light_ray_texture", { width, height }, scene, false);
88
- texture.hasAlpha = true;
89
- const ctx = texture.getContext();
90
- const image = ctx.createImageData(width, height);
91
- const data = image.data;
92
-
93
- for (let y = 0; y < height; y += 1) {
94
- const v = y / Math.max(1, height - 1);
95
- for (let x = 0; x < width; x += 1) {
96
- const u = x / Math.max(1, width - 1);
97
- const center = Math.max(0, 1 - Math.abs(u - 0.5) * 2);
98
- const vertical = Math.sin(Math.PI * Math.min(1, Math.max(0, v)));
99
- const base = Math.pow(center, 2.4) * Math.pow(vertical, 0.58);
100
- const edgeFade = Math.min(1, Math.max(0, (1 - v) * 1.45));
101
- const alpha = Math.min(1, base * edgeFade);
102
- const offset = (y * width + x) * 4;
103
- data[offset] = colorByte(color.r);
104
- data[offset + 1] = colorByte(color.g);
105
- data[offset + 2] = colorByte(color.b);
106
- data[offset + 3] = Math.round(alpha * 255);
107
- }
108
- }
109
-
110
- ctx.putImageData(image, 0, 0);
111
- texture.update(false);
112
- return texture;
113
- }
114
-
115
- function createRadialGlowTexture(BABYLON, scene, color) {
116
- const size = 192;
117
- const texture = new BABYLON.DynamicTexture("vfx_door_radial_glow_texture", { width: size, height: size }, scene, false);
118
- texture.hasAlpha = true;
119
- const ctx = texture.getContext();
120
- const image = ctx.createImageData(size, size);
121
- const data = image.data;
122
-
123
- for (let y = 0; y < size; y += 1) {
124
- const v = y / Math.max(1, size - 1);
125
- for (let x = 0; x < size; x += 1) {
126
- const u = x / Math.max(1, size - 1);
127
- const dx = (u - 0.5) * 2;
128
- const dy = (v - 0.5) * 2;
129
- const distance = Math.sqrt(dx * dx + dy * dy);
130
- const alpha = Math.pow(Math.max(0, 1 - distance), 2.15);
131
- const offset = (y * size + x) * 4;
132
- data[offset] = colorByte(color.r);
133
- data[offset + 1] = colorByte(color.g);
134
- data[offset + 2] = colorByte(color.b);
135
- data[offset + 3] = Math.round(alpha * 255);
136
- }
137
- }
138
-
139
- ctx.putImageData(image, 0, 0);
140
- texture.update(false);
141
- return texture;
142
- }
143
-
144
- function applyRenderOrder(mesh, alphaIndex = 110) {
145
- mesh.renderingGroupId = 2;
146
- mesh.alphaIndex = alphaIndex;
147
- }
148
-
149
- function makeMaterial(BABYLON, scene, name, color, alpha, hdrIntensity, texture) {
150
- const material = new BABYLON.StandardMaterial(name, scene);
151
- material.diffuseColor = color;
152
- material.emissiveColor = scaleColor(BABYLON, color, hdrIntensity);
153
- material.diffuseTexture = texture;
154
- material.emissiveTexture = texture;
155
- material.opacityTexture = texture;
156
- material.alpha = alpha;
157
- material.backFaceCulling = false;
158
- material.disableLighting = true;
159
- material.disableDepthWrite = true;
160
- material.disableDepthTest = true;
161
- material.forceDepthWrite = false;
162
- material.useAlphaFromDiffuseTexture = true;
163
- material.transparencyMode = BABYLON.Material.MATERIAL_ALPHABLEND;
164
- if (BABYLON.Engine?.ALPHA_ADD !== undefined) {
165
- material.alphaMode = BABYLON.Engine.ALPHA_ADD;
166
- }
167
- return material;
168
- }
169
-
170
- function createFlake(BABYLON, scene, root, material, index, config) {
171
- const flake = BABYLON.MeshBuilder.CreatePlane(
172
- `vfx_door_gold_flake_${index}`,
173
- {
174
- width: num(config.width, 0.055),
175
- height: num(config.height, 0.18),
176
- },
177
- scene
178
- );
179
- flake.parent = root;
180
- flake.material = material;
181
- flake.billboardMode = BABYLON.Mesh.BILLBOARDMODE_ALL;
182
- applyRenderOrder(flake, 120);
183
-
184
- const areaRadius = Math.max(0.01, num(config.areaRadius, 0.7));
185
- const angle = sequence01(index, 0) * Math.PI * 2;
186
- const radius = Math.sqrt(sequence01(index, 1)) * areaRadius;
187
- flake.metadata = {
188
- x: Math.cos(angle) * radius,
189
- z: Math.sin(angle) * radius,
190
- delay: sequence01(index, 2) * num(config.staggerTime, 0.34),
191
- phase: sequence01(index, 3) * Math.PI * 2,
192
- };
193
- return flake;
194
- }
195
-
196
- function createLightRay(BABYLON, scene, root, material, index, config) {
197
- const ray = BABYLON.MeshBuilder.CreatePlane(
198
- `vfx_door_light_ray_${index}`,
199
- {
200
- width: num(config.width, 0.22),
201
- height: num(config.height, 1.45),
202
- },
203
- scene
204
- );
205
- ray.parent = root;
206
- ray.material = material;
207
- ray.billboardMode = BABYLON.Mesh.BILLBOARDMODE_Y;
208
- ray.alwaysSelectAsActiveMesh = true;
209
- applyRenderOrder(ray, 112);
210
-
211
- const count = Math.max(1, Math.round(num(config.count, 5)));
212
- const spread = Math.max(0.01, num(config.spread, 0.74));
213
- const t = count <= 1 ? 0.5 : index / (count - 1);
214
- ray.metadata = {
215
- x: (t - 0.5) * spread,
216
- y: num(config.y, 0.52),
217
- delay: sequence01(index, 1) * num(config.staggerTime, 0.16),
218
- phase: sequence01(index, 2) * Math.PI * 2,
219
- heightScale: 0.82 + sequence01(index, 3) * 0.34,
220
- };
221
- return ray;
222
- }
223
-
224
- function createCenterGlow(BABYLON, scene, root, material, config) {
225
- const glow = BABYLON.MeshBuilder.CreatePlane(
226
- "vfx_door_center_glow",
227
- {
228
- width: num(config.width, 1.35),
229
- height: num(config.height, 1.05),
230
- },
231
- scene
232
- );
233
- glow.parent = root;
234
- glow.material = material;
235
- glow.billboardMode = BABYLON.Mesh.BILLBOARDMODE_ALL;
236
- glow.alwaysSelectAsActiveMesh = true;
237
- glow.position.y = num(config.y, 0.42);
238
- applyRenderOrder(glow, 108);
239
- return glow;
240
- }
241
-
242
- export async function createGoldFlakesRuntime({ BABYLON, scene, emitter, shouldStart = false }) {
243
- if (!BABYLON) throw new Error("createGoldFlakesRuntime requires BABYLON.");
244
- if (!scene) throw new Error("createGoldFlakesRuntime requires scene.");
245
- if (!emitter) throw new Error("createGoldFlakesRuntime requires emitter.");
246
-
247
- const origin = readVec(BABYLON, emitter.origin, BABYLON.Vector3.Zero());
248
- const duration = Math.max(0.1, num(emitter.duration, 1.2));
249
- const effectScale = Math.max(0.05, num(emitter.effectScale, 1));
250
- const flakeCount = Math.max(1, Math.round(num(emitter.flakeCount, 28)));
251
- const areaRadius = Math.max(0.01, num(emitter.areaRadius, 0.7) * effectScale);
252
- const riseHeight = Math.max(0.01, num(emitter.riseHeight, 1.35) * effectScale);
253
- const flakeAlpha = Math.max(0, num(emitter.flakeAlpha, 0.9));
254
- const hdrIntensity = Math.max(0, num(emitter.hdrIntensity, 1.8));
255
- const flakeColor = readColor3(BABYLON, emitter.flakeColor, new BABYLON.Color3(1, 0.78, 0.18));
256
- const lightRayCount = Math.max(0, Math.round(num(emitter.lightRayCount, 5)));
257
- const lightRayAlpha = Math.max(0, num(emitter.lightRayAlpha, 0.92));
258
- const lightRayScaleX = Math.max(0.01, num(emitter.lightRayScaleX, 1));
259
- const lightRayScaleY = Math.max(0.01, num(emitter.lightRayScaleY, 1));
260
- const lightRayScaleZ = Math.max(0.01, num(emitter.lightRayScaleZ, 1));
261
- const glowAlpha = Math.max(0, num(emitter.glowAlpha, 0.72));
262
- const glowIntensity = Math.max(0, num(emitter.glowIntensity, 4.2));
263
- const glowColor = readColor3(BABYLON, emitter.glowColor, new BABYLON.Color3(1, 0.9, 0.42));
264
-
265
- const root = new BABYLON.TransformNode(`vfx_door_gold_flakes_${Date.now()}`, scene);
266
- root.position.copyFrom(origin);
267
- root.position.y += Math.max(0.01, num(emitter.groundOffsetY, 0.06) * effectScale);
268
- root.scaling.set(
269
- Math.max(0.01, num(emitter.scaleX, 1)),
270
- Math.max(0.01, num(emitter.scaleY, 1)),
271
- Math.max(0.01, num(emitter.scaleZ, 1))
272
- );
273
-
274
- const texture = createFlakeTexture(BABYLON, scene);
275
- const rayTexture = createLightRayTexture(BABYLON, scene, glowColor);
276
- const radialTexture = createRadialGlowTexture(BABYLON, scene, glowColor);
277
- const material = makeMaterial(BABYLON, scene, "vfx_door_gold_flake_mat", flakeColor, 1, hdrIntensity, texture);
278
- const rayMaterial = makeMaterial(BABYLON, scene, "vfx_door_light_ray_mat", glowColor, 1, glowIntensity, rayTexture);
279
- const glowMaterial = makeMaterial(BABYLON, scene, "vfx_door_center_glow_mat", glowColor, 1, glowIntensity, radialTexture);
280
- const flakes = Array.from({ length: flakeCount }, (_, index) => createFlake(BABYLON, scene, root, material, index, {
281
- areaRadius,
282
- staggerTime: emitter.staggerTime,
283
- width: num(emitter.flakeWidth, 0.055) * effectScale,
284
- height: num(emitter.flakeHeight, 0.18) * effectScale,
285
- }));
286
- const lightRays = Array.from({ length: lightRayCount }, (_, index) => createLightRay(BABYLON, scene, root, rayMaterial, index, {
287
- count: lightRayCount,
288
- spread: num(emitter.lightRaySpread, 0.82) * effectScale,
289
- staggerTime: emitter.lightRayStaggerTime,
290
- width: num(emitter.lightRayWidth, 0.22) * effectScale,
291
- height: num(emitter.lightRayHeight, 1.45) * effectScale,
292
- y: num(emitter.lightRayOffsetY, 0.62) * effectScale,
293
- }));
294
- const centerGlow = createCenterGlow(BABYLON, scene, root, glowMaterial, {
295
- width: num(emitter.glowWidth, 1.28) * effectScale,
296
- height: num(emitter.glowHeight, 0.92) * effectScale,
297
- y: num(emitter.glowOffsetY, 0.42) * effectScale,
298
- });
299
-
300
- let startedAt = 0;
301
- let observer = null;
302
- let running = false;
303
- let disposed = false;
304
-
305
- const update = () => {
306
- const elapsed = (performance.now() - startedAt) / 1000;
307
- const globalT = Math.min(1, elapsed / duration);
308
-
309
- for (const flake of flakes) {
310
- const meta = flake.metadata || {};
311
- const delay = num(meta.delay, 0);
312
- const local = Math.min(1, Math.max(0, (elapsed - delay) / Math.max(0.01, duration - delay)));
313
- const fadeIn = Math.min(1, local / 0.12);
314
- const fadeOut = Math.min(1, (1 - local) / 0.28);
315
- const alpha = flakeAlpha * Math.max(0, Math.min(fadeIn, fadeOut));
316
- flake.position.x = num(meta.x, 0);
317
- flake.position.z = num(meta.z, 0);
318
- flake.position.y = local * riseHeight;
319
- flake.visibility = alpha;
320
- flake.scaling.setAll(0.86 + Math.sin(local * Math.PI) * 0.18);
321
- }
322
-
323
- for (const ray of lightRays) {
324
- const meta = ray.metadata || {};
325
- const delay = num(meta.delay, 0);
326
- const local = Math.min(1, Math.max(0, (elapsed - delay) / Math.max(0.01, duration - delay)));
327
- const fadeIn = Math.min(1, local / 0.18);
328
- const fadeOut = Math.min(1, (1 - local) / 0.34);
329
- const pulse = 0.82 + Math.sin(local * Math.PI * 2 + num(meta.phase, 0)) * 0.18;
330
- ray.position.x = num(meta.x, 0);
331
- ray.position.y = num(meta.y, 0.62) + local * riseHeight * 0.15;
332
- ray.position.z = 0;
333
- ray.visibility = lightRayAlpha * Math.max(0, Math.min(fadeIn, fadeOut)) * pulse;
334
- const pulseScale = 0.84 + Math.sin(local * Math.PI) * 0.22;
335
- ray.scaling.set(
336
- pulseScale * lightRayScaleX,
337
- num(meta.heightScale, 1) * lightRayScaleY,
338
- lightRayScaleZ
339
- );
340
- }
341
-
342
- centerGlow.visibility = glowAlpha * Math.sin(globalT * Math.PI);
343
- centerGlow.scaling.setAll(0.86 + Math.sin(globalT * Math.PI) * 0.24);
344
- material.alpha = flakeAlpha * Math.sin(globalT * Math.PI);
345
- rayMaterial.alpha = 1;
346
- glowMaterial.alpha = 1;
347
-
348
- if (elapsed >= duration) {
349
- stop();
350
- }
351
- };
352
-
353
- function start() {
354
- if (running || disposed) return;
355
- running = true;
356
- startedAt = performance.now();
357
- root.setEnabled(true);
358
- observer = scene.onBeforeRenderObservable.add(update);
359
- }
360
-
361
- function stop() {
362
- if (!running) return;
363
- running = false;
364
- if (observer) {
365
- scene.onBeforeRenderObservable.remove(observer);
366
- observer = null;
367
- }
368
- dispose();
369
- }
370
-
371
- function dispose() {
372
- if (disposed) return;
373
- disposed = true;
374
- for (const flake of flakes) flake.dispose(false, true);
375
- for (const ray of lightRays) ray.dispose(false, true);
376
- centerGlow.dispose(false, true);
377
- root.dispose();
378
- material.dispose();
379
- rayMaterial.dispose();
380
- glowMaterial.dispose();
381
- texture.dispose();
382
- rayTexture.dispose();
383
- radialTexture.dispose();
384
- }
385
-
386
- root.setEnabled(false);
387
- const preview = {
388
- start,
389
- stop,
390
- dispose,
391
- isStarted: () => running,
392
- duration,
393
- };
394
-
395
- if (shouldStart) start();
396
- return preview;
397
- }