@fps-games/vfx 0.3.2 → 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 (231) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/package.json +5 -4
  3. package/tooling/vfx-cli.mjs +8 -1
  4. package/docs/AUTHORING_EFFECTS.md +0 -297
  5. package/docs/INTEGRATION.md +0 -194
  6. package/docs/VFX_LIBRARY_ARCHITECTURE_chatgpt.md +0 -1580
  7. package/docs/VFX_LIBRARY_EXECUTION_PLAN.md +0 -229
  8. package/docs/VFX_LIBRARY_PLAN.md +0 -546
  9. package/docs/hit-flash-red-method.md +0 -155
  10. package/docs/treasure_attention_fx_babylonjs_guide.md +0 -901
  11. package/docs/vfx-ab/RESULTS.md +0 -35
  12. package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/after.png +0 -0
  13. package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/before.png +0 -0
  14. package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/after.png +0 -0
  15. package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/before.png +0 -0
  16. package/docs/vfx-integration_chatgpt.md +0 -462
  17. package/docs/vfx-placement-design.md +0 -164
  18. package/docs/weapon-trail-visualization.html +0 -241
  19. package/packages/EffectPackageService.ts +0 -346
  20. package/packages/SceneVfxService.ts +0 -96
  21. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/runtime/simpleMeshEffect.v1.js +0 -333
  22. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.frag.glsl +0 -25
  23. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.vert.glsl +0 -11
  24. package/packages/build.mesh.yellow_build_upgrade_indicator/assets/textures/effect_jianbian.png +0 -0
  25. package/packages/build.mesh.yellow_build_upgrade_indicator/effect.json +0 -927
  26. package/packages/build.mesh.yellow_build_upgrade_indicator/media/contact-sheet.png +0 -0
  27. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.gif +0 -0
  28. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.mp4 +0 -0
  29. package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.webm +0 -0
  30. package/packages/build.mesh.yellow_build_upgrade_indicator/media/thumbnail.png +0 -0
  31. package/packages/build.mesh.yellow_build_upgrade_indicator/metadata/description.json +0 -197
  32. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-effect.original.json +0 -895
  33. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-normalized-vfx-to-babylon-report.json +0 -241
  34. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-overrides.json +0 -542
  35. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-tuning-report.json +0 -69
  36. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/asset-map.json +0 -125
  37. package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/lineage.json +0 -44
  38. package/packages/build.particle.golden_upgrade_starburst/assets/runtime/particleEmitter.v1.js +0 -210
  39. package/packages/build.particle.golden_upgrade_starburst/assets/textures/effect_guangdian.png +0 -0
  40. package/packages/build.particle.golden_upgrade_starburst/effect.json +0 -880
  41. package/packages/build.particle.golden_upgrade_starburst/media/contact-sheet.png +0 -0
  42. package/packages/build.particle.golden_upgrade_starburst/media/preview.gif +0 -0
  43. package/packages/build.particle.golden_upgrade_starburst/media/preview.mp4 +0 -0
  44. package/packages/build.particle.golden_upgrade_starburst/media/preview.webm +0 -0
  45. package/packages/build.particle.golden_upgrade_starburst/media/thumbnail.png +0 -0
  46. package/packages/build.particle.golden_upgrade_starburst/metadata/description.json +0 -161
  47. package/packages/build.particle.golden_upgrade_starburst/provenance/03-effect.original.json +0 -762
  48. package/packages/build.particle.golden_upgrade_starburst/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
  49. package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-overrides.json +0 -436
  50. package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-tuning-report.json +0 -40
  51. package/packages/build.particle.golden_upgrade_starburst/provenance/asset-map.json +0 -115
  52. package/packages/build.particle.golden_upgrade_starburst/provenance/lineage.json +0 -40
  53. package/packages/build.particle.orange_upgrade_transform_sparks/assets/runtime/particleEmitter.v1.js +0 -210
  54. package/packages/build.particle.orange_upgrade_transform_sparks/assets/textures/b5b27ab1-e740-4398-b407-848fc2b2c897.png +0 -0
  55. package/packages/build.particle.orange_upgrade_transform_sparks/effect.json +0 -887
  56. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.gif +0 -0
  57. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.mp4 +0 -0
  58. package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.webm +0 -0
  59. package/packages/build.particle.orange_upgrade_transform_sparks/media/thumbnail.png +0 -0
  60. package/packages/build.particle.orange_upgrade_transform_sparks/metadata/description.json +0 -179
  61. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-effect.original.json +0 -859
  62. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
  63. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-overrides.json +0 -478
  64. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-tuning-report.json +0 -40
  65. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/asset-map.json +0 -114
  66. package/packages/build.particle.orange_upgrade_transform_sparks/provenance/lineage.json +0 -41
  67. package/packages/build.particle.wood_chip_dust_burst/assets/runtime/particleEmitter.v1.js +0 -210
  68. package/packages/build.particle.wood_chip_dust_burst/assets/textures/effect_yanwu4.png +0 -0
  69. package/packages/build.particle.wood_chip_dust_burst/assets/textures/suipian3.png +0 -0
  70. package/packages/build.particle.wood_chip_dust_burst/effect.json +0 -1400
  71. package/packages/build.particle.wood_chip_dust_burst/media/contact-sheet.png +0 -0
  72. package/packages/build.particle.wood_chip_dust_burst/media/preview.gif +0 -0
  73. package/packages/build.particle.wood_chip_dust_burst/media/preview.mp4 +0 -0
  74. package/packages/build.particle.wood_chip_dust_burst/media/preview.webm +0 -0
  75. package/packages/build.particle.wood_chip_dust_burst/media/thumbnail.png +0 -0
  76. package/packages/build.particle.wood_chip_dust_burst/metadata/description.json +0 -173
  77. package/packages/build.particle.wood_chip_dust_burst/provenance/03-effect.original.json +0 -1277
  78. package/packages/build.particle.wood_chip_dust_burst/provenance/03-normalized-vfx-to-babylon-report.json +0 -329
  79. package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-overrides.json +0 -749
  80. package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-tuning-report.json +0 -60
  81. package/packages/build.particle.wood_chip_dust_burst/provenance/asset-map.json +0 -146
  82. package/packages/build.particle.wood_chip_dust_burst/provenance/lineage.json +0 -69
  83. package/packages/effects/building-upgrade/effect.json +0 -6
  84. package/packages/effects/building-upgrade/index.ts +0 -387
  85. package/packages/effects/character-entrance/effect.json +0 -6
  86. package/packages/effects/character-entrance/index.ts +0 -308
  87. package/packages/effects/coin-burst/index.ts +0 -48
  88. package/packages/effects/comet-trail-flame/assets/textures/trail_5x4.webp +0 -0
  89. package/packages/effects/comet-trail-flame/index.ts +0 -107
  90. package/packages/effects/conveyor-upgrade/effect.json +0 -6
  91. package/packages/effects/conveyor-upgrade/index.ts +0 -401
  92. package/packages/effects/debris-smoke/assets/models/rock_debris.glb +0 -0
  93. package/packages/effects/debris-smoke/assets/textures/smoke22.webp +0 -0
  94. package/packages/effects/debris-smoke/index.ts +0 -102
  95. package/packages/effects/door_open_gold_flakes/assets/runtime/goldFlakes.v1.js +0 -397
  96. package/packages/effects/door_open_gold_flakes/door_open_gold_flakes.json +0 -498
  97. package/packages/effects/door_open_gold_flakes/index.ts +0 -11
  98. package/packages/effects/electric-arc/assets/textures/spark_4x4.webp +0 -0
  99. package/packages/effects/electric-arc/index.ts +0 -63
  100. package/packages/effects/energy-shield/effect.json +0 -7
  101. package/packages/effects/energy-shield/index.ts +0 -432
  102. package/packages/effects/explosion/assets/textures/baozha29.webp +0 -0
  103. package/packages/effects/explosion/assets/textures/glow01.webp +0 -0
  104. package/packages/effects/explosion/assets/textures/lizi01.webp +0 -0
  105. package/packages/effects/explosion/assets/textures/xulie_lizibaozha02_5x5.webp +0 -0
  106. package/packages/effects/explosion/index.ts +0 -115
  107. package/packages/effects/ground-tile-upgrade/effect.json +0 -6
  108. package/packages/effects/ground-tile-upgrade/index.ts +0 -410
  109. package/packages/effects/hit-flash/index.ts +0 -77
  110. package/packages/effects/laser-beam/assets/textures/laser_glow.webp +0 -0
  111. package/packages/effects/laser-beam/assets/textures/laser_noise.webp +0 -0
  112. package/packages/effects/laser-beam/index.ts +0 -6
  113. package/packages/effects/laser-beam-factory.ts +0 -146
  114. package/packages/effects/lumber-cart-suction/effect.json +0 -6
  115. package/packages/effects/lumber-cart-suction/index.ts +0 -399
  116. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb +0 -0
  117. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/.active +0 -1
  118. package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/1781589063890_upload.glb +0 -0
  119. package/packages/effects/lumber-debris-scatter/assets/runtime/solidParticleScatter.v1.js +0 -236
  120. package/packages/effects/lumber-debris-scatter/effect.json +0 -228
  121. package/packages/effects/lumber-debris-scatter/index.ts +0 -780
  122. package/packages/effects/lumber_vehicle_gear_spin/assets/runtime/gearSpin.v1.js +0 -202
  123. package/packages/effects/lumber_vehicle_gear_spin/index.ts +0 -11
  124. package/packages/effects/lumber_vehicle_gear_spin/lumber_vehicle_gear_spin.json +0 -338
  125. package/packages/effects/lumber_vehicle_upgrade_aura/assets/runtime/upgradeAura.v1.js +0 -353
  126. package/packages/effects/lumber_vehicle_upgrade_aura/index.ts +0 -13
  127. package/packages/effects/lumber_vehicle_upgrade_aura/lumber_vehicle_upgrade_aura.json +0 -365
  128. package/packages/effects/lumber_vehicle_wood_chips/assets/runtime/solidParticleScatter.v1.js +0 -310
  129. package/packages/effects/lumber_vehicle_wood_chips/index.ts +0 -11
  130. package/packages/effects/lumber_vehicle_wood_chips/lumber_vehicle_wood_chips.json +0 -335
  131. package/packages/effects/monster-hit/index.ts +0 -129
  132. package/packages/effects/player-upgrade/effect.json +0 -6
  133. package/packages/effects/player-upgrade/index.ts +0 -640
  134. package/packages/effects/pulse-laser-volley/assets/textures/bolt_guangshu.webp +0 -0
  135. package/packages/effects/pulse-laser-volley/index.ts +0 -215
  136. package/packages/effects/resource-collect-sparkles/effect.json +0 -6
  137. package/packages/effects/resource-collect-sparkles/index.ts +0 -254
  138. package/packages/effects/run-footstep-dust/assets/runtime/runFootstepDust.v1.js +0 -215
  139. package/packages/effects/run-footstep-dust/effect.json +0 -183
  140. package/packages/effects/run-footstep-dust/index.ts +0 -377
  141. package/packages/effects/space-shared.ts +0 -120
  142. package/packages/effects/thruster-flame/index.ts +0 -306
  143. package/packages/effects/treasure-attention/effect.json +0 -7
  144. package/packages/effects/treasure-attention/index.ts +0 -630
  145. package/packages/effects/tree-chop-dust/assets/textures/tree_chop_dust_atlas.png +0 -0
  146. package/packages/effects/tree-chop-dust/effect.json +0 -8
  147. package/packages/effects/tree-chop-dust/index.ts +0 -202
  148. package/packages/effects/tree-leaf-chop-burst/assets/runtime/particleEmitter.v1.js +0 -303
  149. package/packages/effects/tree-leaf-chop-burst/assets/textures/tree_leaf_chop_burst_leaf_atlas.png +0 -0
  150. package/packages/effects/tree-leaf-chop-burst/effect.json +0 -498
  151. package/packages/effects/tree-leaf-chop-burst/index.ts +0 -294
  152. package/packages/effects/tree_chop_dust_burst/assets/runtime/particleEmitter.v1.js +0 -318
  153. package/packages/effects/tree_chop_dust_burst/assets/textures/tree_chop_dust_burst_dust.png +0 -0
  154. package/packages/effects/tree_chop_dust_burst/index.ts +0 -13
  155. package/packages/effects/tree_chop_dust_burst/tree_chop_dust_burst.json +0 -412
  156. package/packages/effects/ufo-thread-flame/assets/textures/flame_flow.webp +0 -0
  157. package/packages/effects/ufo-thread-flame/assets/textures/flame_spike.webp +0 -0
  158. package/packages/effects/ufo-thread-flame/index.ts +0 -153
  159. package/packages/effects/vehicle-exhaust-smoke/assets/textures/vehicle_exhaust_smoke_atlas.png +0 -0
  160. package/packages/effects/vehicle-exhaust-smoke/effect.json +0 -8
  161. package/packages/effects/vehicle-exhaust-smoke/index.ts +0 -298
  162. package/packages/effects/vehicle-upgrade/effect.json +0 -6
  163. package/packages/effects/vehicle-upgrade/index.ts +0 -404
  164. package/packages/effects/weapon-trail/assets/textures/trail_wedge.png +0 -0
  165. package/packages/effects/weapon-trail/index.ts +0 -317
  166. package/packages/effects/wood-crusher-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
  167. package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
  168. package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
  169. package/packages/effects/wood-crusher-sawdust/index.ts +0 -43
  170. package/packages/effects/wood-crusher-sawdust/wood_crusher_sawdust.json +0 -592
  171. package/packages/effects/wood-cutter-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
  172. package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
  173. package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
  174. package/packages/effects/wood-cutter-sawdust/index.ts +0 -43
  175. package/packages/effects/wood-cutter-sawdust/wood_cutter_sawdust.json +0 -592
  176. package/packages/effects/wood-sawdust-effect-factory.ts +0 -194
  177. package/packages/effects/wood_crusher_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
  178. package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
  179. package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
  180. package/packages/effects/wood_crusher_sawdust/index.ts +0 -29
  181. package/packages/effects/wood_crusher_sawdust/wood_crusher_sawdust.json +0 -592
  182. package/packages/effects/wood_cutter_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
  183. package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
  184. package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
  185. package/packages/effects/wood_cutter_sawdust/index.ts +0 -29
  186. package/packages/effects/wood_cutter_sawdust/wood_cutter_sawdust.json +0 -592
  187. package/packages/effects/wood_peel_material_test/assets/runtime/woodPeelMaterialTest.v1.js +0 -196
  188. package/packages/effects/wood_peel_material_test/index.ts +0 -11
  189. package/packages/effects/wood_peel_material_test/wood_peel_material_test.json +0 -136
  190. package/packages/env.particle.forest_edge_fog/assets/runtime/particleEmitter.v1.js +0 -210
  191. package/packages/env.particle.forest_edge_fog/assets/textures/f12a23c4-b924-4322-a260-3d982428f1e8.png +0 -0
  192. package/packages/env.particle.forest_edge_fog/assets/textures/yuan.png +0 -0
  193. package/packages/env.particle.forest_edge_fog/effect.json +0 -854
  194. package/packages/env.particle.forest_edge_fog/media/preview.gif +0 -0
  195. package/packages/env.particle.forest_edge_fog/media/preview.mp4 +0 -0
  196. package/packages/env.particle.forest_edge_fog/media/preview.webm +0 -0
  197. package/packages/env.particle.forest_edge_fog/media/thumbnail.png +0 -0
  198. package/packages/env.particle.forest_edge_fog/metadata/description.json +0 -148
  199. package/packages/env.particle.forest_edge_fog/provenance/03-effect.original.json +0 -827
  200. package/packages/env.particle.forest_edge_fog/provenance/03-normalized-vfx-to-babylon-report.json +0 -196
  201. package/packages/env.particle.forest_edge_fog/provenance/04-preview-overrides.json +0 -432
  202. package/packages/env.particle.forest_edge_fog/provenance/04-preview-tuning-report.json +0 -28
  203. package/packages/env.particle.forest_edge_fog/provenance/asset-map.json +0 -124
  204. package/packages/env.particle.forest_edge_fog/provenance/lineage.json +0 -41
  205. package/packages/generation.ts +0 -14
  206. package/packages/index.ts +0 -14
  207. package/packages/legacy-particle-runtime.ts +0 -113
  208. package/packages/manifestRuntimePackage.ts +0 -519
  209. package/packages/registry.ts +0 -85
  210. package/packages/rendering.ts +0 -13
  211. package/packages/resource.particle.viscous_oil_suction/assets/runtime/top_disk_suction/particleEmitter.v1.js +0 -424
  212. package/packages/resource.particle.viscous_oil_suction/assets/textures/Glow ad.png +0 -0
  213. package/packages/resource.particle.viscous_oil_suction/effect.json +0 -1254
  214. package/packages/resource.particle.viscous_oil_suction/media/preview.gif +0 -0
  215. package/packages/resource.particle.viscous_oil_suction/media/preview.mp4 +0 -0
  216. package/packages/resource.particle.viscous_oil_suction/media/preview.webm +0 -0
  217. package/packages/resource.particle.viscous_oil_suction/media/thumbnail.png +0 -0
  218. package/packages/resource.particle.viscous_oil_suction/metadata/description.json +0 -122
  219. package/packages/resource.particle.viscous_oil_suction/provenance/03-effect.original.json +0 -1051
  220. package/packages/resource.particle.viscous_oil_suction/provenance/03-normalized-vfx-to-babylon-report.json +0 -200
  221. package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-overrides.json +0 -581
  222. package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-tuning-report.json +0 -28
  223. package/packages/resource.particle.viscous_oil_suction/provenance/asset-map.json +0 -111
  224. package/packages/resource.particle.viscous_oil_suction/provenance/lineage.json +0 -45
  225. package/packages/types.ts +0 -195
  226. package/tooling/check-dist-runtime.mjs +0 -166
  227. package/tooling/generate-index.mjs +0 -55
  228. package/tooling/test-guardrails.mjs +0 -157
  229. package/tooling/validate-boundary.mjs +0 -92
  230. package/tooling/validate-effects.mjs +0 -304
  231. package/tooling/validate.mjs +0 -53
