chore(release): 4.13.1 [skip ci]

## [4.13.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.13.0...v4.13.1) (2026-06-26)

### Bug Fixes

* `ParticleSystemPreviewer` is no longer included in build ([bad976c](bad976cf01))
* add support for Unity 6.7 ([26fd3da](26fd3da20b)), closes [#408](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/408)

CHANGELOG.md

@@ -1,57 +1,233 @@
-# [5.0.0-preview.4](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.3...v5.0.0-preview.4) (2024-06-27)
+## [4.13.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.13.0...v4.13.1) (2026-06-26)
 
 
 ### Bug Fixes
 
-* generated baking-camera object remains in the prefab or scene (again) ([5babd6d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5babd6d07b2ac17341a29964baf552785cefd90e))
+* `ParticleSystemPreviewer` is no longer included in build ([bad976c](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/bad976cf01180bdabf5cd2f1760e069afdcb644a))
-* SetParticleSystemInstance/Prefab APIs destroy generated objects ([4b30c16](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/4b30c16b9a48531873f9be91eec2a573370d17a1))
+* add support for Unity 6.7 ([26fd3da](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/26fd3da20b6b07f7a26df662358c53757a7cc5f5)), closes [#408](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/408)
 
-
+# [4.13.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.2...v4.13.0) (2026-06-25)
-### Features
-
-* add 'custom view' option. ([4252f11](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/4252f1199b8a7038a6fb447989534c512ec40283))
-* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` (again) ([04232b6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/04232b67491e4506dbf84ce77c1dee7127936a3a))
-* the rendering order list in inspector is now more compact ([9212eaa](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/9212eaa84c85524c00f9228ff8ba887e028838dc))
-
-# [5.0.0-preview.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.2...v5.0.0-preview.3) (2024-06-21)
 
 
 ### Bug Fixes
 
-* generated baking-camera object remains in the prefab or scene ([fd66928](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fd66928efe584aeb4f6347b9a9dca97d9512eb88))
+* `UI/Additive` shader does not support RectMask2D softness. ([83145d3](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/83145d3a6ede3831d1f7c49afde6ef7d8a498d21))
+* rename `UIParticleProjectSettings.enableLinearToGamma` to `autoColorCorrection` ([10f82a8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/10f82a8579a2d055f897e7a8d6f3b5ba1fc43ae8))
+* Support for skipping "reload domain" ([b7bb112](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b7bb1124f6921ebca1b48991462637767b95e504)), closes [#406](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/406)
+* there is a compilation error in Unity 2019.2 or earlier ([c327632](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c327632e1eb203351ba1a1087a19eb7838c22530)), closes [#407](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/407)
 
-# [5.0.0-preview.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.1...v5.0.0-preview.2) (2024-06-20)
+
+### Features
+
+* add fields located outside the `Properties` block in the shader as `Animatable Properties` ([ea2fcfd](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ea2fcfd8099a24b92624d34600beb519fb9d2b38)), closes [#399](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/399)
+* preview the ParticleSystem playback when selecting a UIParticle in the Editor ([108bcfb](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/108bcfbd246960dc730546dc334424cf2e17bfd4))
+* project-wide default view size for baking ([8e0ff10](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/8e0ff10c7344d9f53d2f4f096ddeb7392b67f930)), closes [#360](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/360)
+
+## [4.12.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.1...v4.12.2) (2026-06-08)
 
 
 ### Bug Fixes
 
-* 'Resource ID out of range in GetResource' error in overlay rendering mode ([ff78b6f](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ff78b6fe32ceed8ddad50e63dcb7a202eab95266)), closes [#308](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/308)
+* add `meshCleared` flag to optimize mesh clearing ([859fa20](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/859fa20d297c3f44e3361f20dbb7ce966407e03e))
-* `UIParticle.transform.localScale` does not scale particles ([491ee7b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/491ee7b0c3e528e1e577ae5ff2588d7c3bd8ecdb)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+* fix Unity6.5 compile errors and warnings ([a5ee687](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a5ee6878212be2fc4d7b48879426f239e8753009)), closes [#400](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/400)
-* despite not using the size module, particles become smaller based on their z position ([c96ddf2](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c96ddf293e855f7ebccaaaf3b112092955545e61)), closes [#316](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/316)
+* potential access to UIParticleRenderer that has already been destroyed ([b740dd6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b740dd662d423c6bef849662ce1b0bfbb4940ed4)), closes [#403](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/403)
-* the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues ([a9c2b19](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9c2b19edf00e1c86c928ef23405906952ede852)), closes [#299](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/299) [#312](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/312)
+* updated support for some changed menu paths ([f8ac986](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/f8ac9869f141238169730e74f5d65c4fc6081f51)), closes [#397](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/397)
-* UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` ([63b24d8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/63b24d8a8b478b3165733ece3eec524e88b28855)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+
-* UIParticle is scaled incorrectly with nested canvases ([c95d8c6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c95d8c6b1774396ff252d13121ad32a3cab0fe5c)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+## [4.12.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.0...v4.12.1) (2026-03-24)
+
+
+### Bug Fixes
+
+* ignore "EditorOnly" tagged gameObjects on refresh ([031d46a](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/031d46a3216c942d2d1a6ccfadf5f0b9e3ce3006))
+
+# [4.12.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.4...v4.12.0) (2026-03-24)
 
 
 ### Features
 
-* remove overlay window (editor) ([fc3fbdd](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fc3fbdd230595ad3471875ec6fec384a3dad0d17))
+* explicit null checks ([5384f61](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5384f61c569e9f78ff9d5b45acfc6f5c2f021a87))
-* reset previous position on start play for world space simulation ([e741584](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/e7415845074143abae23e3ae7eedc767a01d020d)), closes [#303](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/303)
-* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` ([dfb94f4](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/dfb94f4badfb3035a4374579c53293460b4fd946))
 
-# [5.0.0-preview.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.6...v5.0.0-preview.1) (2024-05-23)
+## [4.11.4](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.3...v4.11.4) (2025-12-24)
+
+
+### Bug Fixes
+
+* add early return for case where subEmitter module is disabled ([d1386a1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/d1386a12216743a6e09f1b9b87bea1dfcf7702e4))
+* avoid endless loop ([eb2e862](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/eb2e862e80e549c8cf16ddfed776c101c2413bac)), closes [#392](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/392)
+
+## [4.11.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.2...v4.11.3) (2025-10-14)
+
+
+### Bug Fixes
+
+* fix icon ([a9461ec](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9461ecb4d40d7fe878e12465d6e38faae7ae65b))
+* fix URL link in README ([1c8c65d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1c8c65d25e7f6fe7b1d20da4461333df8fc7578e)), closes [#376](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/376)
+* fix: second and subsequent bursts not displayed when world simulation and non-looping ([df2f3ca](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/df2f3caafbe279f1457d74f8183cb561ac14aa17)), closes [#326](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/326)
+* UIParticle in canvas with 0f-0.01f alpha value does not start to play until alpha value is greater than 0.01f, causes play calls to be delayed unintentionally if canvas alpha value is set to mentioned value range ([38aec2e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/38aec2ea1afd77677d629c86665a3342d92e49d9))
+
+## [4.11.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.1...v4.11.2) (2025-03-15)
+
+
+### Bug Fixes
+
+* IL2CPP build fails on older versions of Unity ([0da6525](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0da652520cd165b43de7404c0b0ab1fbcf9349d1))
+* NRE on enable ([0cff50e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0cff50ef696aa53fb7c46a9a737b7cf3a05b7b9b)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)
+
+## [4.11.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.0...v4.11.1) (2025-02-21)
+
+
+### Bug Fixes
+
+* component icons will no longer be displayed in the scene view ([6dfbdae](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/6dfbdae38d3822ab9c2c6f0e4ca1ca32ee98a239))
+
+# [4.11.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.7...v4.11.0) (2025-02-21)
 
 
 ### Features
 
-* add project settings for UIParticle ([b6e6185](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b6e6185c521fef0f118f61cfdfdac07b87555c01))
+* add 'TimeScaleMultiplier' option ([925af0b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/925af0b6046f65f23a778f67cefa8ff9cbedb513))
-* change the default value of `UIParticle.scale` from `10` to `1` ([1b3c0f9](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1b3c0f92dcc6a1974d1ea074821e5264200e9711)), closes [#310](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/310)
+
-* UIParticle no longer inherits from MaskableGraphic ([b6d921b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b6d921b3e47f749b5028d22b0e89b6eb3a1af7de))
+## [4.10.7](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.6...v4.10.7) (2025-01-14)
 
 
-### BREAKING CHANGES
+### Bug Fixes
 
-* Some members inherited from MaskableGraphic will no longer be available.
+* editor crashed on exit play mode (editor, windows) ([47ee45c](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/47ee45cbbe651a8f87ca2b8a3948f8b88db8211e)), closes [#351](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/351)
+
+## [4.10.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.5...v4.10.6) (2025-01-03)
+
+
+### Bug Fixes
+
+* sub-emitter particles may not render correctly in certain scenarios ([8276684](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/8276684c3b1646f0490ed64557547ba15281664a)), closes [#348](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/348)
+* sub-emitter's `inherit velocity` module doubles at runtime ([67de3d1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/67de3d1bd3e16dc9b564625cb990c53d75769506)), closes [#349](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/349)
+
+## [4.10.5](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.4...v4.10.5) (2024-12-23)
+
+
+### Bug Fixes
+
+* '3D' scale toggle in the inspector does not keep on reload ([934f4b8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/934f4b8f1c61f8ff20228d0ebcea9f636a3758ed)), closes [#346](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/346)
+
+## [4.10.4](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.3...v4.10.4) (2024-12-19)
+
+
+### Bug Fixes
+
+* rendering issues when playing with opening a prefab stage ([95235a9](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/95235a929b82cf681365ed6eba837d857f83e3d2)), closes [#345](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/345)
+
+## [4.10.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.2...v4.10.3) (2024-11-20)
+
+
+### Bug Fixes
+
+* if not configured as a preloaded asset, the project settings asset will be regenerated ([abe0948](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/abe09485f65dd4efd18e74675e752e0213bdf3be)), closes [#342](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/342)
+
+## [4.10.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.1...v4.10.2) (2024-11-01)
+
+
+### Bug Fixes
+
+* trail incorrect offset ([afe00a1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/afe00a1dde80eb1c0a7bb668b75f4c3733d3fa43)), closes [#335](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/335)
+
+## [4.10.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.0...v4.10.1) (2024-09-29)
+
+
+### Bug Fixes
+
+* mainTex will be ignored ([2ee69d0](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/2ee69d04245fabce185f67dc9bd68c870e556564))
+
+# [4.10.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.9.1...v4.10.0) (2024-09-29)
+
+
+### Bug Fixes
+
+* component icon is not set ([5ff6ec8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5ff6ec815a174de5d3f16d424f1204c60912a8d8))
+
+
+### Features
+
+* add project settings ([1ce4e31](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1ce4e31a9681bf1a201d2723c8d97e07ecc16592))
+
+## [4.9.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.9.0...v4.9.1) (2024-08-07)
+
+
+### Bug Fixes
+
+* ParticleSystem trails gain offset on parent canvas change ([2a1cd50](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/2a1cd502b452b5b56edf8bcfe91adf99d1bb5147)), closes [#323](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/323)
+
+# [4.9.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.8.1...v4.9.0) (2024-07-18)
+
+
+### Features
+
+* ParticleAttractor supports multiple ParticleSystems ([3834780](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/3834780fdb43443fe6e1ef89df54d26a24d62a91))
+
+## [4.8.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.8.0...v4.8.1) (2024-06-27)
+
+
+### Bug Fixes
+
+* remove debug code ([669deb4](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/669deb41d4ac589d9db93b29bc8e95383e7f28a5))
+
+# [4.8.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.7.2...v4.8.0) (2024-06-27)
+
+
+### Bug Fixes
+
+* generated baking-camera object remains in the prefab or scene (again) ([de35cba](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/de35cba34c6312c1405ed522e9927c620c78e72d))
+* SetParticleSystemInstance/Prefab APIs destroy generated objects ([ae3f3a8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ae3f3a8e62cc733420354d237ab765ac777127c8))
+
+
+### Features
+
+* add 'custom view' option. ([a703c29](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a703c2921ca08c2280d0c8fde01e4c0b33b5c69e))
+* remove overlay window (editor) ([8358170](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/835817049f4fcf00dd2bf98dbada14f041ad3544))
+* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` (again) ([88a970d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/88a970d93a2b69cf011d86bd1807569e90538e0e))
+* the rendering order list in inspector is now more compact ([be90172](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/be901724e064befacf617f4940b0331e1d31e1ca))
+
+## [4.7.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.7.1...v4.7.2) (2024-06-21)
+
+
+### Bug Fixes
+
+* generated baking-camera object remains in the prefab or scene ([0bb8438](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0bb843830197d8c1252232928becc211c0ada08d))
+
+## [4.7.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.7.0...v4.7.1) (2024-06-20)
+
+
+### Bug Fixes
+
+* despite not using the size module, particles become smaller based on their z position ([a8ed6e6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a8ed6e68584e1d9e45ed852eefcc03979ea7e0e1)), closes [#316](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/316)
+
+# [4.7.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.8...v4.7.0) (2024-06-19)
+
+
+### Bug Fixes
+
+* `UIParticle.transform.localScale` does not scale particles ([1d40e24](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1d40e24c742741e97f03c55468ccb1e505341133)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+* UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` ([54a4b1c](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/54a4b1cdfd06400c7be89c1ee704bb42a659c7c2)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+* UIParticle is scaled incorrectly with nested canvases ([f26920f](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/f26920f9825547222a4afbb31cc5dc5a002c3e9b)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+
+
+### Features
+
+* reset previous position on start play for world space simulation ([3880484](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/3880484ce5190c42fc79c81d0b69e3fbeda09dd0)), closes [#303](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/303)
+* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` ([5505247](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5505247a94a929ff89635fde512a9b95691e0043))
+
+## [4.6.8](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.7...v4.6.8) (2024-06-14)
+
+
+### Bug Fixes
+
+* 'Resource ID out of range in GetResource' error in overlay rendering mode ([05286ce](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/05286cedfd17b1a0cb90a5e918513644f47cd831)), closes [#308](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/308)
+
+## [4.6.7](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.6...v4.6.7) (2024-05-24)
+
+
+### Bug Fixes
+
+* the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues ([e924eb4](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/e924eb45968a112347471cabaeabc274e4c37ce4)), closes [#299](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/299) [#312](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/312)
 
 ## [4.6.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.5...v4.6.6) (2024-05-23)
 

Editor/AnimatablePropertyEditor.cs

@@ -3,15 +3,19 @@ using System.Linq;
 using System.Text;
 using UnityEditor;
 using UnityEngine;
+using ShaderPropertyType = Coffee.UIExtensions.AnimatableProperty.ShaderPropertyType;
 
 namespace Coffee.UIExtensions
 {
     internal static class AnimatablePropertyEditor
     {
         private static readonly GUIContent s_ContentNothing = new GUIContent("Nothing");
+        private static readonly GUIContent s_ContentCustom = new GUIContent("Add Custom...");
         private static readonly List<string> s_ActiveNames = new List<string>();
         private static readonly StringBuilder s_Sb = new StringBuilder();
         private static readonly HashSet<string> s_Names = new HashSet<string>();
+        private static ShaderProperty s_CustomProperty = new ShaderProperty("", ShaderPropertyType.None);
+        private static bool s_ShowCustomProperty = false;
 
         private static string CollectActiveNames(SerializedProperty sp, List<string> result)
         {
@@ -51,8 +55,19 @@ namespace Coffee.UIExtensions
                 ? "-"
                 : CollectActiveNames(sp, s_ActiveNames);
 
-            if (!GUI.Button(rect, text, EditorStyles.popup)) return;
+            if (GUI.Button(rect, text, EditorStyles.popup))
+            {
+                ShowMenu(sp, mats);
+            }
 
+            if (s_ShowCustomProperty)
+            {
+                DrawCustomProperty(sp, ref s_CustomProperty);
+            }
+        }
+
+        private static void ShowMenu(SerializedProperty sp, List<Material> mats)
+        {
             var gm = new GenericMenu();
             gm.AddItem(s_ContentNothing, s_ActiveNames.Count == 0, x =>
             {
@@ -61,13 +76,20 @@ namespace Coffee.UIExtensions
                 current.serializedObject.ApplyModifiedProperties();
             }, sp);
 
+            gm.AddItem(s_ContentCustom, s_ShowCustomProperty, () =>
+            {
+                s_ShowCustomProperty = !s_ShowCustomProperty;
+                s_CustomProperty.Reset();
+            });
+            gm.AddSeparator("");
+
             if (!sp.hasMultipleDifferentValues)
             {
                 for (var i = 0; i < sp.arraySize; i++)
                 {
                     var p = sp.GetArrayElementAtIndex(i);
                     var name = p.FindPropertyRelative("m_Name").stringValue;
-                    var type = (AnimatableProperty.ShaderPropertyType)p.FindPropertyRelative("m_Type").intValue;
+                    var type = (ShaderPropertyType)p.FindPropertyRelative("m_Type").intValue;
                     AddMenu(gm, sp, new ShaderProperty(name, type), false);
                 }
             }
@@ -76,17 +98,26 @@ namespace Coffee.UIExtensions
             for (var j = 0; j < mats.Count; j++)
             {
                 var mat = mats[j];
-                if (!mat || !mat.shader) continue;
+                if (mat == null || mat.shader == null) continue;
 
+#if UNITY_6000_5_OR_NEWER
+                for (var i = 0; i < mat.shader.GetPropertyCount(); i++)
+#else
                 for (var i = 0; i < ShaderUtil.GetPropertyCount(mat.shader); i++)
+#endif
                 {
+#if UNITY_6000_5_OR_NEWER
+                    var name = mat.shader.GetPropertyName(i);
+                    var type = (ShaderPropertyType)mat.shader.GetPropertyType(i);
+#else
                     var name = ShaderUtil.GetPropertyName(mat.shader, i);
-                    var type = (AnimatableProperty.ShaderPropertyType)ShaderUtil.GetPropertyType(mat.shader, i);
+                    var type = (ShaderPropertyType)ShaderUtil.GetPropertyType(mat.shader, i);
+#endif
                     if (!s_Names.Add(name)) continue;
 
                     AddMenu(gm, sp, new ShaderProperty(name, type), true);
 
-                    if (type != AnimatableProperty.ShaderPropertyType.Texture) continue;
+                    if (type != ShaderPropertyType.Texture) continue;
 
                     AddMenu(gm, sp, new ShaderProperty($"{name}_ST"), true);
                     AddMenu(gm, sp, new ShaderProperty($"{name}_HDR"), true);
@@ -102,7 +133,35 @@ namespace Coffee.UIExtensions
             if (add && s_ActiveNames.Contains(prop.name)) return;
 
             var label = new GUIContent($"{prop.name} ({prop.type})");
-            menu.AddItem(label, s_ActiveNames.Contains(prop.name), () =>
+            menu.AddItem(label, s_ActiveNames.Contains(prop.name), () => AddProp(sp, prop));
+        }
+
+        private static void DrawCustomProperty(SerializedProperty sp, ref ShaderProperty prop)
+        {
+            var r = EditorGUILayout.GetControlRect(false, EditorGUIUtility.singleLineHeight + 8);
+            r.xMin += 60;
+            GUI.Label(r, (Texture)null, EditorStyles.helpBox);
+
+            r = new Rect(r.x + 4, r.y + 4, r.width - 8 - 100 - 16, r.height - 8);
+            prop.name = EditorGUI.TextField(r, prop.name);
+            r.x += r.width + 2;
+            r.width = 100 - 2;
+            prop.type = (ShaderPropertyType)EditorGUI.EnumPopup(r, prop.type);
+            r.x += r.width;
+            r.width = 16;
+
+            EditorGUI.BeginDisabledGroup(!prop.IsValid(s_ActiveNames));
+            if (GUI.Button(r, EditorGUIUtility.IconContent("Toolbar Plus"), EditorStyles.label))
+            {
+                GUI.FocusControl("");
+                AddProp(sp, prop);
+                prop.Reset();
+            }
+
+            EditorGUI.EndDisabledGroup();
+        }
+
+        private static void AddProp(SerializedProperty sp, ShaderProperty prop)
         {
             var index = s_ActiveNames.IndexOf(prop.name);
             if (0 <= index)
@@ -118,25 +177,38 @@ namespace Coffee.UIExtensions
             }
 
             sp.serializedObject.ApplyModifiedProperties();
-            });
         }
 
         private struct ShaderProperty
         {
-            public readonly string name;
+            public string name;
-            public readonly AnimatableProperty.ShaderPropertyType type;
+            public ShaderPropertyType type;
 
             public ShaderProperty(string name)
             {
                 this.name = name;
-                type = AnimatableProperty.ShaderPropertyType.Vector;
+                type = ShaderPropertyType.Vector;
             }
 
-            public ShaderProperty(string name, AnimatableProperty.ShaderPropertyType type)
+            public ShaderProperty(string name, ShaderPropertyType type)
             {
                 this.name = name;
                 this.type = type;
             }
+
+            public void Reset()
+            {
+                name = "";
+                type = ShaderPropertyType.None;
+            }
+
+            public bool IsValid(List<string> activeNames)
+            {
+                if (string.IsNullOrEmpty(name)) return false;
+                if (type == ShaderPropertyType.None) return false;
+                if (activeNames.Contains(name)) return false;
+                return true;
+            }
         }
     }
 }

Editor/UIParticleEditor.cs

@@ -1,21 +1,20 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
 using UnityEditor;
+using UnityEditor.UI;
 using UnityEditorInternal;
 using UnityEngine;
 using UnityEngine.Profiling;
 using UnityEngine.UI;
-
+using Coffee.UIParticleInternal;
+using Object = UnityEngine.Object;
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.Overlays;
 #else
-using System;
 using System.Reflection;
-using Coffee.UIParticleInternal;
-using Object = UnityEngine.Object;
 #endif
-
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.SceneManagement;
 
@@ -27,8 +26,13 @@ namespace Coffee.UIExtensions
 {
     [CustomEditor(typeof(UIParticle))]
     [CanEditMultipleObjects]
-    internal class UIParticleEditor : Editor
+    internal class UIParticleEditor : GraphicEditor
     {
+        internal class State : ScriptableSingleton<State>
+        {
+            public bool is3DScaleMode;
+        }
+
         //################################
         // Constant or Static Members.
         //################################
@@ -45,9 +49,9 @@ namespace Coffee.UIExtensions
         private static readonly GUIContent s_ContentRandom = new GUIContent("Random");
         private static readonly GUIContent s_ContentScale = new GUIContent("Scale");
         private static readonly GUIContent s_ContentPrimary = new GUIContent("Primary");
+        private static readonly GUIContent s_ViewSize = new GUIContent("View Size");
         private static readonly Regex s_RegexBuiltInGuid = new Regex(@"^0{16}.0{15}$", RegexOptions.Compiled);
         private static readonly List<Material> s_TempMaterials = new List<Material>();
-        private static bool s_XYZMode;
 
         private SerializedProperty _maskable;
         private SerializedProperty _scale3D;
@@ -59,8 +63,11 @@ namespace Coffee.UIExtensions
         private SerializedProperty _autoScalingMode;
         private SerializedProperty _useCustomView;
         private SerializedProperty _customViewSize;
+        private SerializedProperty _timeScaleMultiplier;
         private ReorderableList _ro;
         private bool _showMax;
+        private bool _is3DScaleMode;
+        private GameObject[] _gameObjects;
 
         private static readonly HashSet<Shader> s_Shaders = new HashSet<Shader>();
 #if UNITY_2018 || UNITY_2019
@@ -82,8 +89,10 @@ namespace Coffee.UIExtensions
         /// <summary>
         /// This function is called when the object becomes enabled and active.
         /// </summary>
-        private void OnEnable()
+        protected override void OnEnable()
         {
+            base.OnEnable();
+
             _maskable = serializedObject.FindProperty("m_Maskable");
             _scale3D = serializedObject.FindProperty("m_Scale3D");
             _animatableProperties = serializedObject.FindProperty("m_AnimatableProperties");
@@ -94,6 +103,7 @@ namespace Coffee.UIExtensions
             _autoScalingMode = serializedObject.FindProperty("m_AutoScalingMode");
             _useCustomView = serializedObject.FindProperty("m_UseCustomView");
             _customViewSize = serializedObject.FindProperty("m_CustomViewSize");
+            _timeScaleMultiplier = serializedObject.FindProperty("m_TimeScaleMultiplier");
 
             var sp = serializedObject.FindProperty("m_Particles");
             _ro = new ReorderableList(sp.serializedObject, sp, true, true, true, true)
@@ -102,7 +112,7 @@ namespace Coffee.UIExtensions
                 {
                     var ps = sp.GetArrayElementAtIndex(index).objectReferenceValue as ParticleSystem;
                     var materialCount = 0;
-                    if (ps && ps.TryGetComponent<ParticleSystemRenderer>(out var psr))
+                    if (ps != null && ps.TryGetComponent<ParticleSystemRenderer>(out var psr))
                     {
                         materialCount = psr.sharedMaterials.Length;
                     }
@@ -116,7 +126,7 @@ namespace Coffee.UIExtensions
                     var p = sp.GetArrayElementAtIndex(index);
                     EditorGUI.ObjectField(rect, p, GUIContent.none);
                     var ps = p.objectReferenceValue as ParticleSystem;
-                    if (!ps || !ps.TryGetComponent<ParticleSystemRenderer>(out var psr)) return;
+                    if (ps == null || !ps.TryGetComponent<ParticleSystemRenderer>(out var psr)) return;
 
                     rect.x += 15;
                     rect.width -= 15;
@@ -162,6 +172,26 @@ namespace Coffee.UIExtensions
                     uip.RefreshParticles(uip.particles);
                 }
             }
+
+            // Initialize 3D scale mode.
+            _is3DScaleMode = State.instance.is3DScaleMode;
+            if (!_is3DScaleMode)
+            {
+                var x = _scale3D.FindPropertyRelative("x");
+                var y = _scale3D.FindPropertyRelative("y");
+                var z = _scale3D.FindPropertyRelative("z");
+                _is3DScaleMode = !Mathf.Approximately(x.floatValue, y.floatValue) ||
+                                 !Mathf.Approximately(y.floatValue, z.floatValue) ||
+                                 y.hasMultipleDifferentValues ||
+                                 z.hasMultipleDifferentValues;
+            }
+
+            // Add temporary ParticleSystem for preview if enabled.
+            if (UIParticleProjectSettings.previewOnSelect)
+            {
+                _gameObjects = targets.OfType<UIParticle>().Select(x => x.gameObject).ToArray();
+                ParticleSystemPreviewSystem.Register(_gameObjects);
+            }
         }
 
         /// <summary>
@@ -170,17 +200,24 @@ namespace Coffee.UIExtensions
         public override void OnInspectorGUI()
         {
             var current = target as UIParticle;
-            if (!current) return;
+            if (current == null) return;
 
             Profiler.BeginSample("(UIP:E) OnInspectorGUI");
             serializedObject.Update();
 
             // Maskable
+            if (_maskable != null)
+            {
                 EditorGUILayout.PropertyField(_maskable);
+            }
 
             // Scale
             EditorGUI.BeginDisabledGroup(!_meshSharing.hasMultipleDifferentValues && _meshSharing.intValue == 4);
-            s_XYZMode = DrawFloatOrVector3Field(_scale3D, s_XYZMode);
+            if (DrawFloatOrVector3Field(_scale3D, _is3DScaleMode) != _is3DScaleMode)
+            {
+                State.instance.is3DScaleMode = _is3DScaleMode = !_is3DScaleMode;
+            }
+
             EditorGUI.EndDisabledGroup();
 
             // AnimatableProperties
@@ -210,16 +247,27 @@ namespace Coffee.UIExtensions
 
             // Custom View Size
             EditorGUILayout.PropertyField(_useCustomView);
-            EditorGUI.BeginChangeCheck();
-            EditorGUI.BeginDisabledGroup(!_useCustomView.boolValue);
             EditorGUI.indentLevel++;
+            if (_useCustomView.boolValue)
+            {
+                EditorGUI.BeginChangeCheck();
                 EditorGUILayout.PropertyField(_customViewSize);
-            EditorGUI.indentLevel--;
-            EditorGUI.EndDisabledGroup();
                 if (EditorGUI.EndChangeCheck())
                 {
                     _customViewSize.floatValue = Mathf.Max(0.1f, _customViewSize.floatValue);
                 }
+            }
+            else
+            {
+                EditorGUI.BeginDisabledGroup(!_useCustomView.boolValue);
+                EditorGUILayout.FloatField(s_ViewSize, UIParticleProjectSettings.defaultViewSizeForBaking);
+                EditorGUI.EndDisabledGroup();
+            }
+
+            EditorGUI.indentLevel--;
+
+            // Time Scale Multiplier
+            EditorGUILayout.PropertyField(_timeScaleMultiplier);
 
             // Target ParticleSystems.
             EditorGUI.BeginChangeCheck();
@@ -239,7 +287,7 @@ namespace Coffee.UIExtensions
             Profiler.BeginSample("(UIP:E) Non-UI built-in shader is not supported.");
             foreach (var mat in s_TempMaterials)
             {
-                if (!mat || !mat.shader) continue;
+                if (mat == null || mat.shader == null) continue;
                 var shader = mat.shader;
                 if (IsBuiltInObject(shader) && !shader.name.StartsWith("UI/"))
                 {
@@ -258,7 +306,7 @@ namespace Coffee.UIExtensions
             {
                 foreach (var mat in s_TempMaterials)
                 {
-                    if (!mat || !mat.shader) continue;
+                    if (mat == null || mat.shader == null) continue;
                     var shader = mat.shader;
                     if (!s_Shaders.Add(shader)) continue;
 
@@ -316,8 +364,11 @@ namespace Coffee.UIExtensions
                 }
             }
 #endif
+
+            // Remove the temporary ParticleSystem.
+            ParticleSystemPreviewSystem.DrawWarningForTemporary(_gameObjects);
+
             Profiler.EndSample();
-            EditorApplication.delayCall += () => Profiler.enabled = false;
         }
 
         private static bool IsBuiltInObject(Object obj)
@@ -437,7 +488,9 @@ namespace Coffee.UIExtensions
         {
             if (!p || (ignoreCurrent && target == p)) return;
 
+            var cr = p.canvasRenderer;
             DestroyImmediate(p);
+            DestroyImmediate(cr);
 
 #if UNITY_2018_3_OR_NEWER
             var stage = PrefabStageUtility.GetCurrentPrefabStage();
@@ -453,7 +506,7 @@ namespace Coffee.UIExtensions
 #endif
         }
 
-        private static bool FixButton(bool show, string text)
+        private static bool FixButton(bool show, string text, GUIContent buttonText = null)
         {
             if (!show) return false;
             using (new EditorGUILayout.HorizontalScope(GUILayout.ExpandWidth(true)))
@@ -461,7 +514,7 @@ namespace Coffee.UIExtensions
                 EditorGUILayout.HelpBox(text, MessageType.Warning, true);
                 using (new EditorGUILayout.VerticalScope())
                 {
-                    return GUILayout.Button(s_ContentFix, GUILayout.Width(30));
+                    return GUILayout.Button(buttonText ?? s_ContentFix, GUILayout.ExpandWidth(false));
                 }
             }
         }

Editor/UIParticleMenu.cs

@@ -6,11 +6,22 @@ namespace Coffee.UIExtensions
 {
     internal class UIParticleMenu
     {
-        [MenuItem("GameObject/UI/Particle System (Empty)", false, 2018)]
+#if UNITY_6000_5_OR_NEWER
+        private const string k_MenuPathToCreateParticleSystem = "GameObject/Visual Effects/Particle System";
+#else
+        private const string k_MenuPathToCreateParticleSystem = "GameObject/Effects/Particle System";
+#endif
+#if UNITY_6000_3_OR_NEWER
+        private const string k_MenuPathForUgui = "GameObject/UI (Canvas)";
+#else
+        private const string k_MenuPathForUgui = "GameObject/UI";
+#endif
+
+        [MenuItem(k_MenuPathForUgui + "/Particle System (Empty)", false, 2018)]
         private static void AddParticleEmpty(MenuCommand menuCommand)
         {
             // Create empty UI element.
-            EditorApplication.ExecuteMenuItem("GameObject/UI/Image");
+            EditorApplication.ExecuteMenuItem(k_MenuPathForUgui + "/Image");
             var ui = Selection.activeGameObject;
             Object.DestroyImmediate(ui.GetComponent<Image>());
 
@@ -21,7 +32,7 @@ namespace Coffee.UIExtensions
             uiParticle.rectTransform.sizeDelta = Vector2.zero;
         }
 
-        [MenuItem("GameObject/UI/Particle System", false, 2019)]
+        [MenuItem(k_MenuPathForUgui + "/Particle System", false, 2019)]
         private static void AddParticle(MenuCommand menuCommand)
         {
             // Create empty UIEffect.
@@ -29,7 +40,7 @@ namespace Coffee.UIExtensions
             var uiParticle = Selection.activeGameObject.GetComponent<UIParticle>();
 
             // Create ParticleSystem.
-            EditorApplication.ExecuteMenuItem("GameObject/Effects/Particle System");
+            EditorApplication.ExecuteMenuItem(k_MenuPathToCreateParticleSystem);
             var ps = Selection.activeGameObject;
             ps.transform.SetParent(uiParticle.transform, false);
             ps.transform.localPosition = Vector3.zero;

LICENSE.md

@@ -1,4 +1,4 @@
-Copyright 2018-2024 mob-sakai
+Copyright 2018-2026 mob-sakai
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -1,28 +1,62 @@
-# <img alt="UIParticleIcon" src="https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/d76e105e-a840-4f61-a1f6-8cf311c0812d" width="26"/> Particle Effect For UGUI (UI Particle)
+# <img alt="UIParticleIcon" src="https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/d76e105e-a840-4f61-a1f6-8cf311c0812d" width="26"/> Particle Effect For UGUI (UI Particle) <!-- omit in toc -->
-
-This package provides a component to render particle effects for uGUI in Unity 2018.2 or later.  
-The particle rendering is maskable and sortable, without the need for an extra Camera, RenderTexture, or Canvas.
 
 [![](https://img.shields.io/npm/v/com.coffee.ui-particle?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.coffee.ui-particle/)
-[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI?include_prereleases)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
+[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
-[![](https://img.shields.io/github/license/mob-sakai/ParticleEffectForUGUI.svg)](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/main/LICENSE.txt)  
+[![](https://img.shields.io/github/license/mob-sakai/ParticleEffectForUGUI.svg)](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/main/LICENSE.md)  
 ![](https://img.shields.io/badge/Unity-2018.2+-57b9d3.svg?style=flat&logo=unity)
+![](https://img.shields.io/badge/uGUI_2.0_Ready-57b9d3.svg?style=flat)
+![](https://img.shields.io/badge/UPR%2FHDPR_Ready-57b9d3.svg?style=flat)  
 ![](https://github.com/mob-sakai/ParticleEffectForUGUI/actions/workflows/test.yml/badge.svg?branch=develop)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-orange.svg)](http://makeapullrequest.com)
+[![](https://img.shields.io/github/watchers/mob-sakai/ParticleEffectForUGUI.svg?style=social&label=Watch)](https://github.com/mob-sakai/ParticleEffectForUGUI/subscription)
 [![](https://img.shields.io/twitter/follow/mob_sakai.svg?label=Follow&style=social)](https://twitter.com/intent/follow?screen_name=mob_sakai)
 
-<< [📝 Description](#-description) | [🎮 Demo](#-demo) | [⚙ Installation](#-installation) | [🚀 Usage](#-usage) | [🛠 Development Note](#-development-note) | [🤝 Contributing](#-contributing) >>
+<< [📝 Description](#-description-) | [📌 Key Features](#-key-features) | [🎮 Demo](#-demo) | [⚙ Installation](#-installation) | [🚀 Usage](#-usage) | [🛠 Development Note](#-development-note) | [🤝 Contributing](#-contributing) >>
+
+## 📝 Description <!-- omit in toc -->
+
+![](https://user-images.githubusercontent.com/12690315/41771577-8da4b968-7650-11e8-9524-cd162c422d9d.gif)
+
+This package uses the new APIs `MeshBake/MeshTrailBake` (introduced in Unity 2018.2) to render particles through `CanvasRenderer`.  
+You can render, mask, and sort your `ParticleSystems` for UI without the need for an additional `Camera`, `RenderTexture`, or `Canvas`.
+
+- [📌 Key Features](#-key-features)
+- [🎮 Demo](#-demo)
+- [⚙ Installation](#-installation)
+    - [Install via OpenUPM](#install-via-openupm)
+    - [Install via UPM (with Package Manager UI)](#install-via-upm-with-package-manager-ui)
+    - [Install via UPM (Manually)](#install-via-upm-manually)
+    - [Install as Embedded Package](#install-as-embedded-package)
+- [🚀 Usage](#-usage)
+  - [Component: UIParticle](#component-uiparticle)
+  - [Basic Usage](#basic-usage)
+  - [Usage with Your Existing ParticleSystem Prefab](#usage-with-your-existing-particlesystem-prefab)
+  - [Usage with `Mask` or `RectMask2D` Component](#usage-with-mask-or-rectmask2d-component)
+  - [Usage with Script](#usage-with-script)
+  - [Component: UIParticleAttractor](#component-uiparticleattractor)
+  - [Component: ParticleSystemPreviewer](#component-particlesystempreviewer)
+  - [Project Settings](#project-settings)
+- [🛠 Development Note](#-development-note)
+  - [Compares the Baking mesh approach with the conventional approach](#compares-the-baking-mesh-approach-with-the-conventional-approach)
+    - [Performance test results](#performance-test-results)
+  - [🔍 FAQ: Why Are My UIParticles Not Displayed Correctly?](#-faq-why-are-my-uiparticles-not-displayed-correctly)
+  - [Shader Limitation](#shader-limitation)
+    - [Built-in shaders are not supported](#built-in-shaders-are-not-supported)
+    - [(Unity 2018 or 2019) UV.zw components will be discarded](#unity-2018-or-2019-uvzw-components-will-be-discarded)
+    - [(Unity 2018 or 2019) Custom vertex streams](#unity-2018-or-2019-custom-vertex-streams)
+  - [Overheads](#overheads)
+  - [How to Make a Custom Shader to Support `Mask` and `RectMask2D` Component](#how-to-make-a-custom-shader-to-support-mask-and-rectmask2d-component)
+- [🤝 Contributing](#-contributing)
+  - [Issues](#issues)
+  - [Pull Requests](#pull-requests)
+  - [Support](#support)
+- [License](#license)
+- [Author](#author)
+- [See Also](#see-also)
 
 <br><br>
 
-## 📝 Description
+## 📌 Key Features
-
-![Demo](https://user-images.githubusercontent.com/12690315/41771577-8da4b968-7650-11e8-9524-cd162c422d9d.gif)
-
-This package uses the new APIs `MeshBake/MeshTrailBake` (introduced in Unity 2018.2) to render particles through CanvasRenderer.  
-You can render, mask, and sort your ParticleSystems for UI without the need for an additional Camera, RenderTexture, or Canvas.
-
-### Key Features
 
 * **Easy to use:** The package is ready to use out of the box.
 * **Sortable:** Sort particle effects and other UI elements by sibling index.
@@ -83,16 +117,16 @@ _This package requires **Unity 2018.3 or later**._
   ```
 - To update the package, use Package Manager UI (`Window > Package Manager`) or run the following command with `@{version}`:
   ```
-  openupm add com.coffee.ui-particle@4.8.0
+  openupm add com.coffee.ui-particle@4.13.0
   ```
 
 #### Install via UPM (with Package Manager UI)
 
 - Click `Window > Package Manager` to open Package Manager UI.
 - Click `+ > Add package from git URL...` and input the repository URL: `https://github.com/mob-sakai/ParticleEffectForUGUI.git`  
-  ![](https://gist.github.com/assets/12690315/24af63ed-8a2e-483d-9023-7aa53d913330)
+  ![](https://github.com/user-attachments/assets/f88f47ad-c606-44bd-9e86-ee3f72eac548)
 - To update the package, change suffix `#{version}` to the target version.
-  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.8.0`
+  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.13.0`
 
 #### Install via UPM (Manually)
 
@@ -107,11 +141,11 @@ _This package requires **Unity 2018.3 or later**._
   ```
 
 - To update the package, change suffix `#{version}` to the target version.
-  - e.g. `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.8.0",`
+  - e.g. `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.13.0",`
 
 #### Install as Embedded Package
 
-1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI.git/releases) and extract it.
+1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI/releases) and extract it.
 2. Place it in your project's `Packages` directory.  
    ![](https://github.com/mob-sakai/mob-sakai/assets/12690315/0b7484b4-5fca-43b0-a9ef-e5dbd99bcdb4)
 - If you want to fix bugs or add features, install it as an embedded package.
@@ -119,29 +153,24 @@ _This package requires **Unity 2018.3 or later**._
 
 <br><br>
 
-## ⚙ Upgrading from 3.x/4.x to 5.x
-
-### Breaking Changes
-
-- The default value of `UIParticle.scale` has been changed from `10` to `1`.
-- `UIParticle` no longer inherits from `MaskableGraphic`.
-- Add project settings for UIParticle
-  - enableLinearToGamma: Enables LinearToGamma during mesh baking
-
-<br><br>
-
 ## 🚀 Usage
 
-### UIParticle Component
+### Component: UIParticle
 
 `UIParticle` controls the ParticleSystems that are attached to its own game objects and child game objects.
 
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/1cf5753b-33fc-4cef-91c3-413c515a954f)
+![](https://github.com/user-attachments/assets/bc9eb783-afce-4102-ac61-aee9ea8d6f2f)
 
 - **Maskable**: Does this graphic allow maskable.
 - **Scale**: Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.
 - **Animatable Properties**: If you want to update material properties (e.g., `_MainTex_ST`, `_Color`) in AnimationClip,
   use this to mark as animatable.
+
+> [!TIPS]
+> (Unity 2021.1 or later) **Custom Animatable Properties**  
+> From the `Add Custom...` menu in `Animatable Properties`, you can add fields located outside the `Properties` block in the shader as `Animatable Properties`.  
+> This allows `Matrix`, `Matrix Array`, `Float Array`, and `Vector Array` values modified by the `ParticleSystemRenderer.SetPropertyBlock` method to be automatically reflected in UIParticle.
+
 - **Mesh Sharing**: Particle simulation results are shared within the same group. A large number of the same effects can
   be displayed with a small load. When the `Random` toggle is enabled, it will be grouped randomly.
   - **None:** Disable mesh sharing.
@@ -158,23 +187,33 @@ _This package requires **Unity 2018.3 or later**._
   - **UIParticle:** UIParticle.scale will be adjusted.
 - **Use Custom View:** Use this if the particles are not displayed correctly due to min/max particle size.
   - **Custom view size:** Change the bake view size.
+- **Time Scale Multiplier:** Time scale multiplier.
 - **Rendering Order**: The ParticleSystem list to be rendered. You can change the order and the materials.
 
-**NOTE:** Press the `Refresh` button to reconstruct the rendering order based on children ParticleSystem's sorting order
+> [!TIPS]
+> Press the `Refresh` button to reconstruct the rendering order based on children ParticleSystem's sorting order
 and z-position.
 
+> [!TIPS]
+> When a `GameObject` with this component is selected in the editor, a temporary `ParticleSystem` is added if needed so you can preview the effect in the Scene view.
+> The generated `ParticleSystem` is marked with `HideFlags.DontSave`, so it is neither saved nor included in builds.
+
 <br><br>
 
-#### Basic Usage
+### Basic Usage
 
 1. Select `GameObject/UI/ParticleSystem` to create UIParticle with a ParticleSystem.
    ![particle](https://user-images.githubusercontent.com/12690315/95007361-cad0e880-0649-11eb-8835-f145d62c5977.png)
 2. Adjust the ParticleSystem as you like.
    ![particle1](https://user-images.githubusercontent.com/12690315/95007359-ca385200-0649-11eb-8383-627c9750bda8.png)
 
+> [!Tips]
+> Adding a `UIParticle` to the parent is the recommended setup rather than attaching it directly to the `ParticleSystem`.
+> When using `ParticleSystem.emission.rateOverDistance`, it is recommended to move the transform of `UIParticle` rather than the `ParticleSystem`.
+
 <br>
 
-#### With Your Existing ParticleSystem Prefab
+### Usage with Your Existing ParticleSystem Prefab
 
 1. Select `GameObject/UI/ParticleSystem (Empty)` to create UIParticle.
    ![empty](https://user-images.githubusercontent.com/12690315/95007362-cb697f00-0649-11eb-8a09-29b0a13791e4.png)
@@ -183,19 +222,19 @@ and z-position.
 
 <br>
 
-#### With `Mask` or `RectMask2D` Component
+### Usage with `Mask` or `RectMask2D` Component
 
 If you want to mask particles, set a stencil-supported shader (such as `UI/UIAdditive`) to the material for
 ParticleSystem.
 If you use some custom shaders, see
-the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-maskrectmask2d-component)
+the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-mask-and-rectmask2d-component)
 section.
 
 ![](https://user-images.githubusercontent.com/12690315/95017591-3b512700-0695-11eb-864e-04166ea1809a.png)
 
 <br><br>
 
-### Script usage
+### Usage with Script
 
 ```cs
 // Instantiate ParticleSystem prefab with UIParticle on runtime.
@@ -214,14 +253,14 @@ uiParticle.Stop();
 
 <br><br>
 
-### UIParticleAttractor component
+### Component: UIParticleAttractor
 
 `UIParticleAttractor` attracts particles generated by the specified ParticleSystem.
 
 ![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/5c20ad73-4b9a-4f38-9cdc-119df5cce077)
 ![](https://user-images.githubusercontent.com/12690315/174311027-462929a4-13f0-4ec4-86ea-9c832f2eecf1.gif)
 
-- **Particle System**: Attracts particles generated by the specified particle system.
+- **Particle Systems**: Attracts particles generated by the specified ParticleSystems.
 - **Destination Radius**: Once the particle is within the radius, the particle lifetime will become 0, and `OnAttracted`
   will be called.
 - **Delay Rate**: Delay to start attracting. It is a percentage of the particle's start lifetime.
@@ -235,6 +274,37 @@ uiParticle.Stop();
 
 <br><br>
 
+### Component: ParticleSystemPreviewer
+
+`ParticleSystemPreviewer` is used to preview a `ParticleSystem` in the editor.
+
+![](https://github.com/mob-sakai/mob-sakai/releases/download/docs/1782441157549.png)
+
+- When a `GameObject` with this component is selected in the editor, a temporary `ParticleSystem` is added if needed so you can preview the effect in the Scene view.
+- The generated `ParticleSystem` is marked with `HideFlags.DontSave`, so it is neither saved nor included in builds.
+- This component will be removed in builds.
+
+<br><br>
+
+### Project Settings
+
+You can adjust the project-wide settings for `UI Particle`. (`Edit > Project Settings > UI > UI Particle`)
+
+![](https://github.com/mob-sakai/mob-sakai/releases/download/docs/1782360274340.png)
+
+#### Settings
+
+- **Enable Linear To Gamma**: Automatically correct the color space of the mesh.
+- **Default View Size For Baking**: Default view size for baking particle systems.
+
+#### Editor
+
+- **Hide Generated Component**: Automatically hide the generated `UIParticleRenderer` component and `UIParticle BakingCamera`.
+
+- **Preview On Select**: When selecting UIParticle, a temporary ParticleSystem is generated for preview.
+
+<br><br>
+
 ## 🛠 Development Note
 
 ### Compares the Baking mesh approach with the conventional approach
@@ -296,33 +366,39 @@ uiParticle.Stop();
 
 ### 🔍 FAQ: Why Are My UIParticles Not Displayed Correctly?
 
+See [this issue](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/270).
+
 If `ParticleSystem` alone displays particles correctly but `UIParticle` does not, please check the following points:
 
-- [Shader Limitation](#shader-limitation)
+- [Shader Limitation](https://github.com/mob-sakai/ParticleEffectForUGUI#shader-limitation)
-    - `UIParticle` does not support all built-in shaders except for `UI/Default`.
     - Most cases can be solved by using `UI/Additive` or `UI/Default`.
 - Particles are not masked
     - `UIParticle` is maskable.
+    - Use maskable/clipable shader (such as `UI/Additive` or `UI/Default`)
     - Set `Mask` or `RectMask2D` component properly.
-    - [Use maskable/clipable shader](#how-to-make-a-custom-shader-to-support-maskrectmask2d-component) (such
-      as `UI/Additive` or `UI/Default`)
 - Particles are too small
     - If particles are small enough, they will not appear on the screen.
     - Increase the `Scale` value.
     - If you don't want to change the apparent size depending on the resolution, try the `Auto Scaling` option.
 - Particles are too many
     - No more than 65535 vertices can be displayed (for mesh combination limitations).
-    - Please set `Emission` module and `Max Particles` of ParticleSystem properly.
+    - Please set `Emission` module and `Max Particles` of `ParticleSystem` properly.
 - Particles are emitted off-screen.
-    - When `Position Mode = Relative`, particles are emitted from the scaled position of the ParticleSystem, not from
+    - When `Position Mode = Relative`, particles are emitted from the scaled position of the `ParticleSystem`, not from
-      the screen point of the ParticleSystem.
+      the screen point of the `ParticleSystem`.
-    - Place the ParticleSystem in the proper position or try `Position Mode = Absolute`.
+    - Place the `ParticleSystem` in the proper position or try `Position Mode = Absolute`.
 - Attaching `UIParticle` to the same object as `ParticleSystem`
     - `Transform.localScale` will be overridden by the `Auto Scaling` option.
     - It is recommended to place `ParticleSystem` under `UIParticle`.
 - If `Transform.localScale` contains 0, rendering will be skipped.
+- If you are using `Shape` module, please check whether the scale includes 0.
 - Displayed particles are in the correct position but too large/too small
     - Adjust `ParticleSystem.renderer.Min/MaxParticleSize`.
+- If `Trails.RibbonCount` is greater than 1, the following error occurs frequently.
+  - `Failed setting triangles. Some indices are referencing out of bounds vertices. IndexCount: 660, VertexCount: 222`
+- Adding a `UIParticle` to the parent is the recommended setup rather than attaching it directly to the `ParticleSystem`.
+  - When using `ParticleSystem.emission.rateOverDistance`, it is recommended to move the transform of `UIParticle` rather than the `ParticleSystem`.
+- (v4.13.0, v5.0.0-preview.18) Try changing the `Default View Size For Baking` setting under `ProjectSettings > UI > UI Particle` to a value such as 100 or 1000.
 
 <br>
 
@@ -366,7 +442,7 @@ When improving performance, keep the following in mind:
     - Consider a single material, atlasing the sprites, and using `Sprite` mode in the `Texture Sheet Animation` module
       in the ParticleSystem.
 
-### How to Make a Custom Shader to Support Mask/RectMask2D Component
+### How to Make a Custom Shader to Support `Mask` and `RectMask2D` Component
 
 <details>
 <summary>Shader tips</summary>

Runtime/AnimatableProperty.cs

@@ -8,11 +8,18 @@ namespace Coffee.UIExtensions
     {
         public enum ShaderPropertyType
         {
+            None = -1,
             Color,
             Vector,
             Float,
             Range,
-            Texture
+            Texture,
+            Int,
+
+            Matrix = 100,
+            MatrixArray = 101,
+            FloatArray = 102,
+            VectorArray = 103,
         }
 
         [SerializeField] private string m_Name = "";
@@ -32,42 +39,41 @@ namespace Coffee.UIExtensions
 
         public void UpdateMaterialProperties(Material material, MaterialPropertyBlock mpb)
         {
+#if UNITY_2021_1_OR_NEWER
+            if (!mpb.HasProperty(id)) return;
+#else
             if (!material.HasProperty(id)) return;
+#endif
 
             switch (type)
             {
                 case ShaderPropertyType.Color:
-                    var color = mpb.GetColor(id);
+                    material.SetColor(id, mpb.GetColor(id));
-                    if (color != default)
-                    {
-                        material.SetColor(id, color);
-                    }
-
                     break;
                 case ShaderPropertyType.Vector:
-                    var vector = mpb.GetVector(id);
+                    material.SetVector(id, mpb.GetVector(id));
-                    if (vector != default)
-                    {
-                        material.SetVector(id, vector);
-                    }
-
                     break;
                 case ShaderPropertyType.Float:
                 case ShaderPropertyType.Range:
-                    var value = mpb.GetFloat(id);
+                    material.SetFloat(id, mpb.GetFloat(id));
-                    if (!Mathf.Approximately(value, 0))
-                    {
-                        material.SetFloat(id, value);
-                    }
-
                     break;
                 case ShaderPropertyType.Texture:
-                    var tex = mpb.GetTexture(id);
+                    material.SetTexture(id, mpb.GetTexture(id));
-                    if (tex != default(Texture))
+                    break;
-                    {
+                case ShaderPropertyType.Int:
-                        material.SetTexture(id, tex);
+                    material.SetInt(id, mpb.GetInt(id));
-                    }
+                    break;
-
+                case ShaderPropertyType.Matrix:
+                    material.SetMatrix(id, mpb.GetMatrix(id));
+                    break;
+                case ShaderPropertyType.MatrixArray:
+                    material.SetMatrixArray(id, mpb.GetMatrixArray(id));
+                    break;
+                case ShaderPropertyType.FloatArray:
+                    material.SetFloatArray(id, mpb.GetFloatArray(id));
+                    break;
+                case ShaderPropertyType.VectorArray:
+                    material.SetVectorArray(id, mpb.GetVectorArray(id));
                     break;
             }
         }

Runtime/Coffee.UIParticle.R.dll.meta

@@ -0,0 +1,33 @@
+fileFormatVersion: 2
+guid: 4d73b3825bf044d418ae21bb331d3902
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  defineConstraints: []
+  isPreloaded: 0
+  isOverridable: 1
+  isExplicitlyReferenced: 0
+  validateReferences: 1
+  platformData:
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        DefaultValueInitialized: true
+  - first:
+      Windows Store Apps: WindowsStoreApps
+    second:
+      enabled: 0
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Runtime/Internal/Extensions/CanvasExtensions.cs

@@ -98,7 +98,7 @@ namespace Coffee.UIParticleInternal
             Profiler.BeginSample("(COF)[CanvasExt] GetViewProjectionMatrix");
             var rootCanvas = canvas.rootCanvas;
             var cam = rootCanvas.worldCamera;
-            if (rootCanvas && rootCanvas.renderMode != RenderMode.ScreenSpaceOverlay && cam)
+            if (rootCanvas != null && rootCanvas.renderMode != RenderMode.ScreenSpaceOverlay && cam != null)
             {
                 if (eye == Camera.MonoOrStereoscopicEye.Mono)
                 {

Runtime/Internal/Extensions/ComponentExtensions.cs

@@ -12,16 +12,43 @@ namespace Coffee.UIParticleInternal
     /// </summary>
     internal static class ComponentExtensions
     {
+#if !UNITY_2019_2_OR_NEWER
+        public static bool TryGetComponent<T>(this GameObject self, out T component)
+            where T : Component
+        {
+            if (self == null)
+            {
+                component = null;
+                return false;
+            }
+
+            component = self.GetComponent<T>();
+            return component != null;
+        }
+
+        public static bool TryGetComponent<T>(this Component self, out T component)
+            where T : Component
+        {
+            if (self == null)
+            {
+                component = null;
+                return false;
+            }
+
+            return self.gameObject.TryGetComponent(out component);
+        }
+#endif
+
         /// <summary>
         /// Get components in children of a specific type in the hierarchy of a GameObject.
         /// </summary>
         public static T[] GetComponentsInChildren<T>(this Component self, int depth)
             where T : Component
         {
-            var results = ListPool<T>.Rent();
+            var results = InternalListPool<T>.Rent();
             self.GetComponentsInChildren_Internal(results, depth);
             var array = results.ToArray();
-            ListPool<T>.Return(ref results);
+            InternalListPool<T>.Return(ref results);
             return array;
         }
 
@@ -38,7 +65,7 @@ namespace Coffee.UIParticleInternal
         private static void GetComponentsInChildren_Internal<T>(this Component self, List<T> results, int depth)
             where T : Component
         {
-            if (!self || results == null || depth < 0) return;
+            if (self == null || results == null || depth < 0) return;
 
             var tr = self.transform;
             if (tr.TryGetComponent<T>(out var t))
@@ -59,7 +86,7 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         public static T GetOrAddComponent<T>(this Component self) where T : Component
         {
-            if (!self) return null;
+            if (self == null) return null;
             return self.TryGetComponent<T>(out var component)
                 ? component
                 : self.gameObject.AddComponent<T>();
@@ -72,7 +99,7 @@ namespace Coffee.UIParticleInternal
         {
             T component = null;
             var transform = self.transform;
-            while (transform)
+            while (transform != null)
             {
                 if (transform.TryGetComponent<T>(out var c))
                 {
@@ -93,7 +120,7 @@ namespace Coffee.UIParticleInternal
             where T : Component
         {
             var tr = includeSelf ? self.transform : self.transform.parent;
-            while (tr)
+            while (tr != null)
             {
                 if (tr.TryGetComponent<T>(out var c) && valid(c)) return c;
                 if (tr == stopAfter) return null;
@@ -134,14 +161,43 @@ namespace Coffee.UIParticleInternal
             Profiler.EndSample();
         }
 
+        /// <summary>
+        /// Add a component of a specific type to the children of a GameObject.
+        /// </summary>
+        public static void AddComponentOnChildren<T>(this Component self, bool includeSelf)
+            where T : Component
+        {
+            if (self == null) return;
+
+            Profiler.BeginSample("(COF)[ComponentExt] AddComponentOnChildren > Self");
+            if (includeSelf && !self.TryGetComponent<T>(out _))
+            {
+                self.gameObject.AddComponent<T>();
+            }
+
+            Profiler.EndSample();
+
+            Profiler.BeginSample("(COF)[ComponentExt] AddComponentOnChildren > Child");
+            var childCount = self.transform.childCount;
+            for (var i = 0; i < childCount; i++)
+            {
+                var child = self.transform.GetChild(i);
+                if (child.TryGetComponent<T>(out _)) continue;
+
+                child.gameObject.AddComponent<T>();
+            }
+
+            Profiler.EndSample();
+        }
+
 #if !UNITY_2021_2_OR_NEWER && !UNITY_2020_3_45 && !UNITY_2020_3_46 && !UNITY_2020_3_47 && !UNITY_2020_3_48
         public static T GetComponentInParent<T>(this Component self, bool includeInactive) where T : Component
         {
-            if (!self) return null;
+            if (self == null) return null;
             if (!includeInactive) return self.GetComponentInParent<T>();
 
             var current = self.transform;
-            while (current)
+            while (current != null)
             {
                 if (current.TryGetComponent<T>(out var c)) return c;
                 current = current.parent;
@@ -157,7 +213,7 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         internal static bool CanConvertTo<T>(this Object context) where T : MonoBehaviour
         {
-            return context && context.GetType() != typeof(T);
+            return context != null && context.GetType() != typeof(T);
         }
 
         /// <summary>
@@ -175,7 +231,7 @@ namespace Coffee.UIParticleInternal
             target.enabled = false;
 
             // Find MonoScript of the specified component.
-            foreach (var script in Resources.FindObjectsOfTypeAll<MonoScript>())
+            foreach (var script in MonoImporter.GetAllRuntimeMonoScripts())
             {
                 if (script.GetClass() != typeof(T))
                 {

Runtime/Internal/Extensions/ListExtensions.cs

@@ -1,19 +0,0 @@
-using System.Collections.Generic;
-
-namespace Coffee.UIParticleInternal
-{
-    /// <summary>
-    /// Extension methods for Component class.
-    /// </summary>
-    internal static class ListExtensions
-    {
-        public static void RemoveAtFast<T>(this List<T> self, int index)
-        {
-            if (self == null) return;
-
-            var lastIndex = self.Count - 1;
-            self[index] = self[lastIndex];
-            self.RemoveAt(lastIndex);
-        }
-    }
-}

Runtime/Internal/Extensions/MeshExtensions.cs

@@ -0,0 +1,153 @@
+using System.Collections.Generic;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class MeshExtensions
+    {
+        internal static readonly InternalObjectPool<Mesh> s_MeshPool = new InternalObjectPool<Mesh>(
+            () =>
+            {
+                var mesh = new Mesh
+                {
+                    hideFlags = HideFlags.DontSave | HideFlags.NotEditable
+                };
+                mesh.MarkDynamic();
+                return mesh;
+            },
+            mesh => mesh,
+            mesh =>
+            {
+                if (mesh != null)
+                {
+                    mesh.Clear();
+                }
+            });
+
+        public static Mesh Rent()
+        {
+            return s_MeshPool.Rent();
+        }
+
+        public static void Return(ref Mesh mesh)
+        {
+            s_MeshPool.Return(ref mesh);
+        }
+
+        public static void CopyTo(this Mesh self, Mesh dst)
+        {
+            if (self == null || dst == null) return;
+
+            var vector3List = InternalListPool<Vector3>.Rent();
+            var vector4List = InternalListPool<Vector4>.Rent();
+            var color32List = InternalListPool<Color32>.Rent();
+            var intList = InternalListPool<int>.Rent();
+
+            dst.Clear(false);
+
+            self.GetVertices(vector3List);
+            dst.SetVertices(vector3List);
+
+            self.GetTriangles(intList, 0);
+            dst.SetTriangles(intList, 0);
+
+            self.GetNormals(vector3List);
+            dst.SetNormals(vector3List);
+
+            self.GetTangents(vector4List);
+            dst.SetTangents(vector4List);
+
+            self.GetColors(color32List);
+            dst.SetColors(color32List);
+
+            self.GetUVs(0, vector4List);
+            dst.SetUVs(0, vector4List);
+
+            self.GetUVs(1, vector4List);
+            dst.SetUVs(1, vector4List);
+
+            self.GetUVs(2, vector4List);
+            dst.SetUVs(2, vector4List);
+
+            self.GetUVs(3, vector4List);
+            dst.SetUVs(3, vector4List);
+
+            dst.RecalculateBounds();
+            InternalListPool<Vector3>.Return(ref vector3List);
+            InternalListPool<Vector4>.Return(ref vector4List);
+            InternalListPool<Color32>.Return(ref color32List);
+            InternalListPool<int>.Return(ref intList);
+        }
+
+        public static void CopyTo(this VertexHelper self, Mesh dst)
+        {
+            if (self == null || dst == null) return;
+
+            self.FillMesh(dst);
+        }
+
+        public static void CopyTo(this Mesh self, VertexHelper dst)
+        {
+            if (self == null || dst == null) return;
+
+            var vertexCount = self.vertexCount;
+            var indexCount = self.triangles.Length;
+            self.CopyTo(dst, vertexCount, indexCount);
+        }
+
+        public static void CopyTo(this Mesh self, VertexHelper dst, int vertexCount, int indexCount)
+        {
+            if (self == null || dst == null) return;
+
+            var positions = InternalListPool<Vector3>.Rent();
+            var normals = InternalListPool<Vector3>.Rent();
+            var uv0 = InternalListPool<Vector4>.Rent();
+            var uv1 = InternalListPool<Vector4>.Rent();
+            var uv2 = InternalListPool<Vector4>.Rent();
+            var uv3 = InternalListPool<Vector4>.Rent();
+            var tangents = InternalListPool<Vector4>.Rent();
+            var colors = InternalListPool<Color32>.Rent();
+            var indices = InternalListPool<int>.Rent();
+            self.GetVertices(positions);
+            self.GetColors(colors);
+            self.GetUVs(0, uv0);
+            self.GetUVs(1, uv1);
+            self.GetUVs(2, uv1);
+            self.GetUVs(3, uv1);
+            self.GetNormals(normals);
+            self.GetTangents(tangents);
+            self.GetIndices(indices, 0);
+
+            dst.Clear();
+            for (var i = 0; i < vertexCount; i++)
+            {
+                dst.AddVert(positions.GetOrDefault(i), colors.GetOrDefault(i), uv0.GetOrDefault(i), uv1.GetOrDefault(i),
+                    uv2.GetOrDefault(i), uv3.GetOrDefault(i), normals.GetOrDefault(i), tangents.GetOrDefault(i));
+            }
+
+            var count = Mathf.Clamp(indexCount, 0, indices.Count);
+            for (var i = 0; i < count - 2; i += 3)
+            {
+                dst.AddTriangle(indices[i], indices[i + 1], indices[i + 2]);
+            }
+
+            InternalListPool<Vector3>.Return(ref positions);
+            InternalListPool<Vector3>.Return(ref normals);
+            InternalListPool<Vector4>.Return(ref uv0);
+            InternalListPool<Vector4>.Return(ref uv1);
+            InternalListPool<Vector4>.Return(ref uv2);
+            InternalListPool<Vector4>.Return(ref uv3);
+            InternalListPool<Vector4>.Return(ref tangents);
+            InternalListPool<Color32>.Return(ref colors);
+            InternalListPool<int>.Return(ref indices);
+        }
+
+        private static T GetOrDefault<T>(this List<T> self, int index)
+        {
+            return 0 <= index && index < self.Count
+                ? self[index]
+                : default;
+        }
+    }
+}

Runtime/Internal/Extensions/MeshExtensions.cs.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 8255313895da84e7cbdc876be3795334
+guid: 8c949d47f5c6d4d22bd7baebc60d48f3
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

Runtime/Internal/Extensions/Misc.cs

@@ -1,48 +0,0 @@
-using System.Diagnostics;
-using UnityEditor;
-using UnityEngine;
-
-namespace Coffee.UIParticleInternal
-{
-    internal static class Misc
-    {
-        public static void Destroy(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
-            }
-        }
-
-        public static void DestroyImmediate(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (Application.isEditor)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
-            }
-        }
-
-        [Conditional("UNITY_EDITOR")]
-        public static void SetDirty(Object obj)
-        {
-#if UNITY_EDITOR
-            if (!obj) return;
-            EditorUtility.SetDirty(obj);
-#endif
-        }
-    }
-}

Runtime/Internal/Extensions/SpriteExtensions.cs

@@ -17,23 +17,25 @@ namespace Coffee.UIParticleInternal
             Type.GetType("UnityEditor.Experimental.U2D.SpriteEditorExtension, UnityEditor")
             ?? Type.GetType("UnityEditor.U2D.SpriteEditorExtension, UnityEditor");
 
-        private static readonly MethodInfo s_GetActiveAtlasTextureMethod = s_SpriteEditorExtensionType
+        private static readonly Func<Sprite, Texture2D> s_GetActiveAtlasTextureMethod =
-            .GetMethod("GetActiveAtlasTexture", BindingFlags.Static | BindingFlags.NonPublic);
+            (Func<Sprite, Texture2D>)Delegate.CreateDelegate(typeof(Func<Sprite, Texture2D>),
+                s_SpriteEditorExtensionType
+                    .GetMethod("GetActiveAtlasTexture", BindingFlags.Static | BindingFlags.NonPublic));
 
-        private static readonly MethodInfo s_GetActiveAtlasMethod = s_SpriteEditorExtensionType
+        private static readonly Func<Sprite, SpriteAtlas> s_GetActiveAtlasMethod =
-            .GetMethod("GetActiveAtlas", BindingFlags.Static | BindingFlags.NonPublic);
+            (Func<Sprite, SpriteAtlas>)Delegate.CreateDelegate(typeof(Func<Sprite, SpriteAtlas>),
+                s_SpriteEditorExtensionType
+                    .GetMethod("GetActiveAtlas", BindingFlags.Static | BindingFlags.NonPublic));
 
         /// <summary>
         /// Get the actual texture of a sprite in play mode or edit mode.
         /// </summary>
         public static Texture2D GetActualTexture(this Sprite self)
         {
-            if (!self) return null;
+            if (self == null) return null;
 
-            if (Application.isPlaying) return self.texture;
+            var ret = s_GetActiveAtlasTextureMethod(self);
-
+            return ret != null ? ret : self.texture;
-            var ret = s_GetActiveAtlasTextureMethod.Invoke(null, new object[] { self }) as Texture2D;
-            return ret ? ret : self.texture;
         }
 
         /// <summary>
@@ -41,9 +43,9 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         public static SpriteAtlas GetActiveAtlas(this Sprite self)
         {
-            if (!self) return null;
+            if (self == null) return null;
 
-            return s_GetActiveAtlasMethod.Invoke(null, new object[] { self }) as SpriteAtlas;
+            return s_GetActiveAtlasMethod(self);
         }
 #else
         /// <summary>
@@ -51,7 +53,7 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         internal static Texture2D GetActualTexture(this Sprite self)
         {
-            return self ? self.texture : null;
+            return self != null ? self.texture : null;
         }
 #endif
     }

Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs

@@ -1,9 +1,9 @@
 using System;
 using System.Linq;
-using System.Reflection;
 using UnityEngine;
 using Object = UnityEngine.Object;
 #if UNITY_EDITOR
+using System.IO;
 using UnityEditor;
 using UnityEditor.Build;
 using UnityEditor.Build.Reporting;
@@ -13,41 +13,98 @@ namespace Coffee.UIParticleInternal
 {
     public abstract class PreloadedProjectSettings : ScriptableObject
 #if UNITY_EDITOR
-        , IPreprocessBuildWithReport
+    {
+        [Tooltip("When enabled, this settings asset will be added to PlayerSettings.preloadedAssets in build.\n\n" +
+                 "When disable, you should load this settings via Resources, AssetBundles or Addressables to use.")]
+        [SerializeField]
+        [Header("Advanced")]
+        [HideInInspector]
+        private bool m_PreLoadSettingsInBuild = true;
+
+        protected static bool s_BuildingPlayer;
+
+        private class EditorEvents : AssetPostprocessor, IPreprocessBuildWithReport, IPostprocessBuildWithReport
         {
             int IOrderedCallback.callbackOrder => 0;
 
-        void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)
+            private static void OnPostprocessAllAssets(string[] _, string[] __, string[] ___, string[] ____)
             {
                 Initialize();
             }
 
-        [InitializeOnLoadMethod]
+            void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)
-        [InitializeOnEnterPlayMode]
-        private static void Initialize()
             {
-            const BindingFlags flags = BindingFlags.Public | BindingFlags.Static | BindingFlags.FlattenHierarchy;
+                AssetDatabase.Refresh();
+                Initialize();
+                s_BuildingPlayer = true;
+
                 foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
                 {
-                var defaultSettings = GetDefaultSettings(t);
+                    var settings = GetDefaultSettings(t);
-                if (!defaultSettings)
+                    if (settings == null || settings.m_PreLoadSettingsInBuild) continue;
-                {
+
-                    defaultSettings = t.GetProperty("instance", flags)
+                    PlayerSettings.SetPreloadedAssets(
-                        ?.GetValue(null, null) as PreloadedProjectSettings;
+                        PlayerSettings.GetPreloadedAssets()
-                    SetDefaultSettings(defaultSettings);
+                            .Where(x => x != null && x.GetType() != t)
-                }
+                            .ToArray());
-                else if (GetPreloadedSettings(t).Length != 1)
+
-                {
+                    Debug.Log($"[PreloadedProjectSettings] Build started: removed '{settings.name}' " +
-                    SetDefaultSettings(defaultSettings);
+                              $"({t.Name}) from PreloadedAssets. " +
+                              $"It will be restored after build completes.");
                 }
             }
 
-            EditorApplication.QueuePlayerLoopUpdate();
+            void IPostprocessBuildWithReport.OnPostprocessBuild(BuildReport report)
+            {
+                s_BuildingPlayer = false;
+                Initialize();
+            }
+
+#if UNITY_2019_3_OR_NEWER
+            [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+            private static void OnDomainReload()
+            {
+                foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
+                {
+                    var defaultSettings = GetDefaultSettings(t);
+                    if (defaultSettings != null)
+                    {
+                        defaultSettings.OnDomainReload();
+                    }
+                }
+            }
+#endif
+        }
+
+        private static void Initialize()
+        {
+            foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
+            {
+                var defaultSettings = GetDefaultSettings(t);
+                if (defaultSettings == null)
+                {
+                    if (!s_BuildingPlayer)
+                    {
+                        // When create a new instance, automatically set it as default settings.
+                        defaultSettings = CreateInstance(t) as PreloadedProjectSettings;
+                        SetDefaultSettings(defaultSettings);
+                    }
+                }
+                else if (GetPreloadedSettings(t).Length != 1)
+                {
+                    if (!s_BuildingPlayer) SetDefaultSettings(defaultSettings);
+                }
+
+                if (defaultSettings != null)
+                {
+                    defaultSettings.OnInitialize();
+                }
+            }
         }
 
         protected static string GetDefaultName(Type type, bool nicify)
         {
-            var typeName = type.Name.Replace("ProjectSettings", "");
+            var typeName = type.Name;
             return nicify
                 ? ObjectNames.NicifyVariableName(typeName)
                 : typeName;
@@ -56,21 +113,23 @@ namespace Coffee.UIParticleInternal
         private static Object[] GetPreloadedSettings(Type type)
         {
             return PlayerSettings.GetPreloadedAssets()
-                .Where(x => x && x.GetType() == type)
+                .Where(x => x != null && x.GetType() == type)
                 .ToArray();
         }
 
         protected static PreloadedProjectSettings GetDefaultSettings(Type type)
         {
             return GetPreloadedSettings(type).FirstOrDefault() as PreloadedProjectSettings
-                   ?? AssetDatabase.FindAssets($"t:{nameof(PreloadedProjectSettings)}")
+                   ?? AssetDatabase.FindAssets($"t:{type.Name}")
                        .Select(AssetDatabase.GUIDToAssetPath)
                        .Select(AssetDatabase.LoadAssetAtPath<PreloadedProjectSettings>)
-                       .FirstOrDefault(x => x && x.GetType() == type);
+                       .FirstOrDefault(x => x != null && x.GetType() == type);
         }
 
         protected static void SetDefaultSettings(PreloadedProjectSettings asset)
         {
+            if (asset == null) return;
+
             var type = asset.GetType();
             if (string.IsNullOrEmpty(AssetDatabase.GetAssetPath(asset)))
             {
@@ -81,13 +140,17 @@ namespace Coffee.UIParticleInternal
 
                 var assetPath = $"Assets/ProjectSettings/{GetDefaultName(type, false)}.asset";
                 assetPath = AssetDatabase.GenerateUniqueAssetPath(assetPath);
+                if (!File.Exists(assetPath))
+                {
                     AssetDatabase.CreateAsset(asset, assetPath);
+                    asset.OnCreateAsset();
+                }
             }
 
             var preloadedAssets = PlayerSettings.GetPreloadedAssets();
             var projectSettings = GetPreloadedSettings(type);
             PlayerSettings.SetPreloadedAssets(preloadedAssets
-                .Where(x => x)
+                .Where(x => x != null)
                 .Except(projectSettings.Except(new[] { asset }))
                 .Append(asset)
                 .Distinct()
@@ -95,13 +158,53 @@ namespace Coffee.UIParticleInternal
 
             AssetDatabase.Refresh();
         }
+
+        protected virtual void OnCreateAsset()
+        {
+        }
+
+        protected virtual void OnInitialize()
+        {
+        }
+
+        protected virtual void OnDomainReload()
+        {
+        }
+    }
+
+    internal abstract class PreloadedProjectSettingsEditor : Editor
+    {
+        private SerializedProperty _preLoadSettingsInBuild;
+
+        protected virtual void OnEnable()
+        {
+            _preLoadSettingsInBuild = serializedObject.FindProperty("m_PreLoadSettingsInBuild");
+        }
+
+        protected void DrawPreLoadSettingsInBuild(string packageName)
+        {
+            EditorGUILayout.PropertyField(_preLoadSettingsInBuild);
+            if (!_preLoadSettingsInBuild.boolValue)
+            {
+                EditorGUILayout.BeginHorizontal();
+                EditorGUILayout.HelpBox(
+                    $"{target.GetType().Name} asset will not be built in.\n" +
+                    $"please load manually from Resources, AssetBundle, or Addressables before using {packageName}.",
+                    MessageType.Warning);
+                if (GUILayout.Button("Ping"))
+                {
+                    EditorGUIUtility.PingObject(target);
+                }
+
+                EditorGUILayout.EndHorizontal();
+            }
+        }
     }
 #else
     {
     }
 #endif
 
-
     public abstract class PreloadedProjectSettings<T> : PreloadedProjectSettings
         where T : PreloadedProjectSettings<T>
     {
@@ -110,29 +213,33 @@ namespace Coffee.UIParticleInternal
 #if UNITY_EDITOR
         private string _jsonText;
 
+        public static bool hasInstance => s_Instance != null;
+
         public static T instance
         {
             get
             {
-                if (s_Instance) return s_Instance;
+                if (s_Instance != null) return s_Instance;
 
                 s_Instance = GetDefaultSettings(typeof(T)) as T;
-                if (s_Instance) return s_Instance;
+                if (s_Instance != null) return s_Instance;
 
                 s_Instance = CreateInstance<T>();
-                if (!s_Instance)
+                if (s_Instance == null)
                 {
                     s_Instance = null;
                     return s_Instance;
                 }
 
-                SetDefaultSettings(s_Instance);
+                if (!s_BuildingPlayer) SetDefaultSettings(s_Instance);
                 return s_Instance;
             }
         }
 
         private void OnPlayModeStateChanged(PlayModeStateChange state)
         {
+            if (this == null) return;
+
             switch (state)
             {
                 case PlayModeStateChange.ExitingEditMode:
@@ -148,8 +255,13 @@ namespace Coffee.UIParticleInternal
                     break;
             }
         }
+
+        protected override void OnDomainReload()
+        {
+            s_Instance = null;
+        }
 #else
-        public static T instance => s_Instance ? s_Instance : s_Instance = CreateInstance<T>();
+        public static T instance => s_Instance != null ? s_Instance : s_Instance = CreateInstance<T>();
 #endif
 
         /// <summary>
@@ -158,17 +270,21 @@ namespace Coffee.UIParticleInternal
         protected virtual void OnEnable()
         {
 #if UNITY_EDITOR
-            var isDefaultSettings = !s_Instance || s_Instance == this || GetDefaultSettings(typeof(T)) == this;
+            var isDefaultSettings = s_Instance == null || s_Instance == this || GetDefaultSettings(typeof(T)) == this;
             if (!isDefaultSettings)
             {
                 DestroyImmediate(this, true);
                 return;
             }
 
+            EditorApplication.playModeStateChanged -= OnPlayModeStateChanged;
             EditorApplication.playModeStateChanged += OnPlayModeStateChanged;
+#else
+            if (s_Instance != null && s_Instance != this)
+            {
+                Destroy(s_Instance);
+            }
 #endif
-
-            if (s_Instance) return;
             s_Instance = this as T;
         }
 
@@ -197,9 +313,9 @@ namespace Coffee.UIParticleInternal
 
             public override void OnGUI(string searchContext)
             {
-                if (!_target)
+                if (_target == null)
                 {
-                    if (_editor)
+                    if (_editor != null)
                     {
                         DestroyImmediate(_editor);
                         _editor = null;

Runtime/Internal/Utilities/FastAction.cs

@@ -10,8 +10,9 @@ namespace Coffee.UIParticleInternal
     /// </summary>
     internal class FastActionBase<T>
     {
-        private static readonly ObjectPool<LinkedListNode<T>> s_NodePool =
+        private static readonly InternalObjectPool<LinkedListNode<T>> s_NodePool =
-            new ObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true, x => x.Value = default);
+            new InternalObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true,
+                x => x.Value = default);
 
         private readonly LinkedList<T> _delegates = new LinkedList<T>();
 
@@ -65,11 +66,6 @@ namespace Coffee.UIParticleInternal
                 node = node.Next;
             }
         }
-
-        public void Clear()
-        {
-            _delegates.Clear();
-        }
     }
 
     /// <summary>

Runtime/Internal/Utilities/FrameCache.cs

@@ -8,19 +8,19 @@ namespace Coffee.UIParticleInternal
     {
         private static readonly Dictionary<Type, IFrameCache> s_Caches = new Dictionary<Type, IFrameCache>();
 
-        static FrameCache()
+#if UNITY_EDITOR && UNITY_2019_3_OR_NEWER
-        {
-            s_Caches.Clear();
-            UIExtraCallbacks.onLateAfterCanvasRebuild += ClearAllCache;
-        }
-
-#if UNITY_EDITOR
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+#elif UNITY_EDITOR
+        [InitializeOnLoadMethod]
+#else
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
+#endif
         private static void Clear()
         {
             s_Caches.Clear();
+            UIExtraCallbacks.onLateAfterCanvasRebuild -= ClearAllCache;
+            UIExtraCallbacks.onLateAfterCanvasRebuild += ClearAllCache;
         }
-#endif
 
         /// <summary>
         /// Tries to retrieve a value from the frame cache with a specified key.
@@ -46,7 +46,6 @@ namespace Coffee.UIParticleInternal
             GetFrameCache<T>().Set((key1.GetHashCode(), key2.GetHashCode()), result);
         }
 
-
         /// <summary>
         /// Sets a value in the frame cache with a specified key.
         /// </summary>

Runtime/Internal/Utilities/Logger.cs

@@ -11,7 +11,7 @@ using Conditional = System.Diagnostics.ConditionalAttribute;
 
 namespace Coffee.UIParticleInternal
 {
-    internal static class Logging
+    internal static class Logger
     {
 #if !ENABLE_COFFEE_LOGGER
         private const string k_DisableSymbol = "DISABLE_COFFEE_LOGGER";
@@ -42,44 +42,40 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
         public static void LogIf(bool enable, object tag, object message, Object context = null)
         {
             if (!enable) return;
-            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
+            Log_Internal(LogType.Log, tag, message, context != null ? context : tag as Object);
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
         public static void Log(object tag, object message, Object context = null)
         {
-            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
+            Log_Internal(LogType.Log, tag, message, context != null ? context : tag as Object);
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
         public static void LogWarning(object tag, object message, Object context = null)
         {
-            Log_Internal(LogType.Warning, tag, message, context ? context : tag as Object);
+            Log_Internal(LogType.Warning, tag, message, context != null ? context : tag as Object);
         }
 
         public static void LogError(object tag, object message, Object context = null)
         {
 #if ENABLE_COFFEE_LOGGER
-            Log_Internal(LogType.Error, tag, message, context ? context : tag as Object);
+            Log_Internal(LogType.Error, tag, message, context != null ? context : tag as Object);
 #else
             Debug.LogError($"{tag}: {message}", context);
 #endif
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -123,7 +119,6 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -140,6 +135,9 @@ namespace Coffee.UIParticleInternal
 
                 switch (tag)
                 {
+                    case string name:
+                        sb.Append(name);
+                        break;
                     case Type type:
                         AppendType(sb, type);
                         break;
@@ -166,7 +164,6 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -205,7 +202,6 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
-
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif

Runtime/Internal/Utilities/Logger.cs.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 833553390099d40c9b212823f0852c46
+guid: 4f9f22bb079324476b1473030ad9fec3
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

Runtime/Internal/Utilities/MaterialRepository.cs

@@ -13,9 +13,11 @@ namespace Coffee.UIParticleInternal
 
         public static int count => s_Repository.count;
 
-#if UNITY_EDITOR
+        public static Func<string, Shader> onShaderFind = Shader.Find;
+
+#if UNITY_EDITOR && UNITY_2019_3_OR_NEWER
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
-        private static void Clear()
+        public static void Clear()
         {
             s_Repository.Clear();
         }
@@ -48,21 +50,20 @@ namespace Coffee.UIParticleInternal
         public static void Get(Hash128 hash, ref Material material, string shaderName)
         {
             Profiler.BeginSample("(COF)[MaterialRepository] Get");
-            s_Repository.Get(hash, ref material, x => new Material(Shader.Find(x))
+            s_Repository.Get(hash, ref material, x => new Material(onShaderFind(x))
             {
                 hideFlags = HideFlags.DontSave | HideFlags.NotEditable
             }, shaderName);
             Profiler.EndSample();
         }
 
-
         /// <summary>
         /// Adds or retrieves a cached material based on the hash.
         /// </summary>
         public static void Get(Hash128 hash, ref Material material, string shaderName, string[] keywords)
         {
             Profiler.BeginSample("(COF)[MaterialRepository] Get");
-            s_Repository.Get(hash, ref material, x => new Material(Shader.Find(x.shaderName))
+            s_Repository.Get(hash, ref material, x => new Material(onShaderFind(x.shaderName))
             {
                 hideFlags = HideFlags.DontSave | HideFlags.NotEditable,
                 shaderKeywords = x.keywords

Runtime/Internal/Utilities/Misc.cs

@@ -0,0 +1,129 @@
+using System;
+using System.Diagnostics;
+using UnityEditor;
+using UnityEngine;
+using Object = UnityEngine.Object;
+#if UNITY_EDITOR
+using System.IO;
+using System.Linq;
+using System.Reflection;
+#if UNITY_2021_2_OR_NEWER
+using UnityEditor.SceneManagement;
+#else
+using UnityEditor.Experimental.SceneManagement;
+#endif
+#endif
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class Misc
+    {
+        public static T[] FindObjectsOfType<T>() where T : Object
+        {
+#if UNITY_6000_4_OR_NEWER
+            return Object.FindObjectsByType<T>(FindObjectsInactive.Include);
+#elif UNITY_2023_1_OR_NEWER
+            return Object.FindObjectsByType<T>(FindObjectsInactive.Include, FindObjectsSortMode.None);
+#else
+            return Object.FindObjectsOfType<T>();
+#endif
+        }
+
+        public static void Destroy(Object obj)
+        {
+            if (obj == null) return;
+#if UNITY_EDITOR
+            if (!Application.isPlaying)
+            {
+                Object.DestroyImmediate(obj);
+            }
+            else
+#endif
+            {
+                Object.Destroy(obj);
+            }
+        }
+
+        public static void DestroyImmediate(Object obj)
+        {
+            if (obj == null) return;
+#if UNITY_EDITOR
+            Object.DestroyImmediate(obj, true);
+#else
+            Object.Destroy(obj);
+#endif
+        }
+
+        [Conditional("UNITY_EDITOR")]
+        public static void SetDirty(Object obj)
+        {
+#if UNITY_EDITOR
+            if (obj == null) return;
+            EditorUtility.SetDirty(obj);
+#endif
+        }
+
+#if UNITY_EDITOR
+        public static T[] GetAllComponentsInPrefabStage<T>() where T : Component
+        {
+            var prefabStage = PrefabStageUtility.GetCurrentPrefabStage();
+            if (prefabStage == null) return Array.Empty<T>();
+
+            return prefabStage.prefabContentsRoot.GetComponentsInChildren<T>(true);
+        }
+
+        public static bool isBatchOrBuilding => Application.isBatchMode || BuildPipeline.isBuildingPlayer;
+#endif
+
+        [Conditional("UNITY_EDITOR")]
+        public static void QueuePlayerLoopUpdate()
+        {
+#if UNITY_EDITOR
+            if (!EditorApplication.isPlaying)
+            {
+                EditorApplication.QueuePlayerLoopUpdate();
+            }
+#endif
+        }
+    }
+
+#if !UNITY_2021_2_OR_NEWER
+    [AttributeUsage(AttributeTargets.Class)]
+    [Conditional("UNITY_EDITOR")]
+    internal class IconAttribute : Attribute
+    {
+        private readonly string _path;
+
+        public IconAttribute(string path)
+        {
+            _path = path;
+        }
+
+#if UNITY_EDITOR
+        private static Action<Object, Texture2D> s_SetIconForObject = typeof(EditorGUIUtility)
+            .GetMethod("SetIconForObject", BindingFlags.Static | BindingFlags.NonPublic)
+            .CreateDelegate(typeof(Action<Object, Texture2D>), null) as Action<Object, Texture2D>;
+
+        [InitializeOnLoadMethod]
+        private static void InitializeOnLoadMethod()
+        {
+            if (Misc.isBatchOrBuilding) return;
+
+            var types = TypeCache.GetTypesWithAttribute(typeof(IconAttribute));
+            var scripts = MonoImporter.GetAllRuntimeMonoScripts();
+            foreach (var type in types)
+            {
+                var script = scripts.FirstOrDefault(x => x.GetClass() == type);
+                if (script == null) continue;
+
+                var path = type.GetCustomAttribute<IconAttribute>()?._path;
+                var icon = AssetDatabase.LoadAssetAtPath<Texture2D>(path);
+                if (icon == null) continue;
+
+                s_SetIconForObject(script, icon);
+            }
+        }
+#endif
+    }
+#endif
+}

Runtime/Internal/Utilities/Misc.cs.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 39ed6a6b0a72e482488bd298b2ae762e
+guid: 182319ecc315e4858b119764af0fbcb0
 MonoImporter:
   externalObjects: {}
   serializedVersion: 2

Runtime/Internal/Utilities/ObjectPool.cs

@@ -6,15 +6,58 @@ namespace Coffee.UIParticleInternal
     /// <summary>
     /// Object pool.
     /// </summary>
-    internal class ObjectPool<T>
+    internal class InternalObjectPool<T> where T : class
     {
+#if UNITY_2021_1_OR_NEWER
+        private readonly Predicate<T> _onValid; // Delegate for checking if instances are valid
+        private readonly UnityEngine.Pool.ObjectPool<T> _pool;
+
+        public InternalObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        {
+            _pool = new UnityEngine.Pool.ObjectPool<T>(onCreate, null, onReturn);
+            _onValid = onValid;
+        }
+
+        /// <summary>
+        /// Rent an instance from the pool.
+        /// When you no longer need it, return it with <see cref="Return" />.
+        /// </summary>
+        public T Rent()
+        {
+            while (0 < _pool.CountInactive)
+            {
+                var instance = _pool.Get();
+                if (_onValid(instance))
+                {
+                    return instance;
+                }
+            }
+
+            // If there are no instances in the pool, create a new one.
+            Logger.Log(this, $"A new instance is created (pooled: {_pool.CountInactive}, created: {_pool.CountAll}).");
+            return _pool.Get();
+        }
+
+        /// <summary>
+        /// Return an instance to the pool and assign null.
+        /// Be sure to return the instance obtained with <see cref="Rent" /> with this method.
+        /// </summary>
+        public void Return(ref T instance)
+        {
+            if (instance == null) return; // Ignore if already pooled or null.
+
+            _pool.Release(instance);
+            Logger.Log(this, $"An instance is released (pooled: {_pool.CountInactive}, created: {_pool.CountAll}).");
+            instance = default; // Set the reference to null.
+        }
+#else
         private readonly Func<T> _onCreate; // Delegate for creating instances
         private readonly Action<T> _onReturn; // Delegate for returning instances to the pool
         private readonly Predicate<T> _onValid; // Delegate for checking if instances are valid
         private readonly Stack<T> _pool = new Stack<T>(32); // Object pool
         private int _count; // Total count of created instances
 
-        public ObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        public InternalObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
         {
             _onCreate = onCreate;
             _onValid = onValid;
@@ -37,7 +80,7 @@ namespace Coffee.UIParticleInternal
             }
 
             // If there are no instances in the pool, create a new one.
-            Logging.Log(this, $"A new instance is created (pooled: {_pool.Count}, created: {++_count}).");
+            Logger.Log(this, $"A new instance is created (pooled: {_pool.Count}, created: {++_count}).");
             return _onCreate();
         }
 
@@ -51,18 +94,43 @@ namespace Coffee.UIParticleInternal
 
             _onReturn(instance); // Return the instance to the pool.
             _pool.Push(instance);
-            Logging.Log(this, $"An instance is released (pooled: {_pool.Count}, created: {_count}).");
+            Logger.Log(this, $"An instance is released (pooled: {_pool.Count}, created: {_count}).");
             instance = default; // Set the reference to null.
         }
+#endif
     }
 
     /// <summary>
     /// Object pool for <see cref="List{T}" />.
     /// </summary>
-    internal static class ListPool<T>
+    internal static class InternalListPool<T>
     {
-        private static readonly ObjectPool<List<T>> s_ListPool =
+#if UNITY_2021_1_OR_NEWER
-            new ObjectPool<List<T>>(() => new List<T>(), _ => true, x => x.Clear());
+        /// <summary>
+        /// Rent an instance from the pool.
+        /// When you no longer need it, return it with <see cref="Return" />.
+        /// </summary>
+        public static List<T> Rent()
+        {
+            return UnityEngine.Pool.ListPool<T>.Get();
+        }
+
+        /// <summary>
+        /// Return an instance to the pool and assign null.
+        /// Be sure to return the instance obtained with <see cref="Rent" /> with this method.
+        /// </summary>
+        public static void Return(ref List<T> toRelease)
+        {
+            if (toRelease != null)
+            {
+                UnityEngine.Pool.ListPool<T>.Release(toRelease);
+            }
+
+            toRelease = null;
+        }
+#else
+        private static readonly InternalObjectPool<List<T>> s_ListPool =
+            new InternalObjectPool<List<T>>(() => new List<T>(), _ => true, x => x.Clear());
 
         /// <summary>
         /// Rent an instance from the pool.
@@ -81,5 +149,6 @@ namespace Coffee.UIParticleInternal
         {
             s_ListPool.Return(ref toRelease);
         }
+#endif
     }
 }

Runtime/Internal/Utilities/ObjectRepository.cs

@@ -8,10 +8,11 @@ namespace Coffee.UIParticleInternal
 {
     internal class ObjectRepository<T> where T : Object
     {
-        private readonly List<Entry> _cache = new List<Entry>();
+        private readonly Dictionary<Hash128, Entry> _cache = new Dictionary<Hash128, Entry>(8);
+        private readonly Dictionary<int, Hash128> _objectKey = new Dictionary<int, Hash128>(8);
         private readonly string _name;
         private readonly Action<T> _onRelease;
-        private readonly Stack<Entry> _pool = new Stack<Entry>();
+        private readonly Stack<Entry> _pool = new Stack<Entry>(8);
 
         public ObjectRepository(Action<T> onRelease = null)
         {
@@ -36,40 +37,33 @@ namespace Coffee.UIParticleInternal
             {
                 _onRelease = onRelease;
             }
+
+            for (var i = 0; i < 8; i++)
+            {
+                _pool.Push(new Entry());
+            }
         }
 
         public int count => _cache.Count;
 
         public void Clear()
         {
-            for (var i = 0; i < _cache.Count; i++)
+            foreach (var kv in _cache)
             {
-                var entry = _cache[i];
+                var entry = kv.Value;
                 if (entry == null) continue;
 
                 entry.Release(_onRelease);
+                _pool.Push(entry);
             }
 
             _cache.Clear();
+            _objectKey.Clear();
         }
 
         public bool Valid(Hash128 hash, T obj)
         {
-            // Find existing entry.
+            return _cache.TryGetValue(hash, out var entry) && entry.storedObject == obj;
-            Profiler.BeginSample("(COF)[ObjectRepository] Valid > Find existing entry");
-            for (var i = 0; i < _cache.Count; ++i)
-            {
-                var entry = _cache[i];
-                if (entry.hash != hash) continue;
-                Profiler.EndSample();
-
-                // Existing entry found.
-                return entry.storedObject == obj;
-            }
-
-            Profiler.EndSample();
-
-            return false;
         }
 
         /// <summary>
@@ -77,41 +71,8 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         public void Get(Hash128 hash, ref T obj, Func<T> onCreate)
         {
-            // Find existing entry.
+            if (GetFromCache(hash, ref obj)) return;
-            Profiler.BeginSample("(COF)[ObjectRepository] Get > Find existing entry");
+            Add(hash, ref obj, onCreate());
-            for (var i = 0; i < _cache.Count; ++i)
-            {
-                var entry = _cache[i];
-                if (entry.hash != hash) continue;
-
-                // Existing entry found.
-                if (entry.storedObject != obj)
-                {
-                    // if the object is different, release the old one.
-                    Release(ref obj);
-                    ++entry.reference;
-                    obj = entry.storedObject;
-                    Logging.Log(_name, $"Get(#{count}): {entry}");
-                }
-
-                Profiler.EndSample();
-                return;
-            }
-
-            Profiler.EndSample();
-
-            // Create new entry.
-            Profiler.BeginSample("(COF)[ObjectRepository] Get > Create new entry");
-            var newEntry = 0 < _pool.Count ? _pool.Pop() : new Entry();
-            newEntry.storedObject = onCreate();
-            newEntry.hash = hash;
-            newEntry.reference = 1;
-            _cache.Add(newEntry);
-            Logging.Log(_name, $"Get(#{count}): {newEntry}");
-
-            Release(ref obj);
-            obj = newEntry.storedObject;
-            Profiler.EndSample();
         }
 
         /// <summary>
@@ -119,40 +80,60 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         public void Get<TS>(Hash128 hash, ref T obj, Func<TS, T> onCreate, TS source)
         {
-            // Find existing entry.
+            if (GetFromCache(hash, ref obj)) return;
-            Profiler.BeginSample("(COF)[ObjectRepository] Get > Find existing entry");
+            Add(hash, ref obj, onCreate(source));
-            for (var i = 0; i < _cache.Count; ++i)
+        }
-            {
+
-                var entry = _cache[i];
+        private bool GetFromCache(Hash128 hash, ref T obj)
-                if (entry.hash != hash) continue;
+        {
+            // Find existing entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] GetFromCache");
+            if (_cache.TryGetValue(hash, out var entry))
+            {
+                if (entry.storedObject == null)
+                {
+                    Release(ref entry.storedObject);
+                    Profiler.EndSample();
+                    return false;
+                }
 
-                // Existing entry found.
                 if (entry.storedObject != obj)
                 {
                     // if the object is different, release the old one.
                     Release(ref obj);
                     ++entry.reference;
                     obj = entry.storedObject;
-                    Logging.Log(_name, $"Get(#{count}): {entry}");
+                    Logger.Log(_name, $"Get(total#{count}): {entry}");
                 }
 
                 Profiler.EndSample();
+                return true;
+            }
+
+            Profiler.EndSample();
+            return false;
+        }
+
+        private void Add(Hash128 hash, ref T obj, T newObject)
+        {
+            if (newObject == null)
+            {
+                Release(ref obj);
+                obj = newObject;
                 return;
             }
 
-            Profiler.EndSample();
+            // Create and add a new entry.
-
+            Profiler.BeginSample("(COF)[ObjectRepository] Add");
-            // Create new entry.
-            Profiler.BeginSample("(COF)[ObjectRepository] Get > Create new entry");
             var newEntry = 0 < _pool.Count ? _pool.Pop() : new Entry();
-            newEntry.storedObject = onCreate(source);
+            newEntry.storedObject = newObject;
             newEntry.hash = hash;
             newEntry.reference = 1;
-            _cache.Add(newEntry);
+            _cache[hash] = newEntry;
-            Logging.Log(_name, $"Get(#{count}): {newEntry}");
+            _objectKey[newObject.GetHashCode()] = hash;
-
+            Logger.Log(_name, $"<color=#03c700>Add</color>(total#{count}): {newEntry}");
             Release(ref obj);
-            obj = newEntry.storedObject;
+            obj = newObject;
             Profiler.EndSample();
         }
 
@@ -163,35 +144,45 @@ namespace Coffee.UIParticleInternal
         {
             if (ReferenceEquals(obj, null)) return;
 
+            // Find and release the entry.
             Profiler.BeginSample("(COF)[ObjectRepository] Release");
-            for (var i = 0; i < _cache.Count; i++)
+            var id = obj.GetHashCode();
+            if (_objectKey.TryGetValue(id, out var hash)
+                && _cache.TryGetValue(hash, out var entry))
             {
-                var entry = _cache[i];
+                entry.reference--;
-
+                if (entry.reference <= 0 || entry.storedObject == null)
-                if (entry.storedObject != obj)
                 {
-                    continue;
+                    Remove(entry);
                 }
-
+                else
-                if (--entry.reference <= 0)
                 {
-                    Profiler.BeginSample("(COF)[ObjectRepository] Release > RemoveAt");
+                    Logger.Log(_name, $"Release(total#{_cache.Count}): {entry}");
-                    _cache.RemoveAtFast(i);
-                    Logging.Log(_name, $"Release(#{_cache.Count}): {entry}");
-                    entry.Release(_onRelease);
-                    _pool.Push(entry);
-                    Profiler.EndSample();
-                    break;
                 }
-
+            }
-                Logging.Log(_name, $"Release(#{count}): {entry}");
+            else
-                break;
+            {
+                Logger.Log(_name, $"Release(total#{_cache.Count}): <color=red>Already released: {obj}</color>");
             }
 
             obj = null;
             Profiler.EndSample();
         }
 
+        private void Remove(Entry entry)
+        {
+            if (ReferenceEquals(entry, null)) return;
+
+            Profiler.BeginSample("(COF)[ObjectRepository] Remove");
+            _cache.Remove(entry.hash);
+            _objectKey.Remove(entry.storedObject.GetHashCode());
+            _pool.Push(entry);
+            entry.reference = 0;
+            Logger.Log(_name, $"<color=#f29e03>Remove</color>(total#{_cache.Count}): {entry}");
+            entry.Release(_onRelease);
+            Profiler.EndSample();
+        }
+
         private class Entry
         {
             public Hash128 hash;
@@ -201,7 +192,7 @@ namespace Coffee.UIParticleInternal
             public void Release(Action<T> onRelease)
             {
                 reference = 0;
-                if (storedObject)
+                if (storedObject != null)
                 {
                     onRelease?.Invoke(storedObject);
                 }
@@ -211,7 +202,7 @@ namespace Coffee.UIParticleInternal
 
             public override string ToString()
             {
-                return $"h{(uint)hash.GetHashCode()} (#{reference}), {storedObject}";
+                return $"h{(uint)hash.GetHashCode()} (refs#{reference}), {storedObject}";
             }
         }
     }

Runtime/Internal/Utilities/TypeCache.cs

@@ -0,0 +1,88 @@
+#if !UNITY_2019_2_OR_NEWER
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace Coffee.UIParticleInternal
+{
+    public static class TypeCache
+    {
+        private static readonly object s_Lock = new object();
+        private static readonly Dictionary<Type, Type[]> s_DerivedTypesCache = new Dictionary<Type, Type[]>();
+        private static readonly Dictionary<Type, Type[]> s_AttributeTypesCache = new Dictionary<Type, Type[]>();
+
+        public static IEnumerable<Type> GetTypesDerivedFrom(Type baseType)
+        {
+            lock (s_Lock)
+            {
+                if (s_DerivedTypesCache.TryGetValue(baseType, out var cached))
+                {
+                    return cached;
+                }
+
+                var types = new List<Type>();
+                foreach (var t in GetAllLoadableTypes())
+                {
+                    if (t != baseType && baseType.IsAssignableFrom(t))
+                    {
+                        types.Add(t);
+                    }
+                }
+
+                return s_DerivedTypesCache[baseType] = types.ToArray();
+            }
+        }
+
+        public static IEnumerable<Type> GetTypesWithAttribute(Type attr)
+        {
+            lock (s_Lock)
+            {
+                if (s_AttributeTypesCache.TryGetValue(attr, out var cached))
+                {
+                    return cached;
+                }
+
+                var types = new List<Type>();
+                foreach (var t in GetAllLoadableTypes())
+                {
+                    if (t.GetCustomAttributes(attr, inherit: true).Length > 0)
+                    {
+                        types.Add(t);
+                    }
+                }
+
+                return s_AttributeTypesCache[attr] = types.ToArray();
+            }
+        }
+
+        private static IEnumerable<Type> GetAllLoadableTypes()
+        {
+            foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
+            {
+                Type[] types;
+                try
+                {
+                    types = assembly.GetTypes();
+                }
+                catch (ReflectionTypeLoadException ex)
+                {
+                    types = ex.Types;
+                }
+
+                if (types == null)
+                {
+                    continue;
+                }
+
+                foreach (var t in types)
+                {
+                    if (t != null)
+                    {
+                        yield return t;
+                    }
+                }
+            }
+        }
+    }
+}
+#endif

Runtime/Internal/Utilities/TypeCache.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: bc1207b657ed74ec19e459664d06925f
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Runtime/Internal/Utilities/UIExtraCallbacks.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Reflection;
 using UnityEditor;
 using UnityEngine;
 using UnityEngine.UI;
@@ -14,11 +15,13 @@ namespace Coffee.UIParticleInternal
         private static readonly FastAction s_AfterCanvasRebuildAction = new FastAction();
         private static readonly FastAction s_LateAfterCanvasRebuildAction = new FastAction();
         private static readonly FastAction s_BeforeCanvasRebuildAction = new FastAction();
+        private static readonly FastAction s_OnScreenSizeChangedAction = new FastAction();
+        private static Vector2Int s_LastScreenSize;
 
         static UIExtraCallbacks()
         {
             Canvas.willRenderCanvases += OnBeforeCanvasRebuild;
-            Logging.LogMulticast(typeof(Canvas), "willRenderCanvases", message: "ctor");
+            Logger.LogMulticast(typeof(Canvas), "willRenderCanvases", message: "ctor");
         }
 
         /// <summary>
@@ -48,6 +51,15 @@ namespace Coffee.UIParticleInternal
             remove => s_AfterCanvasRebuildAction.Remove(value);
         }
 
+        /// <summary>
+        /// Event that occurs when the screen size changes.
+        /// </summary>
+        public static event Action onScreenSizeChanged
+        {
+            add => s_OnScreenSizeChangedAction.Add(value);
+            remove => s_OnScreenSizeChangedAction.Remove(value);
+        }
+
         /// <summary>
         /// Initializes the UIExtraCallbacks to ensure proper event handling.
         /// </summary>
@@ -56,20 +68,32 @@ namespace Coffee.UIParticleInternal
             if (s_IsInitializedAfterCanvasRebuild) return;
             s_IsInitializedAfterCanvasRebuild = true;
 
+            // Explicitly set `Canvas.willRenderCanvases += CanvasUpdateRegistry.PerformUpdate`.
             CanvasUpdateRegistry.IsRebuildingLayout();
+#if TMP_ENABLE
+            // Explicitly set `Canvas.willRenderCanvases += TMP_UpdateManager.DoRebuilds`.
+            typeof(TMPro.TMP_UpdateManager)
+                .GetProperty("instance", BindingFlags.NonPublic | BindingFlags.Static)
+                .GetValue(null);
+#endif
+            Canvas.willRenderCanvases -= OnAfterCanvasRebuild;
             Canvas.willRenderCanvases += OnAfterCanvasRebuild;
-            Logging.LogMulticast(typeof(Canvas), "willRenderCanvases",
+            Logger.LogMulticast(typeof(Canvas), "willRenderCanvases",
                 message: "InitializeAfterCanvasRebuild");
         }
 
-#if UNITY_EDITOR
+#if UNITY_EDITOR && UNITY_2019_3_OR_NEWER
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+#elif UNITY_EDITOR
         [InitializeOnLoadMethod]
-#endif
+#else
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
+#endif
         private static void InitializeOnLoad()
         {
             Canvas.willRenderCanvases -= OnAfterCanvasRebuild;
             s_IsInitializedAfterCanvasRebuild = false;
+            s_LastScreenSize = default;
         }
 
         /// <summary>
@@ -77,6 +101,17 @@ namespace Coffee.UIParticleInternal
         /// </summary>
         private static void OnBeforeCanvasRebuild()
         {
+            var screenSize = new Vector2Int(Screen.width, Screen.height);
+            if (s_LastScreenSize != screenSize)
+            {
+                if (s_LastScreenSize != default)
+                {
+                    s_OnScreenSizeChangedAction.Invoke();
+                }
+
+                s_LastScreenSize = screenSize;
+            }
+
             s_BeforeCanvasRebuildAction.Invoke();
             InitializeAfterCanvasRebuild();
         }

Runtime/ParticleSystemPreviewer.cs

@@ -0,0 +1,242 @@
+#if UNITY_EDITOR
+using System.Collections.Generic;
+using System.Linq;
+using Coffee.UIParticleInternal;
+using UnityEditor;
+using UnityEngine;
+
+namespace Coffee.UIExtensions
+{
+    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
+    [ExecuteAlways]
+    internal class ParticleSystemPreviewer : MonoBehaviour
+    {
+        // Do nothing.
+    }
+
+    [CustomEditor(typeof(ParticleSystemPreviewer))]
+    [CanEditMultipleObjects]
+    internal class ParticleSystemPreviewerEditor : Editor
+    {
+        private GameObject[] _gameObjects;
+
+        private void OnEnable()
+        {
+            _gameObjects = targets.OfType<ParticleSystemPreviewer>().Select(x => x.gameObject).ToArray();
+            ParticleSystemPreviewSystem.Register(_gameObjects);
+        }
+
+        public override void OnInspectorGUI()
+        {
+            base.OnInspectorGUI();
+            EditorGUILayout.HelpBox("ParticleSystemPreviewer will be removed in build.", MessageType.Warning);
+            ParticleSystemPreviewSystem.DrawWarningForTemporary(_gameObjects);
+            ParticleSystemPreviewSystem.DrawWarningForPermanent(_gameObjects);
+        }
+    }
+
+    /// <summary>
+    /// This class manages temporary ParticleSystems for preview purposes.
+    /// When previewing in the editor, it is common to place an empty ParticleSystem as the root, but it consumes memory at runtime if included in the build.
+    /// The temporary ParticleSystems created by this class only exist when the specified GameObject is selected, and are automatically deleted when the selection is cleared.
+    /// </summary>
+    internal class ParticleSystemPreviewSystem : ScriptableSingleton<ParticleSystemPreviewSystem>
+    {
+        private const HideFlags k_TemporaryHideFlags = HideFlags.DontSave | HideFlags.NotEditable;
+
+        private const string k_TemporaryMesssage = "The temporary ParticleSystem for preview is attached.\n" +
+                                                   "It will be removed when exiting edit mode.";
+
+        private const string k_PermanentMesssage = "The permanent ParticleSystem is attached.\n" +
+                                                   "It will be included in build.";
+
+        [SerializeField]
+        private List<GameObject> m_PreviewObjects = new List<GameObject>();
+
+#if UNITY_2019_3_OR_NEWER
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+#endif
+        [InitializeOnLoadMethod]
+        public static void Initialize()
+        {
+            instance.OnSelectionChanged();
+
+            Selection.selectionChanged -= instance.OnSelectionChanged;
+            Selection.selectionChanged += instance.OnSelectionChanged;
+        }
+
+        /// <summary>
+        /// Adds a temporary ParticleSystem to the specified GameObject for preview purposes.
+        /// </summary>
+        public static void Register(GameObject[] targets)
+        {
+            foreach (var target in targets)
+            {
+                Register(target);
+            }
+        }
+
+        /// <summary>
+        /// Adds a temporary ParticleSystem to the specified GameObject for preview purposes.
+        /// </summary>
+        public static void Register(GameObject target)
+        {
+            if (!target) return;
+            if (EditorApplication.isPlaying) return;
+            if (instance.m_PreviewObjects.Contains(target)) return;
+            if (target.TryGetComponent<ParticleSystem>(out var ps))
+            {
+                if (ps.hideFlags == k_TemporaryHideFlags)
+                {
+                    RegisterParticleSystem(ps);
+                }
+
+                return;
+            }
+
+            // Create temporary ParticleSystem for preview.
+            RegisterParticleSystem(target.AddComponent<ParticleSystem>());
+        }
+
+        /// <summary>
+        /// Removes the temporary ParticleSystem associated with the specified GameObject.
+        /// </summary>
+        /// <param name="target"></param>
+        public static void Unregister(GameObject target)
+        {
+            if (!target) return;
+
+            var index = instance.m_PreviewObjects.IndexOf(target);
+            if (index < 0) return;
+
+            instance.m_PreviewObjects.RemoveAt(index);
+            if (HasTemporaryParticleSystem(target))
+            {
+                RemoveParticleSystem(target);
+            }
+        }
+
+        private static void RegisterParticleSystem(ParticleSystem ps)
+        {
+            if (!ps) return;
+            if (EditorApplication.isPlaying) return;
+
+            ps.hideFlags = k_TemporaryHideFlags;
+
+            var emission = ps.emission;
+            emission.enabled = false;
+            var shape = ps.shape;
+            shape.enabled = false;
+
+            if (ps.TryGetComponent<ParticleSystemRenderer>(out var psr))
+            {
+                psr.enabled = false;
+                psr.hideFlags = k_TemporaryHideFlags;
+            }
+
+            instance.m_PreviewObjects.Add(ps.gameObject);
+            EditorUtility.SetDirty(ps.gameObject);
+        }
+
+        /// <summary>
+        /// Removes the temporary ParticleSystem associated with the specified GameObject.
+        /// </summary>
+        /// <param name="target"></param>
+        private static void RemoveParticleSystem(GameObject target)
+        {
+            if (target.TryGetComponent<ParticleSystem>(out var ps))
+            {
+                Misc.DestroyImmediate(ps);
+                EditorUtility.SetDirty(target);
+            }
+
+            if (target.TryGetComponent<ParticleSystem>(out var psr))
+            {
+                Misc.DestroyImmediate(psr);
+                EditorUtility.SetDirty(target);
+            }
+        }
+
+        /// <summary>
+        /// Checks if the specified GameObject has a temporary ParticleSystem.
+        /// </summary>
+        private static bool HasTemporaryParticleSystem(GameObject target)
+        {
+            return target
+                   && instance.m_PreviewObjects.Contains(target)
+                   && target.TryGetComponent<ParticleSystem>(out var ps)
+                   && ps.hideFlags == k_TemporaryHideFlags;
+        }
+
+        /// <summary>
+        /// Checks if the specified GameObject has a permanent ParticleSystem.
+        /// </summary>
+        private static bool HasPermanentParticleSystem(GameObject target)
+        {
+            return target
+                   && target.TryGetComponent<ParticleSystem>(out var ps)
+                   && ps.hideFlags != k_TemporaryHideFlags;
+        }
+
+        private void OnSelectionChanged()
+        {
+            var selectedGameObjects = Selection.gameObjects;
+            for (var i = m_PreviewObjects.Count - 1; 0 <= i; i--)
+            {
+                var go = m_PreviewObjects[i];
+                if (!go)
+                {
+                    m_PreviewObjects.RemoveAt(i);
+                }
+                else if (EditorApplication.isPlaying && !selectedGameObjects.Contains(go))
+                {
+                    Unregister(go);
+                }
+            }
+        }
+
+        public static void DrawWarningForTemporary(GameObject[] gameObjects)
+        {
+            if (gameObjects == null || gameObjects.Length == 0 || !gameObjects.Any(HasTemporaryParticleSystem)) return;
+
+            if (HelpBoxButton(MessageType.Warning, k_TemporaryMesssage, "Remove"))
+            {
+                foreach (var go in gameObjects)
+                {
+                    if (HasTemporaryParticleSystem(go))
+                    {
+                        RemoveParticleSystem(go);
+                    }
+                }
+            }
+        }
+
+        public static void DrawWarningForPermanent(GameObject[] gameObjects)
+        {
+            if (gameObjects == null || gameObjects.Length == 0 || !gameObjects.Any(HasPermanentParticleSystem)) return;
+
+            if (HelpBoxButton(MessageType.Info, k_PermanentMesssage, "Remove"))
+            {
+                foreach (var go in gameObjects)
+                {
+                    if (HasPermanentParticleSystem(go))
+                    {
+                        RemoveParticleSystem(go);
+                        Unregister(go);
+                        Register(go);
+                    }
+                }
+            }
+        }
+
+        private static bool HelpBoxButton(MessageType messageType, string message, string buttonText)
+        {
+            EditorGUILayout.BeginHorizontal();
+            EditorGUILayout.HelpBox(message, messageType, true);
+            var clicked = GUILayout.Button(EditorGUIUtility.TrTempContent(buttonText));
+            EditorGUILayout.EndHorizontal();
+            return clicked;
+        }
+    }
+}
+#endif

Runtime/ParticleSystemPreviewer.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b171deb49fb7b471291108ad7e1c9baa
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Runtime/UIParticle.cs

@@ -3,22 +3,26 @@ using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 using Coffee.UIParticleInternal;
 using UnityEngine;
-using UnityEngine.EventSystems;
 using UnityEngine.Rendering;
 using UnityEngine.Serialization;
+using UnityEngine.UI;
 using Random = UnityEngine.Random;
 
 [assembly: InternalsVisibleTo("Coffee.UIParticle.Editor")]
+[assembly: InternalsVisibleTo("Coffee.UIParticle.Editor.Tests")]
+[assembly: InternalsVisibleTo("Coffee.UIParticle.PerformanceDemo")]
+[assembly: InternalsVisibleTo("Coffee.UIParticle.Demo")]
 
 namespace Coffee.UIExtensions
 {
     /// <summary>
     /// Render maskable and sortable particle effect ,without Camera, RenderTexture or Canvas.
     /// </summary>
+    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
-    public class UIParticle : UIBehaviour, ISerializationCallbackReceiver
+    public class UIParticle : MaskableGraphic, ISerializationCallbackReceiver
     {
         public enum AutoScalingMode
         {
@@ -60,7 +64,7 @@ namespace Coffee.UIExtensions
 
         [Tooltip("Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.")]
         [SerializeField]
-        private Vector3 m_Scale3D = new Vector3(1, 1, 1);
+        private Vector3 m_Scale3D = new Vector3(10, 10, 10);
 
         [Tooltip("If you want to update material properties (e.g. _MainTex_ST, _Color) in AnimationClip, " +
                  "use this to mark as animatable.")]
@@ -118,47 +122,23 @@ namespace Coffee.UIExtensions
         private float m_CustomViewSize = 10;
 
         [SerializeField]
-        private bool m_Maskable = true;
+        [Tooltip("Time scale multiplier.")]
+        private float m_TimeScaleMultiplier = 1;
 
         private readonly List<UIParticleRenderer> _renderers = new List<UIParticleRenderer>();
         private Camera _bakeCamera;
-        private Canvas _canvas;
         private int _groupId;
         private bool _isScaleStored;
         private Vector3 _storedScale;
         private DrivenRectTransformTracker _tracker;
 
-        public RectTransform rectTransform => transform as RectTransform;
-
-        public Canvas canvas
-        {
-            get
-            {
-                if (_canvas) return _canvas;
-
-                var tr = transform;
-                while (tr && !_canvas)
-                {
-                    if (tr.TryGetComponent(out _canvas)) return _canvas;
-                    tr = tr.parent;
-                }
-
-                return null;
-            }
-        }
-
         /// <summary>
-        /// Does this graphic allow masking.
+        /// Should this graphic be considered a target for ray-casting?
         /// </summary>
-        public bool maskable
+        public override bool raycastTarget
         {
-            get => m_Maskable;
+            get => false;
-            set
+            set { }
-            {
-                if (value == m_Maskable) return;
-                m_Maskable = value;
-                UpdateRendererMaterial();
-            }
         }
 
         /// <summary>
@@ -283,6 +263,22 @@ namespace Coffee.UIExtensions
             set => m_CustomViewSize = Mathf.Max(0.1f, value);
         }
 
+        /// <summary>
+        /// View size for Baking.
+        /// </summary>
+        public float viewSizeForBaking => useCustomView
+            ? m_CustomViewSize
+            : UIParticleProjectSettings.defaultViewSizeForBaking;
+
+        /// <summary>
+        /// Time scale multiplier.
+        /// </summary>
+        public float timeScaleMultiplier
+        {
+            get => m_TimeScaleMultiplier;
+            set => m_TimeScaleMultiplier = value;
+        }
+
         internal bool useMeshSharing => m_MeshSharing != MeshSharing.None;
 
         internal bool isPrimary =>
@@ -335,15 +331,15 @@ namespace Coffee.UIExtensions
 
         public Vector3 parentScale { get; private set; }
 
-        private Vector3 canvasScale { get; set; }
+        public Vector3 canvasScale { get; private set; }
 
         protected override void OnEnable()
         {
             _isScaleStored = false;
             ResetGroupId();
             UIParticleUpdater.Register(this);
+            RegisterDirtyMaterialCallback(UpdateRendererMaterial);
 
-            //
             if (0 < particles.Count)
             {
                 RefreshParticles(particles);
@@ -353,7 +349,7 @@ namespace Coffee.UIExtensions
                 RefreshParticles();
             }
 
-            UpdateRendererMaterial();
+            base.OnEnable();
         }
 
         /// <summary>
@@ -369,16 +365,11 @@ namespace Coffee.UIExtensions
 
             _isScaleStored = false;
             UIParticleUpdater.Unregister(this);
+            _renderers.RemoveAll(r => r == null);
             _renderers.ForEach(r => r.Reset());
-            _canvas = null;
+            UnregisterDirtyMaterialCallback(UpdateRendererMaterial);
-        }
 
-        /// <summary>
+            base.OnDisable();
-        /// Called when the state of the parent Canvas is changed.
-        /// </summary>
-        protected override void OnCanvasHierarchyChanged()
-        {
-            _canvas = null;
         }
 
         /// <summary>
@@ -388,14 +379,6 @@ namespace Coffee.UIExtensions
         {
         }
 
-        /// <summary>
-        /// This function is called when a direct or indirect parent of the transform of the GameObject has changed.
-        /// </summary>
-        protected override void OnTransformParentChanged()
-        {
-            _canvas = null;
-        }
-
         void ISerializationCallbackReceiver.OnBeforeSerialize()
         {
         }
@@ -496,7 +479,7 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < _renderers.Count; i++)
             {
                 var r = _renderers[i];
-                if (!r || !r.material) continue;
+                if (r == null || r.material == null) continue;
                 result.Add(r.material);
             }
         }
@@ -514,7 +497,7 @@ namespace Coffee.UIExtensions
         /// </summary>
         public void SetParticleSystemInstance(GameObject instance, bool destroyOldParticles)
         {
-            if (!instance) return;
+            if (instance == null) return;
 
             var childCount = transform.childCount;
             for (var i = 0; i < childCount; i++)
@@ -543,7 +526,7 @@ namespace Coffee.UIExtensions
         /// </summary>
         public void SetParticleSystemPrefab(GameObject prefab)
         {
-            if (!prefab) return;
+            if (prefab == null) return;
 
             SetParticleSystemInstance(Instantiate(prefab.gameObject), true);
         }
@@ -563,12 +546,17 @@ namespace Coffee.UIExtensions
         /// </summary>
         private void RefreshParticles(GameObject root)
         {
-            if (!root) return;
+            if (root == null) return;
             root.GetComponentsInChildren(true, particles);
             for (var i = particles.Count - 1; 0 <= i; i--)
             {
                 var ps = particles[i];
-                if (!ps || ps.GetComponentInParent<UIParticle>(true) != this)
+                if (!ps
+#if UNITY_EDITOR
+                    || (ps.hideFlags & HideFlags.DontSave) != 0 // Dummy ParticleSystems for preview.
+                    || ps.gameObject.CompareTag("EditorOnly") // Ignore "EditorOnly" tagged ParticleSystems.
+#endif
+                    || ps.GetComponentInParent<UIParticle>(true) != this) // Ignore ParticleSystems that are not under this UIParticle.
                 {
                     particles.RemoveAt(i);
                 }
@@ -616,13 +604,15 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < particleSystems.Count; i++)
             {
                 var ps = particleSystems[i];
-                if (!ps) continue;
+                if (ps == null) continue;
-                GetRenderer(j++).Set(this, ps, false);
+
+                var mainEmitter = ps.GetMainEmitter(particleSystems);
+                GetRenderer(j++).Set(this, ps, false, mainEmitter);
 
                 // If the trail is enabled, set it additionally.
                 if (ps.trails.enabled)
                 {
-                    GetRenderer(j++).Set(this, ps, true);
+                    GetRenderer(j++).Set(this, ps, true, mainEmitter);
                 }
             }
         }
@@ -665,7 +655,7 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < _renderers.Count; i++)
             {
                 var r = _renderers[i];
-                if (r) continue;
+                if (r != null) continue;
 
                 RefreshParticles(particles);
                 break;
@@ -675,7 +665,7 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < _renderers.Count; i++)
             {
                 var r = _renderers[i];
-                if (!r) continue;
+                if (r == null) continue;
 
                 r.UpdateMesh(bakeCamera);
             }
@@ -688,12 +678,23 @@ namespace Coffee.UIExtensions
                 : Random.Range(m_GroupId, m_GroupMaxId + 1);
         }
 
+        protected override void UpdateMaterial()
+        {
+        }
+
+        /// <summary>
+        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
+        /// </summary>
+        protected override void UpdateGeometry()
+        {
+        }
+
         private void UpdateRendererMaterial()
         {
             for (var i = 0; i < _renderers.Count; i++)
             {
                 var r = _renderers[i];
-                if (!r) continue;
+                if (r == null) continue;
                 r.maskable = maskable;
                 r.SetMaterialDirty();
             }
@@ -706,7 +707,7 @@ namespace Coffee.UIExtensions
                 _renderers.Add(UIParticleRenderer.AddRenderer(this, index));
             }
 
-            if (!_renderers[index])
+            if (_renderers[index] == null)
             {
                 _renderers[index] = UIParticleRenderer.AddRenderer(this, index);
             }
@@ -716,15 +717,15 @@ namespace Coffee.UIExtensions
 
         private Camera GetBakeCamera()
         {
-            if (!canvas) return Camera.main;
+            if (canvas == null) return Camera.main;
             if (!useCustomView && canvas.renderMode != RenderMode.ScreenSpaceOverlay && canvas.rootCanvas.worldCamera)
             {
                 return canvas.rootCanvas.worldCamera;
             }
 
-            if (_bakeCamera)
+            if (_bakeCamera != null)
             {
-                _bakeCamera.orthographicSize = useCustomView ? customViewSize : 10;
+                _bakeCamera.orthographicSize = viewSizeForBaking;
                 return _bakeCamera;
             }
 
@@ -741,7 +742,7 @@ namespace Coffee.UIExtensions
             }
 
             // Create baking camera.
-            if (!_bakeCamera)
+            if (_bakeCamera == null)
             {
                 var go = new GameObject("[generated] UIParticle BakingCamera");
                 go.SetActive(false);
@@ -751,7 +752,7 @@ namespace Coffee.UIExtensions
 
             // Setup baking camera.
             _bakeCamera.enabled = false;
-            _bakeCamera.orthographicSize = useCustomView ? customViewSize : 10;
+            _bakeCamera.orthographicSize = viewSizeForBaking;
             _bakeCamera.transform.SetPositionAndRotation(new Vector3(0, 0, -1000), Quaternion.identity);
             _bakeCamera.orthographic = true;
             _bakeCamera.farClipPlane = 2000f;
@@ -763,7 +764,7 @@ namespace Coffee.UIExtensions
             _bakeCamera.useOcclusionCulling = false;
 
             _bakeCamera.gameObject.SetActive(false);
-            _bakeCamera.gameObject.hideFlags = HideFlags.HideAndDontSave;
+            _bakeCamera.gameObject.hideFlags = UIParticleProjectSettings.globalHideFlags;
 
             return _bakeCamera;
         }

Runtime/UIParticle.cs.meta

@@ -5,7 +5,7 @@ MonoImporter:
   serializedVersion: 2
   defaultReferences: []
   executionOrder: 0
-  icon: {fileID: 2800000, guid: 5f0675613942149309588d556e33d990, type: 3}
+  icon: {instanceID: 0}
   userData: 
   assetBundleName: 
   assetBundleVariant: 

Runtime/UIParticleAttractor.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Events;
@@ -6,7 +7,7 @@ using UnityEngine.Events;
 namespace Coffee.UIExtensions
 {
     [ExecuteAlways]
-    public class UIParticleAttractor : MonoBehaviour
+    public class UIParticleAttractor : MonoBehaviour, ISerializationCallbackReceiver
     {
         public enum Movement
         {
@@ -22,8 +23,12 @@ namespace Coffee.UIExtensions
         }
 
         [SerializeField]
+        [HideInInspector]
         private ParticleSystem m_ParticleSystem;
 
+        [SerializeField]
+        private List<ParticleSystem> m_ParticleSystems = new List<ParticleSystem>();
+
         [Range(0.1f, 10f)]
         [SerializeField]
         private float m_DestinationRadius = 1;
@@ -45,7 +50,7 @@ namespace Coffee.UIExtensions
         [SerializeField]
         private UnityEvent m_OnAttracted;
 
-        private UIParticle _uiParticle;
+        private List<UIParticle> _uiParticles = new List<UIParticle>();
 
         public float destinationRadius
         {
@@ -84,25 +89,46 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// The target ParticleSystem to attract.
+        /// The target ParticleSystems to attract. Use <see cref="AddParticleSystem"/> and
+        /// <see cref="RemoveParticleSystem"/> to modify the list.
         /// </summary>
-#if UNITY_EDITOR
+        public IReadOnlyList<ParticleSystem> particleSystems => m_ParticleSystems;
-        public new ParticleSystem particleSystem
+
-#else
+        public void AddParticleSystem(ParticleSystem ps)
-        public ParticleSystem particleSystem
-#endif
         {
-            get => m_ParticleSystem;
+            if (m_ParticleSystems == null)
-            set
             {
-                m_ParticleSystem = value;
+                m_ParticleSystems = new List<ParticleSystem>();
-                ApplyParticleSystem();
             }
+
+            var i = m_ParticleSystems.IndexOf(ps);
+            if (0 <= i) return; // Already added: skip
+
+            m_ParticleSystems.Add(ps);
+            _uiParticles.Clear();
+        }
+
+        public void RemoveParticleSystem(ParticleSystem ps)
+        {
+            if (m_ParticleSystems == null)
+            {
+                return;
+            }
+
+            var i = m_ParticleSystems.IndexOf(ps);
+            if (i < 0) return; // Not found. skip
+
+            m_ParticleSystems.RemoveAt(i);
+            _uiParticles.Clear();
+        }
+
+        private void Awake()
+        {
+            UpgradeIfNeeded();
         }
 
         private void OnEnable()
         {
-            ApplyParticleSystem();
             UIParticleUpdater.Register(this);
         }
 
@@ -113,21 +139,31 @@ namespace Coffee.UIExtensions
 
         private void OnDestroy()
         {
-            _uiParticle = null;
+            _uiParticles = null;
-            m_ParticleSystem = null;
+            m_ParticleSystems = null;
         }
 
         internal void Attract()
         {
-            if (m_ParticleSystem == null) return;
+            // Collect UIParticle if needed (same size as m_ParticleSystems)
+            CollectUIParticlesIfNeeded();
 
-            var count = m_ParticleSystem.particleCount;
+            for (var particleIndex = 0; particleIndex < m_ParticleSystems.Count; particleIndex++)
-            if (count == 0) return;
+            {
+                var particleSystem = m_ParticleSystems[particleIndex];
+
+                // Skip: The ParticleSystem is not active
+                if (particleSystem == null || !particleSystem.gameObject.activeInHierarchy) continue;
+
+                // Skip: No active particles
+                var count = particleSystem.particleCount;
+                if (count == 0) continue;
 
                 var particles = ParticleSystemExtensions.GetParticleArray(count);
-            m_ParticleSystem.GetParticles(particles, count);
+                particleSystem.GetParticles(particles, count);
 
-            var dstPos = GetDestinationPosition();
+                var uiParticle = _uiParticles[particleIndex];
+                var dstPos = GetDestinationPosition(uiParticle, particleSystem);
                 for (var i = 0; i < count; i++)
                 {
                     // Attracted
@@ -166,32 +202,33 @@ namespace Coffee.UIExtensions
                     particles[i] = p;
                 }
 
-            m_ParticleSystem.SetParticles(particles, count);
+                particleSystem.SetParticles(particles, count);
+            }
         }
 
-        private Vector3 GetDestinationPosition()
+        private Vector3 GetDestinationPosition(UIParticle uiParticle, ParticleSystem particleSystem)
         {
-            var isUI = _uiParticle && _uiParticle.enabled;
+            var isUI = uiParticle != null && uiParticle.enabled;
-            var psPos = m_ParticleSystem.transform.position;
+            var psPos = particleSystem.transform.position;
             var attractorPos = transform.position;
             var dstPos = attractorPos;
-            var isLocalSpace = m_ParticleSystem.IsLocalSpace();
+            var isLocalSpace = particleSystem.IsLocalSpace();
 
             if (isLocalSpace)
             {
-                dstPos = m_ParticleSystem.transform.InverseTransformPoint(dstPos);
+                dstPos = particleSystem.transform.InverseTransformPoint(dstPos);
             }
 
             if (isUI)
             {
-                var inverseScale = _uiParticle.parentScale.Inverse();
+                var inverseScale = uiParticle.parentScale.Inverse();
-                var scale3d = _uiParticle.scale3DForCalc;
+                var scale3d = uiParticle.scale3DForCalc;
                 dstPos = dstPos.GetScaled(inverseScale, scale3d.Inverse());
 
                 // Relative mode
-                if (_uiParticle.positionMode == UIParticle.PositionMode.Relative)
+                if (uiParticle.positionMode == UIParticle.PositionMode.Relative)
                 {
-                    var diff = _uiParticle.transform.position - psPos;
+                    var diff = uiParticle.transform.position - psPos;
                     diff.Scale(scale3d - inverseScale);
                     diff.Scale(scale3d.Inverse());
                     dstPos += diff;
@@ -237,25 +274,59 @@ namespace Coffee.UIExtensions
             return Vector3.MoveTowards(current, target, speed);
         }
 
-        private void ApplyParticleSystem()
+        private void CollectUIParticlesIfNeeded()
         {
-            _uiParticle = null;
+            if (m_ParticleSystems.Count == 0 || _uiParticles.Count != 0) return;
-            if (m_ParticleSystem == null)
+
+            // Expand capacity
+            if (_uiParticles.Capacity < m_ParticleSystems.Capacity)
             {
+                _uiParticles.Capacity = m_ParticleSystems.Capacity;
+            }
+
+            // Find UIParticle that controls the ParticleSystem
+            for (var i = 0; i < m_ParticleSystems.Count; i++)
+            {
+                var ps = m_ParticleSystems[i];
+                if (ps == null)
+                {
+                    _uiParticles.Add(null);
+                    continue;
+                }
+
+                var uiParticle = ps.GetComponentInParent<UIParticle>(true);
+                _uiParticles.Add(uiParticle.particles.Contains(ps) ? uiParticle : null);
+            }
+        }
+
 #if UNITY_EDITOR
-                if (Application.isPlaying)
+        private void OnValidate()
+        {
+            _uiParticles.Clear();
+        }
 #endif
+
+        void ISerializationCallbackReceiver.OnBeforeSerialize()
         {
-                    Debug.LogError("No particle system attached to particle attractor script", this);
+            UpgradeIfNeeded();
         }
 
-                return;
+        void ISerializationCallbackReceiver.OnAfterDeserialize()
+        {
         }
 
-            _uiParticle = m_ParticleSystem.GetComponentInParent<UIParticle>(true);
+        private void UpgradeIfNeeded()
-            if (_uiParticle && !_uiParticle.particles.Contains(m_ParticleSystem))
         {
-                _uiParticle = null;
+            // Multiple ParticleSystems support: from 'm_ParticleSystem' to 'm_ParticleSystems'
+            if (m_ParticleSystem != null)
+            {
+                if (!m_ParticleSystems.Contains(m_ParticleSystem))
+                {
+                    m_ParticleSystems.Add(m_ParticleSystem);
+                }
+
+                m_ParticleSystem = null;
+                Debug.Log($"Upgraded!");
             }
         }
     }

Runtime/UIParticleAttractor.cs.meta

@@ -5,7 +5,7 @@ MonoImporter:
   serializedVersion: 2
   defaultReferences: []
   executionOrder: 0
-  icon: {instanceID: 0}
+  icon: {fileID: 2800000, guid: 5f0675613942149309588d556e33d990, type: 3}
   userData: 
   assetBundleName: 
   assetBundleVariant: 

Runtime/UIParticleProjectSettings.cs

@@ -2,6 +2,7 @@
 using Coffee.UIParticleInternal;
 using UnityEditor;
 using UnityEngine;
+using UnityEngine.Serialization;
 
 namespace Coffee.UIExtensions
 {
@@ -9,20 +10,59 @@ namespace Coffee.UIExtensions
     {
         [Header("Setting")]
         [SerializeField]
-        internal bool m_EnableLinearToGamma = true;
+        [Tooltip("Automatically correct the color space of the mesh.")]
+        [FormerlySerializedAs("m_EnableLinearToGamma")]
+        private bool m_AutoColorCorrection = true;
 
-        public static bool enableLinearToGamma
+        public static bool autoColorCorrection
         {
-            get => instance.m_EnableLinearToGamma;
+            get => instance.m_AutoColorCorrection;
-            set => instance.m_EnableLinearToGamma = value;
+            set => instance.m_AutoColorCorrection = value;
         }
 
+        [SerializeField]
+        [Tooltip("Default view size for baking particle systems.")]
+        private float m_DefaultViewSizeForBaking = 10;
+
+        public static float defaultViewSizeForBaking
+        {
+            get => instance.m_DefaultViewSizeForBaking;
+            set => instance.m_DefaultViewSizeForBaking = value;
+        }
+
+        [Header("Editor")]
+        [Tooltip("Hide the automatically generated objects.\n" +
+                 "  - UIParticleRenderer\n" +
+                 "  - UIParticle BakingCamera")]
+        [SerializeField]
+        private bool m_HideGeneratedObjects = true;
+
+        [Tooltip("When selecting UIParticle, a temporary ParticleSystem is generated for preview.")]
+        [SerializeField]
+        private bool m_PreviewOnSelect = true;
+
+        internal static HideFlags globalHideFlags => instance.m_HideGeneratedObjects
+            ? HideFlags.DontSave | HideFlags.NotEditable | HideFlags.HideInHierarchy | HideFlags.HideInInspector
+            : HideFlags.DontSave | HideFlags.NotEditable;
+
+        internal static bool previewOnSelect => instance.m_PreviewOnSelect;
+
 #if UNITY_EDITOR
         [SettingsProvider]
         private static SettingsProvider CreateSettingsProvider()
         {
             return new PreloadedProjectSettingsProvider("Project/UI/UI Particle");
         }
+
+        [CustomEditor(typeof(UIParticleProjectSettings))]
+        private class UIParticleProjectSettingsEditor : Editor
+        {
+            public override void OnInspectorGUI()
+            {
+                EditorGUIUtility.labelWidth = 180;
+                base.OnInspectorGUI();
+            }
+        }
 #endif
     }
 }

Runtime/UIParticleProjectSettings.cs.meta

@@ -5,7 +5,7 @@ MonoImporter:
   serializedVersion: 2
   defaultReferences: []
   executionOrder: 0
-  icon: {instanceID: 0}
+  icon: {fileID: 2800000, guid: 5f0675613942149309588d556e33d990, type: 3}
   userData: 
   assetBundleName: 
   assetBundleVariant: 

Runtime/UIParticleRenderer.cs

@@ -4,7 +4,6 @@
 #elif UNITY_2022_3_OR_NEWER
 #define PS_BAKE_API_V2
 #endif
-
 using System;
 using System.Collections.Generic;
 using Coffee.UIParticleInternal;
@@ -16,6 +15,7 @@ using UnityEngine.UI;
 
 namespace Coffee.UIExtensions
 {
+    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
@@ -26,10 +26,12 @@ namespace Coffee.UIExtensions
         private static readonly List<Material> s_Materials = new List<Material>(2);
         private static MaterialPropertyBlock s_Mpb;
         private static readonly Vector3[] s_Corners = new Vector3[4];
+        private static readonly VertexHelper s_VertexHelper = new VertexHelper();
         private bool _delay;
         private int _index;
         private bool _isPrevStored;
         private bool _isTrail;
+        private bool _meshCleared;
         private Bounds _lastBounds;
         private Material _materialForRendering;
         private Material _modifiedMaterial;
@@ -41,6 +43,7 @@ namespace Coffee.UIExtensions
         private Vector2Int _prevScreenSize;
         private bool _preWarm;
         private ParticleSystemRenderer _renderer;
+        private ParticleSystem _mainEmitter;
 
         public override Texture mainTexture => _isTrail ? null : _particleSystem.GetTextureForSprite();
 
@@ -54,7 +57,7 @@ namespace Coffee.UIExtensions
                 s_Corners[1] = transform.TransformPoint(_lastBounds.min.x, _lastBounds.max.y, 0);
                 s_Corners[2] = transform.TransformPoint(_lastBounds.max.x, _lastBounds.max.y, 0);
                 s_Corners[3] = transform.TransformPoint(_lastBounds.max.x, _lastBounds.min.y, 0);
-                if (canvas)
+                if (canvas != null)
                 {
                     var worldToLocalMatrix = canvas.rootCanvas.transform.worldToLocalMatrix;
                     for (var i = 0; i < 4; ++i)
@@ -94,7 +97,7 @@ namespace Coffee.UIExtensions
         {
             get
             {
-                if (!_materialForRendering)
+                if (_materialForRendering == null)
                 {
                     _materialForRendering = base.materialForRendering;
                 }
@@ -105,7 +108,7 @@ namespace Coffee.UIExtensions
 
         public void Reset(int index = -1)
         {
-            if (_renderer)
+            if (_renderer != null)
             {
                 _renderer.enabled = true;
             }
@@ -113,13 +116,14 @@ namespace Coffee.UIExtensions
             _parent = null;
             _particleSystem = null;
             _renderer = null;
+            _mainEmitter = null;
             if (0 <= index)
             {
                 _index = index;
             }
 
             //_emitter = null;
-            if (this && isActiveAndEnabled)
+            if (isActiveAndEnabled)
             {
                 material = null;
                 canvasRenderer.Clear();
@@ -137,7 +141,8 @@ namespace Coffee.UIExtensions
         {
             base.OnEnable();
 
-            if (!s_CombineInstances[0].mesh)
+            hideFlags = UIParticleProjectSettings.globalHideFlags;
+            if (s_CombineInstances[0].mesh == null)
             {
                 s_CombineInstances[0].mesh = new Mesh
                 {
@@ -161,7 +166,7 @@ namespace Coffee.UIExtensions
             // Create renderer object.
             var go = new GameObject("[generated] UIParticleRenderer", typeof(UIParticleRenderer))
             {
-                hideFlags = HideFlags.HideAndDontSave,
+                hideFlags = UIParticleProjectSettings.globalHideFlags,
                 layer = parent.gameObject.layer
             };
 
@@ -201,11 +206,10 @@ namespace Coffee.UIExtensions
                 return modifiedMaterial;
             }
 
-            //
             var hash = new Hash128(
-                modifiedMaterial ? (uint)modifiedMaterial.GetInstanceID() : 0,
+                modifiedMaterial ? (uint)modifiedMaterial.GetHashCode() : 0,
-                texture ? (uint)texture.GetInstanceID() : 0,
+                texture ? (uint)texture.GetHashCode() : 0,
-                0 < _parent.m_AnimatableProperties.Length ? (uint)GetInstanceID() : 0,
+                0 < _parent.m_AnimatableProperties.Length ? (uint)GetHashCode() : 0,
 #if UNITY_EDITOR
                 (uint)EditorJsonUtility.ToJson(modifiedMaterial).GetHashCode()
 #else
@@ -224,7 +228,7 @@ namespace Coffee.UIExtensions
             return _modifiedMaterial;
         }
 
-        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail)
+        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail, ParticleSystem mainEmitter)
         {
             _parent = parent;
             maskable = parent.maskable;
@@ -247,10 +251,7 @@ namespace Coffee.UIExtensions
 
             ps.TryGetComponent(out _renderer);
             _renderer.enabled = false;
-
-            //_emitter = emitter;
             _isTrail = isTrail;
-
             _renderer.GetSharedMaterials(s_Materials);
             material = s_Materials[isTrail ? 1 : 0];
             s_Materials.Clear();
@@ -267,6 +268,7 @@ namespace Coffee.UIExtensions
             _prevScreenSize = new Vector2Int(Screen.width, Screen.height);
             _prevCanvasScale = canvas ? canvas.scaleFactor : 1f;
             _delay = true;
+            _mainEmitter = mainEmitter;
 
             canvasRenderer.SetTexture(null);
 
@@ -283,28 +285,47 @@ namespace Coffee.UIExtensions
                 || !transform.lossyScale.GetScaled(_parent.scale3DForCalc).IsVisible() // Scale is not visible.
                 || (!_particleSystem.IsAlive() && !_particleSystem.isPlaying) // No particle.
                 || (_isTrail && !_particleSystem.trails.enabled) // Trail, but it is not enabled.
-#if UNITY_2018_3_OR_NEWER
-                || canvasRenderer.GetInheritedAlpha() <
-                0.01f // #102: Do not bake particle system to mesh when the alpha is zero.
-#endif
             )
             {
+                // Skip clearing the mesh if it's already cleared.
+                if (_meshCleared) return;
+
                 Profiler.BeginSample("[UIParticleRenderer] Clear Mesh");
                 workerMesh.Clear();
                 canvasRenderer.SetMesh(workerMesh);
                 _lastBounds = new Bounds();
+                _meshCleared = true;
                 Profiler.EndSample();
 
                 return;
             }
 
+            // Reset custom data.
+            // var customData = _particleSystem.customData;
+            // if (!customData.enabled || customData.GetMode(ParticleSystemCustomData.Custom1) == ParticleSystemCustomDataMode.Disabled)
+            // {
+            //     customData.SetVector(ParticleSystemCustomData.Custom1, 0, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom1, 1, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom1, 2, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom1, 3, 0);
+            // }
+            //
+            // if (!customData.enabled || customData.GetMode(ParticleSystemCustomData.Custom2) == ParticleSystemCustomDataMode.Disabled)
+            // {
+            //     customData.SetVector(ParticleSystemCustomData.Custom2, 0, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom2, 1, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom2, 2, 0);
+            //     customData.SetVector(ParticleSystemCustomData.Custom2, 3, 0);
+            // }
+
+            _meshCleared = false;
             var main = _particleSystem.main;
             var scale = GetWorldScale();
             var psPos = _particleSystem.transform.position;
 
             // Simulate particles.
             Profiler.BeginSample("[UIParticle] Bake Mesh > Simulate Particles");
-            if (!_isTrail && _parent.canSimulate)
+            if (!_isTrail && _parent.canSimulate && !_mainEmitter)
             {
 #if UNITY_EDITOR
                 if (!Application.isPlaying)
@@ -315,6 +336,13 @@ namespace Coffee.UIExtensions
 #endif
                 {
                     ResolveResolutionChange(psPos, scale);
+
+                    // fix: second and subsequent bursts not displayed when world simulation and non-looping. (#326)
+                    if (!_particleSystem.IsLocalSpace() && !main.loop && _particleSystem.time == 0)
+                    {
+                        _delay = true;
+                    }
+
                     Simulate(scale, _parent.isPaused || _delay);
 
                     if (_delay && !_parent.isPaused)
@@ -417,22 +445,25 @@ namespace Coffee.UIExtensions
                 _lastBounds = bounds;
 
                 // Convert linear color to gamma color.
-                if (UIParticleProjectSettings.enableLinearToGamma && canvas.ShouldGammaToLinearInMesh())
+                if (UIParticleProjectSettings.autoColorCorrection && canvas.ShouldGammaToLinearInMesh())
                 {
                     workerMesh.LinearToGamma();
                 }
 
-                var components = ListPool<Component>.Rent();
+                var components = InternalListPool<Component>.Rent();
                 GetComponents(typeof(IMeshModifier), components);
-
+                if (0 < components.Count)
-#pragma warning disable CS0618 // Type or member is obsolete
+                {
+                    workerMesh.CopyTo(s_VertexHelper);
                     for (var i = 0; i < components.Count; i++)
                     {
-                    ((IMeshModifier)components[i]).ModifyMesh(workerMesh);
+                        ((IMeshModifier)components[i]).ModifyMesh(s_VertexHelper);
                     }
-#pragma warning restore CS0618 // Type or member is obsolete
 
-                ListPool<Component>.Return(ref components);
+                    s_VertexHelper.FillMesh(workerMesh);
+                }
+
+                InternalListPool<Component>.Return(ref components);
             }
 
             Profiler.EndSample();
@@ -444,7 +475,7 @@ namespace Coffee.UIExtensions
 
             // Get grouped renderers.
             Profiler.BeginSample("[UIParticleRenderer] Set Mesh");
-            var renderers = ListPool<UIParticleRenderer>.Rent();
+            var renderers = InternalListPool<UIParticleRenderer>.Rent();
             if (_parent.useMeshSharing)
             {
                 UIParticleUpdater.GetGroupedRenderers(_parent.groupId, _index, renderers);
@@ -461,7 +492,7 @@ namespace Coffee.UIExtensions
                 r.canvasRenderer.SetMaterial(materialForRendering, 0);
             }
 
-            ListPool<UIParticleRenderer>.Return(ref renderers);
+            InternalListPool<UIParticleRenderer>.Return(ref renderers);
 
             if (_parent.canRender)
             {
@@ -544,6 +575,30 @@ namespace Coffee.UIExtensions
                     return Matrix4x4.Translate(psPos)
                            * Matrix4x4.Scale(scale);
                 case ParticleSystemSimulationSpace.World:
+                    if (_isTrail)
+                    {
+                        return Matrix4x4.Translate(psPos)
+                               * Matrix4x4.Scale(scale)
+                               * Matrix4x4.Translate(-psPos);
+                    }
+
+                    if (_mainEmitter)
+                    {
+                        if (_mainEmitter.IsLocalSpace())
+                        {
+                            return Matrix4x4.Translate(psPos)
+                                   * Matrix4x4.Scale(scale)
+                                   * Matrix4x4.Translate(-psPos);
+                        }
+                        else
+                        {
+                            psPos = _particleSystem.transform.position - _mainEmitter.transform.position;
+                            return Matrix4x4.Translate(psPos)
+                                   * Matrix4x4.Scale(scale)
+                                   * Matrix4x4.Translate(-psPos);
+                        }
+                    }
+
                     return Matrix4x4.Scale(scale);
                 case ParticleSystemSimulationSpace.Custom:
                     return Matrix4x4.Translate(_particleSystem.main.customSimulationSpace.position.GetScaled(scale))
@@ -606,6 +661,7 @@ namespace Coffee.UIExtensions
                 : main.useUnscaledTime
                     ? Time.unscaledDeltaTime
                     : Time.deltaTime;
+            deltaTime *= _parent.timeScaleMultiplier;
 
             // Pre-warm:
             if (0 < deltaTime && _preWarm)
@@ -686,7 +742,7 @@ namespace Coffee.UIExtensions
             if (s_Mpb.isEmpty) return;
 
             // #41: Copy the value from MaterialPropertyBlock to CanvasRenderer
-            if (!materialForRendering) return;
+            if (materialForRendering == null) return;
 
             for (var i = 0; i < _parent.m_AnimatableProperties.Length; i++)
             {

Runtime/UIParticleUpdater.cs

@@ -16,37 +16,61 @@ namespace Coffee.UIExtensions
 
         public static void Register(UIParticle particle)
         {
-            if (!particle) return;
+            if (particle == null) return;
             s_ActiveParticles.Add(particle);
         }
 
         public static void Unregister(UIParticle particle)
         {
-            if (!particle) return;
+            if (particle == null) return;
             s_ActiveParticles.Remove(particle);
         }
 
         public static void Register(UIParticleAttractor attractor)
         {
-            if (!attractor) return;
+            if (attractor == null) return;
             s_ActiveAttractors.Add(attractor);
         }
 
         public static void Unregister(UIParticleAttractor attractor)
         {
-            if (!attractor) return;
+            if (attractor == null) return;
             s_ActiveAttractors.Remove(attractor);
         }
 
 #if UNITY_EDITOR
+#if UNITY_2019_3_OR_NEWER
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+        private static void OnDomainReload()
+        {
+            s_ActiveParticles.Clear();
+            s_ActiveAttractors.Clear();
+            s_UpdatedGroupIds.Clear();
+            s_FrameCount = 0;
+        }
+#endif
+
         [InitializeOnLoadMethod]
+        private static void InitializeOnLoad()
+        {
+            UIExtraCallbacks.onAfterCanvasRebuild += Refresh;
+
+            EditorApplication.playModeStateChanged += state =>
+            {
+                UIExtraCallbacks.onAfterCanvasRebuild -= Refresh;
+                if (state == PlayModeStateChange.EnteredEditMode || state == PlayModeStateChange.EnteredPlayMode)
+                {
+                    UIExtraCallbacks.onAfterCanvasRebuild += Refresh;
+                }
+            };
+        }
 #else
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
-#endif
         private static void InitializeOnLoad()
         {
             UIExtraCallbacks.onAfterCanvasRebuild += Refresh;
         }
+#endif
 
         private static void Refresh()
         {
@@ -58,7 +82,7 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < s_ActiveParticles.Count; i++)
             {
                 var uip = s_ActiveParticles[i];
-                if (!uip || !uip.canvas || !uip.isPrimary || !s_UpdatedGroupIds.Add(uip.groupId)) continue;
+                if (uip == null || uip.canvas == null || !uip.isPrimary || !s_UpdatedGroupIds.Add(uip.groupId)) continue;
 
                 uip.UpdateTransformScale();
                 uip.UpdateRenderers();
@@ -68,7 +92,7 @@ namespace Coffee.UIExtensions
             for (var i = 0; i < s_ActiveParticles.Count; i++)
             {
                 var uip = s_ActiveParticles[i];
-                if (!uip || !uip.canvas) continue;
+                if (uip == null || uip.canvas == null) continue;
 
                 uip.UpdateTransformScale();
 
@@ -112,7 +136,7 @@ namespace Coffee.UIExtensions
                 var uip = s_ActiveParticles[i];
                 if (!uip.useMeshSharing || uip.groupId != groupId) continue;
                 if (uip.isPrimary) return uip;
-                if (!primary && uip.canSimulate) primary = uip;
+                if (primary == null && uip.canSimulate) primary = uip;
             }
 
             return primary;

Runtime/Utilities/ParticleSystemExtensions.cs

@@ -12,12 +12,8 @@ namespace Coffee.UIParticleInternal
         public static ParticleSystem.Particle[] GetParticleArray(int size)
         {
             if (s_TmpParticles.Length < size)
-            {
-                while (s_TmpParticles.Length < size)
             {
                 size = Mathf.NextPowerOfTwo(size);
-                }
-
                 s_TmpParticles = new ParticleSystem.Particle[size];
             }
 
@@ -88,15 +84,15 @@ namespace Coffee.UIParticleInternal
                 var bRenderer = b.GetComponent<ParticleSystemRenderer>();
 
                 // Render queue: ascending
-                var aMat = aRenderer.sharedMaterial ? aRenderer.sharedMaterial : aRenderer.trailMaterial;
+                var aMat = aRenderer.sharedMaterial != null ? aRenderer.sharedMaterial : aRenderer.trailMaterial;
-                var bMat = bRenderer.sharedMaterial ? bRenderer.sharedMaterial : bRenderer.trailMaterial;
+                var bMat = bRenderer.sharedMaterial != null ? bRenderer.sharedMaterial : bRenderer.trailMaterial;
-                if (!aMat && !bMat) return 0;
+                if (aMat == null && bMat == null) return 0;
-                if (!aMat) return -1;
+                if (aMat == null) return -1;
-                if (!bMat) return 1;
+                if (bMat == null) return 1;
 
                 if (sortByMaterial)
                 {
-                    return aMat.GetInstanceID() - bMat.GetInstanceID();
+                    return aMat.GetHashCode() - bMat.GetHashCode();
                 }
 
                 if (aMat.renderQueue != bMat.renderQueue)
@@ -135,7 +131,7 @@ namespace Coffee.UIParticleInternal
         {
             for (var i = 0; i < list.Count; i++)
             {
-                if (list[i].GetInstanceID() == ps.GetInstanceID())
+                if (list[i].GetHashCode() == ps.GetHashCode())
                 {
                     return i;
                 }
@@ -146,7 +142,7 @@ namespace Coffee.UIParticleInternal
 
         public static Texture2D GetTextureForSprite(this ParticleSystem self)
         {
-            if (!self) return null;
+            if (self == null) return null;
 
             // Get sprite's texture.
             var tsaModule = self.textureSheetAnimation;
@@ -155,7 +151,7 @@ namespace Coffee.UIParticleInternal
             for (var i = 0; i < tsaModule.spriteCount; i++)
             {
                 var sprite = tsaModule.GetSprite(i);
-                if (!sprite) continue;
+                if (sprite == null) continue;
 
                 return sprite.GetActualTexture();
             }
@@ -167,9 +163,38 @@ namespace Coffee.UIParticleInternal
         {
             foreach (var p in self)
             {
-                if (!p) continue;
+                if (p == null) continue;
                 action.Invoke(p);
             }
         }
+
+        public static ParticleSystem GetMainEmitter(this ParticleSystem self, List<ParticleSystem> list)
+        {
+            if (self == null || list == null || list.Count == 0) return null;
+
+            for (var i = 0; i < list.Count; i++)
+            {
+                var parent = list[i];
+                if (parent != self && IsSubEmitterOf(self, parent)) return parent;
+            }
+
+            return null;
+        }
+
+        public static bool IsSubEmitterOf(this ParticleSystem self, ParticleSystem parent)
+        {
+            if (self == null || parent == null) return false;
+
+            var subEmitters = parent.subEmitters;
+            if (!subEmitters.enabled) return false; // No sub emitters.
+
+            var count = subEmitters.subEmittersCount;
+            for (var i = 0; i < count; i++)
+            {
+                if (subEmitters.GetSubEmitterSystem(i) == self) return true;
+            }
+
+            return false;
+        }
     }
 }

Samples~/Demo/Animations/ColorArrayInjection.cs

@@ -0,0 +1,32 @@
+using System.Linq;
+using UnityEngine;
+
+[RequireComponent(typeof(ParticleSystemRenderer))]
+public class ColorArrayInjection : MonoBehaviour
+{
+    [SerializeField] private string m_PropertyName = "_Color2";
+
+    [SerializeField] private Color[] m_Colors = new Color[4]
+    {
+        Color.red,
+        Color.green,
+        Color.blue,
+        Color.yellow
+    };
+
+    private void OnEnable()
+    {
+        if (TryGetComponent<ParticleSystemRenderer>(out var psr))
+        {
+            var mpb = new MaterialPropertyBlock();
+            psr.GetPropertyBlock(mpb);
+            mpb.SetVectorArray(m_PropertyName, m_Colors.Select(x => new Vector4(x.r, x.g, x.b, 1.0f)).ToArray());
+            psr.SetPropertyBlock(mpb);
+        }
+    }
+
+    private void OnValidate()
+    {
+        OnEnable();
+    }
+}

Samples~/Demo/Animations/ColorArrayInjection.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: da4c2e90ecd3d4dd4a520099c08cf493
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Samples~/Demo/Materials/UIAdditive+Color.shader

@@ -0,0 +1,160 @@
+Shader "UI/Additive And Color"
+{
+    Properties
+    {
+        _MainTex ("Sprite Texture", 2D) = "white" {}
+        _Color ("Tint", Color) = (1,1,1,1)
+
+        _StencilComp ("Stencil Comparison", Float) = 8
+        _Stencil ("Stencil ID", Float) = 0
+        _StencilOp ("Stencil Operation", Float) = 0
+        _StencilWriteMask ("Stencil Write Mask", Float) = 255
+        _StencilReadMask ("Stencil Read Mask", Float) = 255
+
+        _ColorMask ("Color Mask", Float) = 15
+
+        [Toggle(UNITY_UI_ALPHACLIP)] _UseUIAlphaClip ("Use Alpha Clip", Float) = 0
+    }
+
+    SubShader
+    {
+        Tags
+        {
+            "Queue"="Transparent"
+            "IgnoreProjector"="True"
+            "RenderType"="Transparent"
+            "PreviewType"="Plane"
+            "CanUseSpriteAtlas"="True"
+        }
+
+        Stencil
+        {
+            Ref [_Stencil]
+            Comp [_StencilComp]
+            Pass [_StencilOp]
+            ReadMask [_StencilReadMask]
+            WriteMask [_StencilWriteMask]
+        }
+
+        Cull Off
+        Lighting Off
+        ZWrite Off
+        ZTest [unity_GUIZTestMode]
+        Fog { Mode Off }
+        Blend One One
+        ColorMask [_ColorMask]
+
+        Pass
+        {
+            Name "Default"
+            CGPROGRAM
+            #pragma vertex vert
+            #pragma fragment frag
+            #pragma target 2.0
+
+            #include "UnityCG.cginc"
+            #include "UnityUI.cginc"
+
+            #pragma multi_compile __ UNITY_UI_CLIP_RECT
+            #pragma multi_compile __ UNITY_UI_ALPHACLIP
+
+            struct appdata_t
+            {
+                float4 vertex : POSITION;
+                float4 color : COLOR;
+                float2 texcoord : TEXCOORD0;
+                UNITY_VERTEX_INPUT_INSTANCE_ID
+            };
+
+            struct v2f
+            {
+                float4 vertex : SV_POSITION;
+                fixed4 color : COLOR;
+                float2 texcoord : TEXCOORD0;
+                float4 worldPosition : TEXCOORD1;
+                float4 mask : TEXCOORD2;
+                UNITY_VERTEX_OUTPUT_STEREO
+            };
+
+            fixed4 _Color;
+            sampler2D _MainTex;
+            float4 _MainTex_ST;
+            fixed4 _TextureSampleAdd;
+            float4 _ClipRect;
+            float _UIMaskSoftnessX;
+            float _UIMaskSoftnessY;
+            int _UIVertexColorAlwaysGammaSpace;
+            #define LENGTH 4
+            float4 _Color2[4];
+
+            half3 _UIGammaToLinear(half3 value)
+            {
+                half3 low = 0.0849710 * value - 0.000163029;
+                half3 high = value * (value * (value * 0.265885 + 0.736584) - 0.00980184) + 0.00319697;
+
+                // We should be 0.5 away from any actual gamma value stored in an 8 bit channel
+                const half3 split = (half3)0.0725490; // Equals 18.5 / 255
+                return (value < split) ? low : high;
+            }
+
+            v2f vert(appdata_t v)
+            {
+                v2f OUT;
+                UNITY_SETUP_INSTANCE_ID(v);
+                UNITY_INITIALIZE_VERTEX_OUTPUT_STEREO(OUT);
+                float4 vPosition = UnityObjectToClipPos(v.vertex);
+                OUT.worldPosition = v.vertex;
+                OUT.vertex = vPosition;
+
+                float2 pixelSize = vPosition.w;
+                pixelSize /= float2(1, 1) * abs(mul((float2x2)UNITY_MATRIX_P, _ScreenParams.xy));
+
+                float4 clampedRect = clamp(_ClipRect, -2e10, 2e10);
+                float2 maskUV = (v.vertex.xy - clampedRect.xy) / (clampedRect.zw - clampedRect.xy);
+                OUT.texcoord = TRANSFORM_TEX(v.texcoord.xy, _MainTex);
+                OUT.mask = float4(v.vertex.xy * 2 - clampedRect.xy - clampedRect.zw, 0.25 / (0.25 * half2(_UIMaskSoftnessX, _UIMaskSoftnessY) + abs(pixelSize.xy)));
+
+                if (_UIVertexColorAlwaysGammaSpace)
+                {
+                    #ifndef UNITY_COLORSPACE_GAMMA
+                    v.color.rgb = _UIGammaToLinear(v.color.rgb);
+                    #endif
+                }
+
+                OUT.color = v.color * _Color;
+                return OUT;
+            }
+
+            fixed4 frag(v2f IN) : SV_Target
+            {
+                //Round up the alpha color coming from the interpolator (to 1.0/256.0 steps)
+                //The incoming alpha could have numerical instability, which makes it very sensible to
+                //HDR color transparency blend, when it blends with the world's texture.
+                const half alphaPrecision = half(0xff);
+                const half invAlphaPrecision = half(1.0 / alphaPrecision);
+                IN.color.a = round(IN.color.a * alphaPrecision) * invAlphaPrecision;
+
+                half4 color = IN.color * (tex2D(_MainTex, IN.texcoord) + _TextureSampleAdd);
+
+                #ifdef UNITY_UI_CLIP_RECT
+                half2 m = saturate((_ClipRect.zw - _ClipRect.xy - abs(IN.mask.xy)) * IN.mask.zw);
+                color.a *= m.x * m.y;
+                #endif
+
+                #ifdef UNITY_UI_ALPHACLIP
+                clip(color.a - 0.001);
+                #endif
+
+                fixed3 fc = _Color2[floor(color.r*LENGTH-0.01)].rgb;
+                if (0.1 < fc.r || 0.1 < fc.g || 0.1 < fc.b)
+                {
+                    color.rgb = fc;
+                }
+                color.rgb *= color.a;
+
+                return color;
+            }
+            ENDCG
+        }
+    }
+}

Samples~/Demo/Materials/UIAdditive+Color.shader.meta

@@ -0,0 +1,9 @@
+fileFormatVersion: 2
+guid: 9cc9ed37ff19d40e684526abbc1d44a6
+ShaderImporter:
+  externalObjects: {}
+  defaultTextures: []
+  nonModifiableTextures: []
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Samples~/Demo/Materials/UIParticle_Demo_Animatable+Color.mat

@@ -0,0 +1,90 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!21 &2100000
+Material:
+  serializedVersion: 8
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_Name: UIParticle_Demo_Animatable+Color
+  m_Shader: {fileID: 4800000, guid: 9cc9ed37ff19d40e684526abbc1d44a6, type: 3}
+  m_Parent: {fileID: 0}
+  m_ModifiedSerializedProperties: 0
+  m_ValidKeywords: []
+  m_InvalidKeywords: []
+  m_LightmapFlags: 4
+  m_EnableInstancingVariants: 0
+  m_DoubleSidedGI: 0
+  m_CustomRenderQueue: -1
+  stringTagMap: {}
+  disabledShaderPasses: []
+  m_LockedProperties: 
+  m_SavedProperties:
+    serializedVersion: 3
+    m_TexEnvs:
+    - _BumpMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _DetailAlbedoMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _DetailMask:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _DetailNormalMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _EmissionMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _MainTex:
+        m_Texture: {fileID: 10300, guid: 0000000000000000f000000000000000, type: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _MetallicGlossMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _OcclusionMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    - _ParallaxMap:
+        m_Texture: {fileID: 0}
+        m_Scale: {x: 1, y: 1}
+        m_Offset: {x: 0, y: 0}
+    m_Ints: []
+    m_Floats:
+    - _BumpScale: 1
+    - _ColorMask: 15
+    - _Cutoff: 0.5
+    - _DetailNormalMapScale: 1
+    - _DstBlend: 0
+    - _GlossMapScale: 1
+    - _Glossiness: 0.5
+    - _GlossyReflections: 1
+    - _Metallic: 0
+    - _Mode: 0
+    - _OcclusionStrength: 1
+    - _Parallax: 0.02
+    - _SmoothnessTextureChannel: 0
+    - _SpecularHighlights: 1
+    - _SrcBlend: 1
+    - _Stencil: 0
+    - _StencilComp: 8
+    - _StencilOp: 0
+    - _StencilReadMask: 255
+    - _StencilWriteMask: 255
+    - _UVSec: 0
+    - _UseUIAlphaClip: 0
+    - _ZWrite: 1
+    m_Colors:
+    - _Color: {r: 1, g: 1, b: 1, a: 1}
+    - _EmissionColor: {r: 0, g: 0, b: 0, a: 1}
+  m_BuildTextureStacks: []

Samples~/Demo/Materials/UIParticle_Demo_Animatable+Color.mat.meta

@@ -1,8 +1,8 @@
 fileFormatVersion: 2
-guid: 7a55e246f37df405bac88eac692e3a86
+guid: 81f29a831022a4756b17daa366d67e10
-folderAsset: yes
+NativeFormatImporter:
-DefaultImporter:
   externalObjects: {}
+  mainObjectFileID: 2100000
   userData: 
   assetBundleName: 
   assetBundleVariant: 

Samples~/Demo/Materials/UIParticle_Demo_Animatable.mat

@@ -8,8 +8,8 @@ Material:
   m_PrefabInstance: {fileID: 0}
   m_PrefabAsset: {fileID: 0}
   m_Name: UIParticle_Demo_Animatable
-  m_Shader: {fileID: 4800000, guid: ecfa8f5732b504ef98fba10aa18d0326, type: 3}
+  m_Shader: {fileID: 4800000, guid: 9cc9ed37ff19d40e684526abbc1d44a6, type: 3}
-  m_ShaderKeywords: 
+  m_Parent: {fileID: 0}
   m_LightmapFlags: 4
   m_EnableInstancingVariants: 0
   m_DoubleSidedGI: 0

Samples~/Demo/Prefabs/UIParticle_Demo_Animatable.prefab

@@ -69,6 +69,8 @@ MonoBehaviour:
   m_AnimatableProperties:
   - m_Name: _MainTex_ST
     m_Type: 1
+  - m_Name: _Color2
+    m_Type: 103
   m_Particles:
   - {fileID: 198637387440798640}
   m_MeshSharing: 0
@@ -88,6 +90,7 @@ GameObject:
   - component: {fileID: 199176884810573912}
   - component: {fileID: 222047182059782320}
   - component: {fileID: 95475093951880840}
+  - component: {fileID: 3543952012814938654}
   m_Layer: 0
   m_Name: UvAnimParticle
   m_TagString: Untagged
@@ -4864,3 +4867,21 @@ Animator:
   m_HasTransformHierarchy: 1
   m_AllowConstantClipSamplingOptimization: 1
   m_KeepAnimatorControllerStateOnDisable: 0
+--- !u!114 &3543952012814938654
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 1349193913114882}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: da4c2e90ecd3d4dd4a520099c08cf493, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_PropertyName: _Color2
+  m_Colors:
+  - {r: 1, g: 0, b: 0, a: 1}
+  - {r: 0, g: 1, b: 0, a: 1}
+  - {r: 0, g: 0, b: 1, a: 1}
+  - {r: 1, g: 0.92156863, b: 0.015686275, a: 1}

Samples~/Demo/Scripts/CopyItemOnStart.cs

@@ -15,7 +15,7 @@ namespace Coffee.UIExtensions.Demo
 
         private void Start()
         {
-            if (!m_Origin) return;
+            if (m_Origin == null) return;
             m_Origin.SetActive(false);
 
             var parent = m_Origin.transform.parent;

Samples~/Demo/Scripts/UIElementDragger.cs

@@ -42,7 +42,7 @@ public class UIElementDragger : MonoBehaviour, IBeginDragHandler, IDragHandler,
                 break;
             case Target.Custom:
                 _rectTransform.localPosition += delta;
-                if (m_CustomTarget)
+                if (m_CustomTarget != null)
                 {
                     if (m_UseCanvasScale)
                     {

Samples~/Demo/Scripts/UIParticle_Demo.cs

@@ -1,3 +1,4 @@
+using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Serialization;
 using UnityEngine.UI;
@@ -51,7 +52,7 @@ namespace Coffee.UIExtensions.Demo
 
         public void EnableAnimations(bool flag)
         {
-            foreach (var animator in FindObjectsOfType<Animator>())
+            foreach (var animator in Misc.FindObjectsOfType<Animator>())
             {
                 animator.enabled = flag;
             }
@@ -79,7 +80,7 @@ namespace Coffee.UIExtensions.Demo
 
         public void UIParticle_Scale(float scale)
         {
-            foreach (var uip in FindObjectsOfType<UIParticle>())
+            foreach (var uip in Misc.FindObjectsOfType<UIParticle>())
             {
                 uip.scale = scale;
             }
@@ -87,7 +88,7 @@ namespace Coffee.UIExtensions.Demo
 
         public void ParticleSystem_WorldSpaseSimulation(bool flag)
         {
-            foreach (var p in FindObjectsOfType<ParticleSystem>())
+            foreach (var p in Misc.FindObjectsOfType<ParticleSystem>())
             {
                 var main = p.main;
                 main.simulationSpace = flag
@@ -123,7 +124,7 @@ namespace Coffee.UIExtensions.Demo
 
         public void ParticleSystem_SetScale(float scale)
         {
-            foreach (var ps in FindObjectsOfType<ParticleSystem>())
+            foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
             {
                 ps.transform.localScale = new Vector3(scale, scale, scale);
             }

Samples~/Demo/Sprites/UIParticle_Demo_Light_Frame.png.meta

@@ -42,12 +42,12 @@ TextureImporter:
   compressionQuality: 50
   spriteMode: 1
   spriteExtrude: 1
-  spriteMeshType: 1
+  spriteMeshType: 0
   alignment: 0
   spritePivot: {x: 0.5, y: 0.5}
   spritePixelsToUnits: 100
   spriteBorder: {x: 0, y: 0, z: 0, w: 0}
-  spriteGenerateFallbackPhysicsShape: 1
+  spriteGenerateFallbackPhysicsShape: 0
   alphaUsage: 1
   alphaIsTransparency: 1
   spriteTessellationDetail: -1

Samples~/Demo/Sprites/UIParticle_Demo_Move.png.meta

@@ -27,7 +27,7 @@ TextureImporter:
   generateCubemap: 6
   cubemapConvolution: 0
   seamlessCubemap: 0
-  textureFormat: 1
+  textureFormat: 4
   maxTextureSize: 2048
   textureSettings:
     serializedVersion: 2
@@ -42,12 +42,12 @@ TextureImporter:
   compressionQuality: 50
   spriteMode: 1
   spriteExtrude: 1
-  spriteMeshType: 1
+  spriteMeshType: 0
   alignment: 0
   spritePivot: {x: 0.5, y: 0.5}
   spritePixelsToUnits: 100
   spriteBorder: {x: 0, y: 0, z: 0, w: 0}
-  spriteGenerateFallbackPhysicsShape: 1
+  spriteGenerateFallbackPhysicsShape: 0
   alphaUsage: 1
   alphaIsTransparency: 1
   spriteTessellationDetail: -1

Samples~/Demo/Sprites/UIParticle_Demo_Star.png.meta

@@ -42,12 +42,12 @@ TextureImporter:
   compressionQuality: 50
   spriteMode: 1
   spriteExtrude: 1
-  spriteMeshType: 1
+  spriteMeshType: 0
   alignment: 0
   spritePivot: {x: 0.5, y: 0.5}
   spritePixelsToUnits: 100
   spriteBorder: {x: 0, y: 0, z: 0, w: 0}
-  spriteGenerateFallbackPhysicsShape: 1
+  spriteGenerateFallbackPhysicsShape: 0
   alphaUsage: 0
   alphaIsTransparency: 1
   spriteTessellationDetail: -1

Samples~/Demo/Sprites/UIParticle_Demo_Unity-chan.png.meta

@@ -27,7 +27,7 @@ TextureImporter:
   generateCubemap: 6
   cubemapConvolution: 0
   seamlessCubemap: 0
-  textureFormat: -1
+  textureFormat: 4
   maxTextureSize: 2048
   textureSettings:
     serializedVersion: 2
@@ -42,12 +42,12 @@ TextureImporter:
   compressionQuality: 50
   spriteMode: 1
   spriteExtrude: 1
-  spriteMeshType: 1
+  spriteMeshType: 0
   alignment: 0
   spritePivot: {x: 0.5, y: 0.5}
   spritePixelsToUnits: 100
   spriteBorder: {x: 0, y: 0, z: 0, w: 0}
-  spriteGenerateFallbackPhysicsShape: 1
+  spriteGenerateFallbackPhysicsShape: 0
   alphaUsage: 1
   alphaIsTransparency: 1
   spriteTessellationDetail: -1

Shaders/UIAdditive.shader

@@ -42,7 +42,6 @@
         ZTest [unity_GUIZTestMode]
         Fog { Mode Off }
         Blend One One
-
         ColorMask [_ColorMask]
 
         Pass
@@ -73,6 +72,7 @@
                 fixed4 color : COLOR;
                 float2 texcoord : TEXCOORD0;
                 float4 worldPosition : TEXCOORD1;
+                float4 mask : TEXCOORD2;
                 UNITY_VERTEX_OUTPUT_STEREO
             };
 
@@ -81,16 +81,43 @@
             float4 _MainTex_ST;
             fixed4 _TextureSampleAdd;
             float4 _ClipRect;
+            float _UIMaskSoftnessX;
+            float _UIMaskSoftnessY;
+            int _UIVertexColorAlwaysGammaSpace;
+
+            half3 _UIGammaToLinear(half3 value)
+            {
+                half3 low = 0.0849710 * value - 0.000163029;
+                half3 high = value * (value * (value * 0.265885 + 0.736584) - 0.00980184) + 0.00319697;
+
+                // We should be 0.5 away from any actual gamma value stored in an 8 bit channel
+                const half3 split = (half3)0.0725490; // Equals 18.5 / 255
+                return (value < split) ? low : high;
+            }
 
             v2f vert(appdata_t v)
             {
                 v2f OUT;
                 UNITY_SETUP_INSTANCE_ID(v);
                 UNITY_INITIALIZE_VERTEX_OUTPUT_STEREO(OUT);
+                float4 vPosition = UnityObjectToClipPos(v.vertex);
                 OUT.worldPosition = v.vertex;
-                OUT.vertex = UnityObjectToClipPos(OUT.worldPosition);
+                OUT.vertex = vPosition;
 
-                OUT.texcoord = TRANSFORM_TEX(v.texcoord, _MainTex);
+                float2 pixelSize = vPosition.w;
+                pixelSize /= float2(1, 1) * abs(mul((float2x2)UNITY_MATRIX_P, _ScreenParams.xy));
+
+                float4 clampedRect = clamp(_ClipRect, -2e10, 2e10);
+                float2 maskUV = (v.vertex.xy - clampedRect.xy) / (clampedRect.zw - clampedRect.xy);
+                OUT.texcoord = TRANSFORM_TEX(v.texcoord.xy, _MainTex);
+                OUT.mask = float4(v.vertex.xy * 2 - clampedRect.xy - clampedRect.zw, 0.25 / (0.25 * half2(_UIMaskSoftnessX, _UIMaskSoftnessY) + abs(pixelSize.xy)));
+
+                if (_UIVertexColorAlwaysGammaSpace)
+                {
+                    #ifndef UNITY_COLORSPACE_GAMMA
+                    v.color.rgb = _UIGammaToLinear(v.color.rgb);
+                    #endif
+                }
 
                 OUT.color = v.color * _Color;
                 return OUT;
@@ -98,10 +125,18 @@
 
             fixed4 frag(v2f IN) : SV_Target
             {
-                half4 color = (tex2D(_MainTex, IN.texcoord) + _TextureSampleAdd) * IN.color;
+                //Round up the alpha color coming from the interpolator (to 1.0/256.0 steps)
+                //The incoming alpha could have numerical instability, which makes it very sensible to
+                //HDR color transparency blend, when it blends with the world's texture.
+                const half alphaPrecision = half(0xff);
+                const half invAlphaPrecision = half(1.0 / alphaPrecision);
+                IN.color.a = round(IN.color.a * alphaPrecision) * invAlphaPrecision;
+
+                half4 color = IN.color * (tex2D(_MainTex, IN.texcoord) + _TextureSampleAdd);
 
                 #ifdef UNITY_UI_CLIP_RECT
-                    color.a *= UnityGet2DClipping(IN.worldPosition.xy, _ClipRect);
+                half2 m = saturate((_ClipRect.zw - _ClipRect.xy - abs(IN.mask.xy)) * IN.mask.zw);
+                color.a *= m.x * m.y;
                 #endif
 
                 #ifdef UNITY_UI_ALPHACLIP
@@ -109,6 +144,7 @@
                 #endif
 
                 color.rgb *= color.a;
+
                 return color;
             }
             ENDCG

package.json

@@ -2,7 +2,7 @@
   "name": "com.coffee.ui-particle",
   "displayName": "UI Particle",
   "description": "This package provides a component to render particle effects for uGUI.\nThe particle rendering is maskable and sortable, without the need for an extra Camera, RenderTexture, or Canvas.",
-  "version": "5.0.0-preview.4",
+  "version": "4.13.1",
   "unity": "2018.2",
   "license": "MIT",
   "repository": {