@@ -1,298 +0,0 @@
1
- import { Color4 } from '@babylonjs/core/Maths/math.color';
2
- import { Vector3 } from '@babylonjs/core/Maths/math.vector';
3
- import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
4
- import { Sprite } from '@babylonjs/core/Sprites/sprite';
5
- import { SpriteManager } from '@babylonjs/core/Sprites/spriteManager';
6
- import type { Scene } from '@babylonjs/core/scene';
7
- import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
8
- import { configureVfxSpriteManager, VFX_RENDERING_GROUP_ID } from '../../rendering';
9
- import manifest from './effect.json';
10
-
11
- interface VehicleExhaustSmokeParams extends VfxParamValues {
12
- lifetimeMode: string;
13
- lifetime: number;
14
- scale: number;
15
- initialHeight: number;
16
- color: VfxColorValue;
17
- opacity: number;
18
- particleCount: number;
19
- particleMaxLifetime: number;
20
- emitRange: number;
21
- riseHeight: number;
22
- smokeSize: number;
23
- driftSpeed: number;
24
- directionX: number;
25
- directionZ: number;
26
- }
27
-
28
- interface SmokeSpriteState {
29
- sprite: Sprite;
30
- velocity: Vector3;
31
- spin: number;
32
- width: number;
33
- height: number;
34
- lifetime: number;
35
- alphaScale: number;
36
- age: number;
37
- active: boolean;
38
- }
39
-
40
- import SMOKE_TEXTURE_URL from './assets/textures/vehicle_exhaust_smoke_atlas.png?url';
41
-
42
- const DEFAULT_PARAMS: VehicleExhaustSmokeParams = {
43
- lifetimeMode: 'infinite',
44
- lifetime: 2.2,
45
- scale: 1.35,
46
- initialHeight: 0.55,
47
- color: { r: 0.34, g: 0.34, b: 0.32 },
48
- opacity: 0.78,
49
- particleCount: 82,
50
- particleMaxLifetime: 1.61,
51
- emitRange: 0.3,
52
- riseHeight: 0.72,
53
- smokeSize: 0.82,
54
- driftSpeed: 1.4,
55
- directionX: -1,
56
- directionZ: 0,
57
- };
58
-
59
- export const vehicleExhaustSmokeEffectPackage: VfxEffectPackage<VehicleExhaustSmokeParams> = {
60
- id: 'vehicle-exhaust-smoke',
61
- nameZh: '小车尾气',
62
- manifest,
63
- defaultParams: DEFAULT_PARAMS,
64
- debugAnchor: 'player',
65
- debugParams: [
66
- {
67
- key: 'lifetimeMode',
68
- label: '生命周期模式',
69
- kind: 'enum',
70
- options: [
71
- { value: 'infinite', label: '无限' },
72
- { value: 'duration', label: '自定义时间' },
73
- ],
74
- },
75
- { key: 'lifetime', label: '自定义时长', kind: 'lifetime', min: 0.1, max: 30, step: 0.01 },
76
- { key: 'scale', label: '整体缩放', kind: 'scale', min: 0.05, max: 8, step: 0.01 },
77
- { key: 'initialHeight', label: '初始高度', kind: 'number', min: -1, max: 3, step: 0.01 },
78
- { key: 'color', label: '尾气颜色', kind: 'color' },
79
- { key: 'opacity', label: '透明度', kind: 'opacity', min: 0, max: 1, step: 0.01 },
80
- { key: 'particleCount', label: '粒子数量', kind: 'number', min: 1, max: 180, step: 1 },
81
- { key: 'particleMaxLifetime', label: '单粒最大生命周期', kind: 'lifetime', min: 0.08, max: 5, step: 0.01 },
82
- { key: 'emitRange', label: '排气口宽度', kind: 'number', min: 0, max: 2, step: 0.01 },
83
- { key: 'riseHeight', label: '上浮高度', kind: 'number', min: -1, max: 4, step: 0.01 },
84
- { key: 'smokeSize', label: '烟团大小', kind: 'number', min: 0.02, max: 3, step: 0.01 },
85
- { key: 'driftSpeed', label: '飘散速度', kind: 'number', min: 0.05, max: 8, step: 0.01 },
86
- { key: 'directionX', label: '方向 X', kind: 'number', min: -1, max: 1, step: 0.01 },
87
- { key: 'directionZ', label: '方向 Z', kind: 'number', min: -1, max: 1, step: 0.01 },
88
- ],
89
- create({ scene, root, position, renderingGroupId, params }) {
90
- const effectScale = Math.max(0.05, params.scale);
91
- root.position.copyFrom(position).addInPlace(new Vector3(0, params.initialHeight * effectScale, 0));
92
- const smokeTrail = createExhaustSpriteTrail(scene, root, params, renderingGroupId);
93
- let disposed = false;
94
- const durationSeconds = readDurationSeconds(params);
95
- const disposeTimer = durationSeconds == null
96
- ? 0
97
- : window.setTimeout(() => disposeAll(), getDisposeDelaySeconds(params) * 1000);
98
-
99
- return {
100
- root,
101
- dispose() {
102
- disposeAll();
103
- },
104
- };
105
-
106
- function disposeAll(): void {
107
- if (disposed) return;
108
- disposed = true;
109
- if (disposeTimer) window.clearTimeout(disposeTimer);
110
- smokeTrail.dispose();
111
- root.dispose();
112
- }
113
- },
114
- };
115
-
116
- function createExhaustSpriteTrail(
117
- scene: Scene,
118
- root: TransformNode,
119
- params: VehicleExhaustSmokeParams,
120
- renderingGroupId?: number,
121
- ): { dispose(): void } {
122
- const count = Math.max(1, Math.round(params.particleCount));
123
- const manager = new SpriteManager('vehicle-exhaust-smoke.puffs', SMOKE_TEXTURE_URL, count, { width: 128, height: 128 }, scene);
124
- configureVfxSpriteManager(manager);
125
- manager.renderingGroupId = renderingGroupId ?? VFX_RENDERING_GROUP_ID;
126
- manager.texture.hasAlpha = true;
127
- manager.fogEnabled = false;
128
-
129
- const effectScale = Math.max(0.05, params.scale);
130
- const emitRange = Math.max(0, params.emitRange) * effectScale;
131
- const smokeSize = Math.max(0.01, params.smokeSize) * effectScale;
132
- const driftSpeed = Math.max(0.01, params.driftSpeed) * effectScale;
133
- const particleMaxLifetime = Math.max(0.08, params.particleMaxLifetime);
134
- const durationSeconds = readDurationSeconds(params);
135
- const puffLifetime = particleMaxLifetime / 1.18;
136
- const emitInterval = Math.max(0.018, 2.2 / Math.max(1, count));
137
- const states: SmokeSpriteState[] = [];
138
-
139
- for (let index = 0; index < count; index += 1) {
140
- const sprite = new Sprite(`vehicle-exhaust-smoke.puff.${index}`, manager);
141
- sprite.isVisible = false;
142
- sprite.color = toColor4(params.color, 0);
143
- states.push({
144
- sprite,
145
- velocity: Vector3.Zero(),
146
- spin: 0,
147
- width: 0,
148
- height: 0,
149
- lifetime: puffLifetime,
150
- alphaScale: 1,
151
- age: 0,
152
- active: false,
153
- });
154
- }
155
-
156
- let age = 0;
157
- let emissionIndex = 0;
158
- let emitAccumulator = 0;
159
- let disposed = false;
160
-
161
- const warmStartCount = Math.min(count, Math.max(3, Math.ceil(count * 0.08)));
162
- for (let index = 0; index < warmStartCount; index += 1) {
163
- const state = states[index];
164
- spawnPuff(state, emissionIndex);
165
- state.age = (index / warmStartCount) * state.lifetime * 0.52;
166
- emissionIndex += 1;
167
- }
168
-
169
- const observer = scene.onBeforeRenderObservable.add(() => {
170
- if (disposed) return;
171
- const deltaSeconds = Math.min(0.05, scene.getEngine().getDeltaTime() / 1000);
172
- age += deltaSeconds;
173
- if (durationSeconds == null || age <= durationSeconds) {
174
- emitAccumulator += deltaSeconds;
175
- while (emitAccumulator >= emitInterval) {
176
- emitAccumulator -= emitInterval;
177
- const state = findAvailableState(states);
178
- if (!state) break;
179
- spawnPuff(state, emissionIndex);
180
- emissionIndex += 1;
181
- }
182
- }
183
- for (const state of states) {
184
- if (!state.active) continue;
185
- state.age += deltaSeconds;
186
- const t = Math.min(1, state.age / state.lifetime);
187
- const fadeIn = Math.min(1, t / 0.12);
188
- const fadeOut = Math.max(0, 1 - Math.max(0, t - 0.34) / 0.66);
189
- const alpha = clamp01(params.opacity) * state.alphaScale * fadeIn * fadeOut;
190
- state.sprite.position.addInPlace(state.velocity.scale(deltaSeconds));
191
- state.sprite.angle += state.spin * deltaSeconds;
192
- const grow = 1 + t * 1.45;
193
- state.sprite.width = state.width * grow;
194
- state.sprite.height = state.height * grow;
195
- state.sprite.color = toColor4(params.color, alpha);
196
- state.sprite.isVisible = alpha > 0.01 && t < 1;
197
- if (t >= 1) {
198
- state.active = false;
199
- state.sprite.isVisible = false;
200
- }
201
- }
202
- if (durationSeconds != null && age >= durationSeconds + particleMaxLifetime + 0.35) dispose();
203
- });
204
-
205
- function dispose(): void {
206
- if (disposed) return;
207
- disposed = true;
208
- scene.onBeforeRenderObservable.remove(observer);
209
- for (const state of states) state.sprite.dispose();
210
- manager.dispose();
211
- }
212
-
213
- return { dispose };
214
-
215
- function spawnPuff(state: SmokeSpriteState, seed: number): void {
216
- const spawnOrigin = root.getAbsolutePosition();
217
- const direction = readWorldDirection(root, params);
218
- const side = makeSideVector(direction);
219
- const jitterSide = (sequence01(seed, 0) - 0.5) * emitRange;
220
- const jitterForward = (sequence01(seed, 1) - 0.5) * emitRange * 0.45;
221
- const startHeight = (sequence01(seed, 2) - 0.5) * emitRange * 0.3;
222
- const baseSize = smokeSize * lerp(0.56, 1.12, sequence01(seed, 3));
223
- state.sprite.position = spawnOrigin
224
- .add(direction.scale(jitterForward))
225
- .add(side.scale(jitterSide))
226
- .add(new Vector3(0, startHeight, 0));
227
- state.sprite.width = baseSize;
228
- state.sprite.height = baseSize * lerp(0.82, 1.18, sequence01(seed, 4));
229
- state.sprite.angle = sequence01(seed, 5) * Math.PI * 2;
230
- state.sprite.cellIndex = Math.floor(sequence01(seed, 6) * 4) % 4;
231
- state.sprite.color = toColor4(params.color, 0);
232
- state.sprite.isVisible = true;
233
- state.velocity = direction
234
- .scale(driftSpeed * lerp(0.68, 1.18, sequence01(seed, 7)))
235
- .add(side.scale((sequence01(seed, 8) - 0.5) * driftSpeed * 0.2))
236
- .add(new Vector3(0, params.riseHeight * effectScale * lerp(0.16, 0.36, sequence01(seed, 9)), 0));
237
- state.spin = lerp(-0.9, 0.9, sequence01(seed, 10));
238
- state.width = state.sprite.width;
239
- state.height = state.sprite.height;
240
- state.lifetime = Math.min(particleMaxLifetime, puffLifetime * lerp(0.82, 1.18, sequence01(seed, 11)));
241
- state.alphaScale = lerp(0.72, 1, sequence01(seed, 12));
242
- state.age = 0;
243
- state.active = true;
244
- }
245
- }
246
-
247
- function findAvailableState(states: SmokeSpriteState[]): SmokeSpriteState | null {
248
- return states.find(state => !state.active) ?? null;
249
- }
250
-
251
- function readDirection(params: VehicleExhaustSmokeParams): Vector3 {
252
- const direction = new Vector3(params.directionX, 0, params.directionZ);
253
- if (direction.lengthSquared() <= 0.0001) return new Vector3(-1, 0, 0);
254
- return direction.normalize();
255
- }
256
-
257
- function readWorldDirection(root: TransformNode, params: VehicleExhaustSmokeParams): Vector3 {
258
- const direction = Vector3.TransformNormal(readDirection(params), root.getWorldMatrix());
259
- direction.y = 0;
260
- if (direction.lengthSquared() <= 0.0001) return readDirection(params);
261
- return direction.normalize();
262
- }
263
-
264
- function readDurationSeconds(params: VehicleExhaustSmokeParams): number | null {
265
- return params.lifetimeMode === 'infinite' ? null : Math.max(0.05, params.lifetime);
266
- }
267
-
268
- function makeSideVector(direction: Vector3): Vector3 {
269
- const side = new Vector3(-direction.z, 0, direction.x);
270
- return side.lengthSquared() > 0.0001 ? side.normalize() : new Vector3(0, 0, 1);
271
- }
272
-
273
- function getDisposeDelaySeconds(params: VehicleExhaustSmokeParams): number {
274
- const lifetime = Math.max(0.05, params.lifetime);
275
- return lifetime + Math.max(0.08, params.particleMaxLifetime) + 0.45;
276
- }
277
-
278
- function toColor4(color: VfxColorValue, alpha: number): Color4 {
279
- return new Color4(clamp01(color.r), clamp01(color.g), clamp01(color.b), clamp01(alpha));
280
- }
281
-
282
- function lerp(min: number, max: number, t: number): number {
283
- return min + (max - min) * t;
284
- }
285
-
286
- function clamp01(value: number): number {
287
- return Math.min(1, Math.max(0, value));
288
- }
289
-
290
- function fract(value: number): number {
291
- return value - Math.floor(value);
292
- }
293
-
294
- function sequence01(index: number, axis: number): number {
295
- if (index === 0) return 0.5;
296
- const strides = [0.618033988749895, 0.414213562373095, 0.732050807568877, 0.324717957244746, 0.754877666246693, 0.569840290998053];
297
- return fract(0.5 + index * strides[axis % strides.length] + axis * 0.173205080756888);
298
- }
@@ -1,6 +0,0 @@
1
- {
2
- "id": "vehicle-upgrade",
3
- "nameZh": "小车升级光效",
4
- "source": "runtime-generated",
5
- "assets": []
6
- }