chore(release): 5.0.0-preview.4 [skip ci]

# [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)

### Bug Fixes

* generated baking-camera object remains in the prefab or scene (again) ([5babd6d](5babd6d07b))
* SetParticleSystemInstance/Prefab APIs destroy generated objects ([4b30c16](4b30c16b9a))

### Features

* add 'custom view' option. ([4252f11](4252f1199b))
* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` (again) ([04232b6](04232b6749))
* the rendering order list in inspector is now more compact ([9212eaa](9212eaa84c))

.github/workflows/release.yml

@@ -1,12 +1,12 @@
 name: 🔖 Release
-run-name: 🔖 Release (${{ github.ref_name }})
 
 on:
   workflow_dispatch:
   push:
     branches:
       - release
-      - release-*
+      - release-preview
+      - release-v4
     tags-ignore:
       - "**"
 
@@ -38,7 +38,7 @@ jobs:
             @semantic-release/changelog
             @semantic-release/git
         env:
-          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          GITHUB_TOKEN: ${{ github.token }}
 
       - id: summary
         run: |
@@ -50,12 +50,14 @@ jobs:
           if [ '${{ steps.release.outputs.new_release_published }}' = 'false' ]; then
             echo "No new release published." | tee -a $GITHUB_STEP_SUMMARY
           elif [ '${{ github.ref_name }}' = 'release' ]; then
-            echo "merge_to=develop" | tee -a $GITHUB_OUTPUT $GITHUB_STEP_SUMMARY
-            echo "split_to=main" | tee -a $GITHUB_OUTPUT $GITHUB_STEP_SUMMARY
-          else
-            channel=$(echo ${{ github.ref_name }} | sed 's/^release-//')
-            echo "merge_to=develop-${channel}" | tee -a $GITHUB_OUTPUT $GITHUB_STEP_SUMMARY
-            echo "split_to=${channel}" | tee -a $GITHUB_OUTPUT $GITHUB_STEP_SUMMARY
+            echo "merge_to=develop" | tee -a $GITHUB_OUTPUT
+            echo "split_to=main" | tee -a $GITHUB_OUTPUT
+          elif [ '${{ github.ref_name }}' = 'release-preview' ]; then
+            echo "merge_to=develop-preview" | tee -a $GITHUB_OUTPUT
+            echo "split_to=preview" | tee -a $GITHUB_OUTPUT
+          elif [ '${{ github.ref_name }}' = 'release-4.x' ]; then
+            echo "merge_to=develop-4.x" | tee -a $GITHUB_OUTPUT
+            echo "split_to=4.x" | tee -a $GITHUB_OUTPUT
           fi
 
   merge-to:

.github/workflows/test.yml

@@ -3,36 +3,28 @@
 #   UNITY_EMAIL: Unity user email to login
 #   UNITY_PASSWORD: Unity user password to login
 name: 🧪 Test
-run-name: 🧪 Test (${{ github.event.pull_request.title || github.ref_name }})
 
 env:
   # MINIMUM_VERSION: The minimum version of Unity.
   MINIMUM_VERSION: 2019.4
   # EXCLUDE_FILTER: The excluded versions of Unity.
-  EXCLUDE_FILTER: "(2020.2.0|2021.1|2023.3)"
+  EXCLUDE_FILTER: '(2020.2.0)'
 
 on:
   workflow_dispatch:
-    inputs:
-      usePeriodVersions:
-        description: "Use the period versions (.0f1, .10f1, 20f1, ...)."
-        required: false
-        default: "true"
   push:
     branches:
       - develop
       - develop-preview
+      - develop-4.x
     tags:
       - "!*"
     paths-ignore:
-      - "**.md"
-  pull_request_target:
+      - "*.md"
+  pull_request:
     types:
       - opened
-      - reopened
       - synchronize
-    paths-ignore:
-      - "**.md"
 
 jobs:
   setup:
@@ -45,12 +37,9 @@ jobs:
         id: setup
         run: |
           echo "==== Target Unity Versions ===="
-          LATEST_VERSIONS=`npx unity-changeset@latest list --versions --latest-patch --min ${MINIMUM_VERSION} --json --all`
-          if [ "${{ inputs.usePeriodVersions }}" = "true" ]; then
-            ADDITIONAL_VERSIONS=`npx unity-changeset list --versions --grep '0f' --min ${MINIMUM_VERSION} --json`
-          else
-            ADDITIONAL_VERSIONS=[]
-          fi
+          LATEST_VERSIONS=`npx unity-changeset list --versions --latest-patch --min ${MINIMUM_VERSION} --json --all`
+          # ADDITIONAL_VERSIONS=`npx unity-changeset list --versions --grep '0f' --min ${MINIMUM_VERSION} --json`
+          ADDITIONAL_VERSIONS=[]
 
           VERSIONS=`echo "[${LATEST_VERSIONS}, ${ADDITIONAL_VERSIONS}]" \
             | jq -c '[ flatten | sort | unique | .[] | select( test("${{ env.EXCLUDE_FILTER }}") | not ) ]'`
@@ -59,44 +48,33 @@ jobs:
   test:
     name: 🧪 Run tests
     runs-on: ubuntu-latest
+    env:
+      UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
+      UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
+      UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
     permissions:
       checks: write
       contents: read
     needs: setup
     strategy:
       fail-fast: false
-      max-parallel: 6
+      max-parallel: 4
       matrix:
         unityVersion: ${{ fromJson(needs.setup.outputs.unityVersions) }}
     steps:
-      - name: 🚚 Checkout ($${{ github.ref }})
-        if: github.event_name == 'push'
+      - name: 🚚 Checkout
         uses: actions/checkout@v4
 
-      - name: 🚚 Checkout pull request (pull_request_target)
-        if: github.event_name == 'pull_request_target'
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.pull_request.head.sha }}
-          fetch-depth: 0
-
-      - name: 🚚 Marge pull request (pull_request_target)
-        if: github.event_name == 'pull_request_target'
-        run: |
-          git config user.name "GitHub Actions"
-          git config user.email "actions@github.com"
-          git merge origin/${{ github.event.pull_request.base.ref }} --no-edit
-
       - name: 📥 Cache library
         uses: actions/cache@v4
         with:
           path: Library
-          key: Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
+          key: Library-${{ matrix.unityVersion }}-${{ github.sha }}
           restore-keys: |
             Library-${{ matrix.unityVersion }}-
             Library-
 
-      - name: 🛠️ Build Unity Project (Test)
+      - name: 🛠️ Build Unity Project
         uses: game-ci/unity-builder@v4
         timeout-minutes: 45
         with:
@@ -104,10 +82,6 @@ jobs:
           targetPlatform: StandaloneLinux64
           allowDirtyBuild: true
           customParameters: -nographics
-        env:
-          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
-          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
-          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
 
       - name: 🧪 Run tests
         uses: game-ci/unity-test-runner@v4
@@ -118,7 +92,4 @@ jobs:
           customParameters: -nographics
           checkName: ${{ matrix.unityVersion }} Test Results
           githubToken: ${{ github.token }}
-        env:
-          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
-          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
-          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+          coverageOptions: "dontClear;generateHtmlReport;generateBadgeReport;pathFilters:+**/Packages/src/**;assemblyFilters:+<packages>,-*.Editor,-*.Test"

Assets/Demo/Cartoon FX & War FX Demo/CFXRF Demo.unity.meta

@@ -1,4 +0,0 @@
-fileFormatVersion: 2
-guid: e34a092899a9547189add96707de1b5a
-DefaultImporter:
-  userData: 

Assets/Demo/Cartoon FX & War FX Demo/CFX_Demo_With_UIParticle.cs

@@ -80,11 +80,7 @@ namespace Coffee.UIExtensions.Demo
                 .SelectMany(x => x.GetTypes())
                 .FirstOrDefault(x => x.Name == typeName);
 
-#if UNITY_2023_2_OR_NEWER
-            return type == null ? null : FindFirstObjectByType(type);
-#else
             return type == null ? null : FindObjectOfType(type);
-#endif
         }
 
         public void SetCanvasWidth(int width)

Assets/Demo/Performance Demo/Scripts/UIParticle_PerformanceDemo.cs

@@ -1,4 +1,3 @@
-using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Serialization;
 
@@ -47,7 +46,7 @@ namespace Coffee.UIExtensions.Demo
 
             if (!flag)
             {
-                foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
+                foreach (var ps in FindObjectsOfType<ParticleSystem>())
                 {
                     ps.Play(false);
                 }
@@ -76,7 +75,7 @@ namespace Coffee.UIExtensions.Demo
 
         public void ParticleSystem_SetScale(float scale)
         {
-            foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
+            foreach (var ps in FindObjectsOfType<ParticleSystem>())
             {
                 ps.transform.localScale = new Vector3(scale, scale, scale);
             }

Assets/ProjectSettings/NanoMonitor.asset

@@ -14,16 +14,15 @@ MonoBehaviour:
   m_EditorClassIdentifier: 
   m_NanoMonitorEnabled: 1
   m_BootSceneNameRegex: .*
-  m_DevelopmentBuildOnly: 0
+  m_DevelopmentBuildOnly: 1
   m_EnabledInEditor: 1
   m_AlwaysIncludeAssembly: 1
   m_InstantiateOnLoad: 1
-  m_Prefab: {fileID: 4567906826058368312, guid: 7cebff2d255b9433cbe23b243c193329,
+  m_Prefab: {fileID: 7211429669315726685, guid: b73940fc30a2f4eb9a73783e9c1f8da6,
     type: 3}
+  m_Opened: 1
   m_Interval: 0.5
-  m_Anchor: 0
-  m_Width: 750
-  m_HelpUrl: https://github.com/mob-sakai/ParticleEffectForUGUI
+  m_Anchor: 1
   m_CustomMonitorItems:
   - m_Format: Screen:{0}x{1}
     m_Arg0:
@@ -32,10 +31,3 @@ MonoBehaviour:
       m_Path: UnityEngine.Screen, UnityEngine.CoreModule;height
     m_Arg2:
       m_Path: 
-  - m_Format: UIParticles:{0} Materials:{1}
-    m_Arg0:
-      m_Path: Coffee.UIExtensions.UIParticleUpdater, Coffee.UIParticle;uiParticleCount
-    m_Arg1:
-      m_Path: Coffee.UIParticleInternal.MaterialRepository, Coffee.UIParticle;count
-    m_Arg2:
-      m_Path: 

Assets/ProjectSettings/NanoMonitor.prefab.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: b73940fc30a2f4eb9a73783e9c1f8da6
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/ProjectSettings/SimpleSceneNavigator.asset

@@ -0,0 +1,20 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 94e8c16a26d334eafa227ee444387432, type: 3}
+  m_Name: SimpleSceneNavigator
+  m_EditorClassIdentifier: 
+  m_NavigatorEnabled: 1
+  m_EnabledInEditor: 1
+  m_AlwaysIncludeAssembly: 1
+  m_InstantiateOnLoad: 1
+  m_Prefab: {fileID: 7211429669315726685, guid: 46deb9632f6a14713b8460bd01e879c9,
+    type: 3}

Assets/ProjectSettings/SimpleSceneNavigator.asset.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: a5b9278dfbd194d04b1c6ae7031928c1
+guid: be3e05903ef7041d39b3ef8ecdd47f08
 NativeFormatImporter:
   externalObjects: {}
   mainObjectFileID: 11400000

Assets/ProjectSettings/SimpleSceneNavigator.prefab

@@ -0,0 +1,513 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &3877588430955763108
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588430955763111}
+  - component: {fileID: 3877588430955763105}
+  - component: {fileID: 3877588430955763110}
+  m_Layer: 5
+  m_Name: Text
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588430955763111
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 3877588431231610297}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &3877588430955763105
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588430955763110
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 5f7201a12d95ffc409449d95f23cf332, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_FontData:
+    m_Font: {fileID: 10102, guid: 0000000000000000e000000000000000, type: 0}
+    m_FontSize: 14
+    m_FontStyle: 0
+    m_BestFit: 0
+    m_MinSize: 10
+    m_MaxSize: 40
+    m_Alignment: 4
+    m_AlignByGeometry: 0
+    m_RichText: 1
+    m_HorizontalOverflow: 1
+    m_VerticalOverflow: 1
+    m_LineSpacing: 1
+  m_Text: '>>'
+--- !u!1 &3877588431231610301
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588431231610297}
+  - component: {fileID: 3877588431231610302}
+  - component: {fileID: 3877588431231610303}
+  - component: {fileID: 3877588431231610300}
+  m_Layer: 5
+  m_Name: Button - >>
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588431231610297
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children:
+  - {fileID: 3877588430955763111}
+  m_Father: {fileID: 7211429669315725985}
+  m_RootOrder: 1
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 1, y: 1}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 30, y: 30}
+  m_Pivot: {x: 1, y: 1}
+--- !u!222 &3877588431231610302
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588431231610303
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: 10905, guid: 0000000000000000f000000000000000, type: 0}
+  m_Type: 1
+  m_PreserveAspect: 0
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 1
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1
+--- !u!114 &3877588431231610300
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 4e29b1a8efbd4b44bb3f3716e73f07ff, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Navigation:
+    m_Mode: 3
+    m_SelectOnUp: {fileID: 0}
+    m_SelectOnDown: {fileID: 0}
+    m_SelectOnLeft: {fileID: 0}
+    m_SelectOnRight: {fileID: 0}
+  m_Transition: 1
+  m_Colors:
+    m_NormalColor: {r: 1, g: 1, b: 1, a: 1}
+    m_HighlightedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_PressedColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 1}
+    m_SelectedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_DisabledColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 0.5019608}
+    m_ColorMultiplier: 1
+    m_FadeDuration: 0.1
+  m_SpriteState:
+    m_HighlightedSprite: {fileID: 0}
+    m_PressedSprite: {fileID: 0}
+    m_SelectedSprite: {fileID: 0}
+    m_DisabledSprite: {fileID: 0}
+  m_AnimationTriggers:
+    m_NormalTrigger: Normal
+    m_HighlightedTrigger: Highlighted
+    m_PressedTrigger: Pressed
+    m_SelectedTrigger: Selected
+    m_DisabledTrigger: Disabled
+  m_Interactable: 1
+  m_TargetGraphic: {fileID: 3877588431231610303}
+  m_OnClick:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!1 &3877588432219069602
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588432219069614}
+  - component: {fileID: 3877588432219069615}
+  - component: {fileID: 3877588432219069612}
+  - component: {fileID: 3877588432219069613}
+  m_Layer: 5
+  m_Name: Button - <<
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588432219069614
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children:
+  - {fileID: 1738594088889562266}
+  m_Father: {fileID: 7211429669315725985}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 1}
+  m_AnchorMax: {x: 0, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 30, y: 30}
+  m_Pivot: {x: 0, y: 1}
+--- !u!222 &3877588432219069615
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588432219069612
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: 10905, guid: 0000000000000000f000000000000000, type: 0}
+  m_Type: 1
+  m_PreserveAspect: 0
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 1
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1
+--- !u!114 &3877588432219069613
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 4e29b1a8efbd4b44bb3f3716e73f07ff, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Navigation:
+    m_Mode: 3
+    m_SelectOnUp: {fileID: 0}
+    m_SelectOnDown: {fileID: 0}
+    m_SelectOnLeft: {fileID: 0}
+    m_SelectOnRight: {fileID: 0}
+  m_Transition: 1
+  m_Colors:
+    m_NormalColor: {r: 1, g: 1, b: 1, a: 1}
+    m_HighlightedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_PressedColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 1}
+    m_SelectedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_DisabledColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 0.5019608}
+    m_ColorMultiplier: 1
+    m_FadeDuration: 0.1
+  m_SpriteState:
+    m_HighlightedSprite: {fileID: 0}
+    m_PressedSprite: {fileID: 0}
+    m_SelectedSprite: {fileID: 0}
+    m_DisabledSprite: {fileID: 0}
+  m_AnimationTriggers:
+    m_NormalTrigger: Normal
+    m_HighlightedTrigger: Highlighted
+    m_PressedTrigger: Pressed
+    m_SelectedTrigger: Selected
+    m_DisabledTrigger: Disabled
+  m_Interactable: 1
+  m_TargetGraphic: {fileID: 3877588432219069612}
+  m_OnClick:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!1 &7211429669315726685
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7211429669315725985}
+  - component: {fileID: 7211429669315726686}
+  - component: {fileID: 7211429669315726687}
+  - component: {fileID: 7143702096253919615}
+  - component: {fileID: 3330778306119167604}
+  m_Layer: 5
+  m_Name: SimpleSceneNavigator
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &7211429669315725985
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 0, y: 0, z: 0}
+  m_Children:
+  - {fileID: 3877588432219069614}
+  - {fileID: 3877588431231610297}
+  m_Father: {fileID: 0}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 0, y: 0}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0, y: 0}
+--- !u!223 &7211429669315726686
+Canvas:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  serializedVersion: 3
+  m_RenderMode: 0
+  m_Camera: {fileID: 0}
+  m_PlaneDistance: 100
+  m_PixelPerfect: 0
+  m_ReceivesEvents: 1
+  m_OverrideSorting: 0
+  m_OverridePixelPerfect: 0
+  m_SortingBucketNormalizedSize: 0
+  m_AdditionalShaderChannelsFlag: 0
+  m_SortingLayerID: 0
+  m_SortingOrder: 32000
+  m_TargetDisplay: 0
+--- !u!114 &7211429669315726687
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 0cd44c1031e13a943bb63640046fad76, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_UiScaleMode: 1
+  m_ReferencePixelsPerUnit: 100
+  m_ScaleFactor: 1
+  m_ReferenceResolution: {x: 600, y: 40}
+  m_ScreenMatchMode: 0
+  m_MatchWidthOrHeight: 0
+  m_PhysicalUnit: 3
+  m_FallbackScreenDPI: 96
+  m_DefaultSpriteDPI: 96
+  m_DynamicPixelsPerUnit: 1
+--- !u!114 &7143702096253919615
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: dc42784cf147c0c48a680349fa168899, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_IgnoreReversedGraphics: 1
+  m_BlockingObjects: 0
+  m_BlockingMask:
+    serializedVersion: 2
+    m_Bits: 4294967295
+--- !u!114 &3330778306119167604
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: e7db36469bd2a46658ff432d65cb62ca, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_PrevButton: {fileID: 3877588432219069613}
+  m_NextButton: {fileID: 3877588431231610300}
+  m_PrevName: {fileID: 0}
+  m_NextName: {fileID: 0}
+--- !u!1 &8570858711609111474
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 1738594088889562266}
+  - component: {fileID: 5485386222362727379}
+  - component: {fileID: 3877588430751452752}
+  m_Layer: 5
+  m_Name: Text
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &1738594088889562266
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 3877588432219069614}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &5485386222362727379
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588430751452752
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 5f7201a12d95ffc409449d95f23cf332, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_FontData:
+    m_Font: {fileID: 10102, guid: 0000000000000000e000000000000000, type: 0}
+    m_FontSize: 14
+    m_FontStyle: 0
+    m_BestFit: 0
+    m_MinSize: 10
+    m_MaxSize: 40
+    m_Alignment: 4
+    m_AlignByGeometry: 0
+    m_RichText: 1
+    m_HorizontalOverflow: 1
+    m_VerticalOverflow: 1
+    m_LineSpacing: 1
+  m_Text: <<

Assets/ProjectSettings/SimpleSceneNavigator.prefab.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 46deb9632f6a14713b8460bd01e879c9
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/ProjectSettings/UIParticle.asset

@@ -10,7 +10,6 @@ MonoBehaviour:
   m_Enabled: 1
   m_EditorHideFlags: 0
   m_Script: {fileID: 11500000, guid: f22a23b9d98e440478697f4adf30e61c, type: 3}
-  m_Name: UIParticleProjectSettings
+  m_Name: UIParticle
   m_EditorClassIdentifier: 
-  m_EnableLinearToGamma: 1
-  m_HideGeneratedObjects: 1
+  m_LinearToGamma: 1

Assets/ProjectSettings/UIParticle.asset.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: e8e7744b163af4869b07b8f192c810ed
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Packages/manifest.json

@@ -1,9 +1,9 @@
 {
   "dependencies": {
-    "com.coffee.development": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/Development",
-    "com.coffee.minimal-resource": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/MinimalResource",
-    "com.coffee.nano-monitor": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
     "com.unity.ide.rider": "3.0.31",
+    "com.coffee.development": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/Development",
+    "com.coffee.nano-monitor": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
+    "com.coffee.sub-asset-editor": "https://github.com/mob-sakai/SubAssetEditor.git",
     "com.unity.test-framework": "1.1.33",
     "com.unity.modules.animation": "1.0.0",
     "com.unity.modules.physics": "1.0.0"

Packages/packages-lock.json

@@ -5,14 +5,7 @@
       "depth": 0,
       "source": "git",
       "dependencies": {},
-      "hash": "3c280f1a8f4db5038b881ff07f270efd9638fa31"
-    },
-    "com.coffee.minimal-resource": {
-      "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/MinimalResource",
-      "depth": 0,
-      "source": "git",
-      "dependencies": {},
-      "hash": "3c280f1a8f4db5038b881ff07f270efd9638fa31"
+      "hash": "7a8e5603ab8e9241c8e0f9d29da3a56dbf76ea85"
     },
     "com.coffee.nano-monitor": {
       "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
@@ -21,7 +14,14 @@
       "dependencies": {
         "com.unity.ugui": "1.0.0"
       },
-      "hash": "3c280f1a8f4db5038b881ff07f270efd9638fa31"
+      "hash": "7a8e5603ab8e9241c8e0f9d29da3a56dbf76ea85"
+    },
+    "com.coffee.sub-asset-editor": {
+      "version": "https://github.com/mob-sakai/SubAssetEditor.git",
+      "depth": 0,
+      "source": "git",
+      "dependencies": {},
+      "hash": "01464178eec1e4dbe741c11c9baeb94a151c99ee"
     },
     "com.coffee.ui-particle": {
       "version": "file:src",

Packages/src/CHANGELOG.md

@@ -1,166 +1,57 @@
-## [4.11.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.1...v4.11.2) (2025-03-15)
+# [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)
 
 
 ### 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)
+* generated baking-camera object remains in the prefab or scene (again) ([5babd6d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5babd6d07b2ac17341a29964baf552785cefd90e))
+* SetParticleSystemInstance/Prefab APIs destroy generated objects ([4b30c16](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/4b30c16b9a48531873f9be91eec2a573370d17a1))
 
 
 ### Features
 
-* add 'TimeScaleMultiplier' option ([925af0b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/925af0b6046f65f23a778f67cefa8ff9cbedb513))
+* 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))
 
-## [4.10.7](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.6...v4.10.7) (2025-01-14)
+# [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
 
-* 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)
+* generated baking-camera object remains in the prefab or scene ([fd66928](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fd66928efe584aeb4f6347b9a9dca97d9512eb88))
 
-## [4.10.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.5...v4.10.6) (2025-01-03)
+# [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)
 
 
 ### 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))
+* '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)
+* `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)
+* 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)
+* 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)
+* 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)
 
 
 ### Features
 
-* add project settings ([1ce4e31](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1ce4e31a9681bf1a201d2723c8d97e07ecc16592))
+* remove overlay window (editor) ([fc3fbdd](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fc3fbdd230595ad3471875ec6fec384a3dad0d17))
+* 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))
 
-## [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)
+# [5.0.0-preview.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.6...v5.0.0-preview.1) (2024-05-23)
 
 
 ### 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)
+* add project settings for UIParticle ([b6e6185](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b6e6185c521fef0f118f61cfdfdac07b87555c01))
+* 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))
 
 
-### Bug Fixes
+### BREAKING CHANGES
 
-* 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)
+* Some members inherited from MaskableGraphic will no longer be available.
 
 ## [4.6.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.5...v4.6.6) (2024-05-23)
 

Packages/src/Editor/UIParticleEditor.cs

@@ -2,19 +2,20 @@ 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;
+
 #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;
 
@@ -26,13 +27,8 @@ namespace Coffee.UIExtensions
 {
     [CustomEditor(typeof(UIParticle))]
     [CanEditMultipleObjects]
-    internal class UIParticleEditor : GraphicEditor
+    internal class UIParticleEditor : Editor
     {
-        internal class State : ScriptableSingleton<State>
-        {
-            public bool is3DScaleMode;
-        }
-
         //################################
         // Constant or Static Members.
         //################################
@@ -51,6 +47,7 @@ namespace Coffee.UIExtensions
         private static readonly GUIContent s_ContentPrimary = new GUIContent("Primary");
         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;
@@ -62,10 +59,8 @@ 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 static readonly HashSet<Shader> s_Shaders = new HashSet<Shader>();
 #if UNITY_2018 || UNITY_2019
@@ -87,10 +82,8 @@ namespace Coffee.UIExtensions
         /// <summary>
         /// This function is called when the object becomes enabled and active.
         /// </summary>
-        protected override void OnEnable()
+        private void OnEnable()
         {
-            base.OnEnable();
-
             _maskable = serializedObject.FindProperty("m_Maskable");
             _scale3D = serializedObject.FindProperty("m_Scale3D");
             _animatableProperties = serializedObject.FindProperty("m_AnimatableProperties");
@@ -101,7 +94,6 @@ 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)
@@ -170,19 +162,6 @@ 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;
-            }
         }
 
         /// <summary>
@@ -201,11 +180,7 @@ namespace Coffee.UIExtensions
 
             // Scale
             EditorGUI.BeginDisabledGroup(!_meshSharing.hasMultipleDifferentValues && _meshSharing.intValue == 4);
-            if (DrawFloatOrVector3Field(_scale3D, _is3DScaleMode) != _is3DScaleMode)
-            {
-                State.instance.is3DScaleMode = _is3DScaleMode = !_is3DScaleMode;
-            }
-
+            s_XYZMode = DrawFloatOrVector3Field(_scale3D, s_XYZMode);
             EditorGUI.EndDisabledGroup();
 
             // AnimatableProperties
@@ -246,9 +221,6 @@ namespace Coffee.UIExtensions
                 _customViewSize.floatValue = Mathf.Max(0.1f, _customViewSize.floatValue);
             }
 
-            // Time Scale Multiplier
-            EditorGUILayout.PropertyField(_timeScaleMultiplier);
-
             // Target ParticleSystems.
             EditorGUI.BeginChangeCheck();
             _ro.DoLayoutList();
@@ -345,6 +317,7 @@ namespace Coffee.UIExtensions
             }
 #endif
             Profiler.EndSample();
+            EditorApplication.delayCall += () => Profiler.enabled = false;
         }
 
         private static bool IsBuiltInObject(Object obj)
@@ -464,9 +437,7 @@ 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();

Packages/src/Icons.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 7a55e246f37df405bac88eac692e3a86
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Packages/src/README.md

@@ -1,61 +1,28 @@
-# <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 -->
+# <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)
+
+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)](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.md)  
+[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI?include_prereleases)](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/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-) | [📌 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)
-  - [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)
+<< [📝 Description](#-description) | [🎮 Demo](#-demo) | [⚙ Installation](#-installation) | [🚀 Usage](#-usage) | [🛠 Development Note](#-development-note) | [🤝 Contributing](#-contributing) >>
 
 <br><br>
 
-## 📌 Key Features
+## 📝 Description
+
+![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.
@@ -116,16 +83,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.9.0
+  openupm add com.coffee.ui-particle@4.8.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://github.com/user-attachments/assets/f88f47ad-c606-44bd-9e86-ee3f72eac548)
+  ![](https://gist.github.com/assets/12690315/24af63ed-8a2e-483d-9023-7aa53d913330)
 - To update the package, change suffix `#{version}` to the target version.
-  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.9.0`
+  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.8.0`
 
 #### Install via UPM (Manually)
 
@@ -140,7 +107,7 @@ _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.9.0",`
+  - e.g. `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.8.0",`
 
 #### Install as Embedded Package
 
@@ -152,13 +119,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
 
-### Component: UIParticle
+### UIParticle Component
 
 `UIParticle` controls the ParticleSystems that are attached to its own game objects and child game objects.
 
-![](https://github.com/user-attachments/assets/bc9eb783-afce-4102-ac61-aee9ea8d6f2f)
+![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/1cf5753b-33fc-4cef-91c3-413c515a954f)
 
 - **Maskable**: Does this graphic allow maskable.
 - **Scale**: Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.
@@ -180,7 +158,6 @@ _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
@@ -188,7 +165,7 @@ and z-position.
 
 <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)
@@ -197,7 +174,7 @@ and z-position.
 
 <br>
 
-### Usage with Your Existing ParticleSystem Prefab
+#### 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)
@@ -206,19 +183,19 @@ and z-position.
 
 <br>
 
-### Usage with `Mask` or `RectMask2D` Component
+#### 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-mask-and-rectmask2d-component)
+the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-maskrectmask2d-component)
 section.
 
 ![](https://user-images.githubusercontent.com/12690315/95017591-3b512700-0695-11eb-864e-04166ea1809a.png)
 
 <br><br>
 
-### Usage with Script
+### Script usage
 
 ```cs
 // Instantiate ParticleSystem prefab with UIParticle on runtime.
@@ -237,14 +214,14 @@ uiParticle.Stop();
 
 <br><br>
 
-### Component: UIParticleAttractor
+### UIParticleAttractor component
 
 `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 Systems**: Attracts particles generated by the specified ParticleSystems.
+- **Particle System**: Attracts particles generated by the specified particle system.
 - **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.
@@ -258,14 +235,6 @@ uiParticle.Stop();
 
 <br><br>
 
-### Project Settings
-
-![](https://github.com/user-attachments/assets/befc7f34-fb47-4006-831a-eba79fda11ca)
-
-- Click `Edit > Project Settings` to open the Project Settings window and then select `UI > UI Particle` category.
-
-<br><br>
-
 ## 🛠 Development Note
 
 ### Compares the Baking mesh approach with the conventional approach
@@ -397,7 +366,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` and `RectMask2D` Component
+### How to Make a Custom Shader to Support Mask/RectMask2D Component
 
 <details>
 <summary>Shader tips</summary>

Packages/src/Runtime/Coffee.UIParticle.R.dll.meta

@@ -1,33 +0,0 @@
-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: 

Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs

@@ -18,10 +18,10 @@ namespace Coffee.UIParticleInternal
         public static T[] GetComponentsInChildren<T>(this Component self, int depth)
             where T : Component
         {
-            var results = InternalListPool<T>.Rent();
+            var results = ListPool<T>.Rent();
             self.GetComponentsInChildren_Internal(results, depth);
             var array = results.ToArray();
-            InternalListPool<T>.Return(ref results);
+            ListPool<T>.Return(ref results);
             return array;
         }
 
@@ -134,35 +134,6 @@ 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
         {
@@ -204,7 +175,7 @@ namespace Coffee.UIParticleInternal
             target.enabled = false;
 
             // Find MonoScript of the specified component.
-            foreach (var script in MonoImporter.GetAllRuntimeMonoScripts())
+            foreach (var script in Resources.FindObjectsOfTypeAll<MonoScript>())
             {
                 if (script.GetClass() != typeof(T))
                 {

Packages/src/Runtime/Internal/Extensions/ListExtensions.cs

@@ -0,0 +1,19 @@
+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);
+        }
+    }
+}

Packages/src/Runtime/Internal/Extensions/ListExtensions.cs.meta

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

Packages/src/Runtime/Internal/Extensions/Misc.cs

@@ -0,0 +1,48 @@
+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
+        }
+    }
+}

Packages/src/Runtime/Internal/Extensions/Misc.cs.meta

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

Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs

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

Packages/src/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,51 +13,41 @@ namespace Coffee.UIParticleInternal
 {
     public abstract class PreloadedProjectSettings : ScriptableObject
 #if UNITY_EDITOR
+        , IPreprocessBuildWithReport
     {
-        private class Postprocessor : AssetPostprocessor
+        int IOrderedCallback.callbackOrder => 0;
+
+        void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)
         {
-            private static void OnPostprocessAllAssets(string[] _, string[] __, string[] ___, string[] ____)
-            {
-                Initialize();
-            }
-        }
-
-        private class PreprocessBuildWithReport : IPreprocessBuildWithReport
-        {
-            int IOrderedCallback.callbackOrder => 0;
-
-            void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)
-            {
-                Initialize();
-            }
+            Initialize();
         }
 
+        [InitializeOnLoadMethod]
+        [InitializeOnEnterPlayMode]
         private static void Initialize()
         {
+            const BindingFlags flags = BindingFlags.Public | BindingFlags.Static | BindingFlags.FlattenHierarchy;
             foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
             {
                 var defaultSettings = GetDefaultSettings(t);
                 if (!defaultSettings)
                 {
-                    // When create a new instance, automatically set it as default settings.
-                    defaultSettings = CreateInstance(t) as PreloadedProjectSettings;
+                    defaultSettings = t.GetProperty("instance", flags)
+                        ?.GetValue(null, null) as PreloadedProjectSettings;
                     SetDefaultSettings(defaultSettings);
                 }
                 else if (GetPreloadedSettings(t).Length != 1)
                 {
                     SetDefaultSettings(defaultSettings);
                 }
-
-                if (defaultSettings)
-                {
-                    defaultSettings.OnInitialize();
-                }
             }
+
+            EditorApplication.QueuePlayerLoopUpdate();
         }
 
         protected static string GetDefaultName(Type type, bool nicify)
         {
-            var typeName = type.Name;
+            var typeName = type.Name.Replace("ProjectSettings", "");
             return nicify
                 ? ObjectNames.NicifyVariableName(typeName)
                 : typeName;
@@ -81,8 +71,6 @@ namespace Coffee.UIParticleInternal
 
         protected static void SetDefaultSettings(PreloadedProjectSettings asset)
         {
-            if (!asset) return;
-
             var type = asset.GetType();
             if (string.IsNullOrEmpty(AssetDatabase.GetAssetPath(asset)))
             {
@@ -93,11 +81,7 @@ 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();
-                }
+                AssetDatabase.CreateAsset(asset, assetPath);
             }
 
             var preloadedAssets = PlayerSettings.GetPreloadedAssets();
@@ -111,20 +95,13 @@ namespace Coffee.UIParticleInternal
 
             AssetDatabase.Refresh();
         }
-
-        protected virtual void OnCreateAsset()
-        {
-        }
-
-        protected virtual void OnInitialize()
-        {
-        }
     }
 #else
     {
     }
 #endif
 
+
     public abstract class PreloadedProjectSettings<T> : PreloadedProjectSettings
         where T : PreloadedProjectSettings<T>
     {
@@ -133,8 +110,6 @@ namespace Coffee.UIParticleInternal
 #if UNITY_EDITOR
         private string _jsonText;
 
-        public static bool hasInstance => s_Instance;
-
         public static T instance
         {
             get

Packages/src/Runtime/Internal/Utilities/FastAction.cs

@@ -10,9 +10,8 @@ namespace Coffee.UIParticleInternal
     /// </summary>
     internal class FastActionBase<T>
     {
-        private static readonly InternalObjectPool<LinkedListNode<T>> s_NodePool =
-            new InternalObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true,
-                x => x.Value = default);
+        private static readonly ObjectPool<LinkedListNode<T>> s_NodePool =
+            new ObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true, x => x.Value = default);
 
         private readonly LinkedList<T> _delegates = new LinkedList<T>();
 

Packages/src/Runtime/Internal/Utilities/FrameCache.cs

@@ -46,6 +46,7 @@ namespace Coffee.UIParticleInternal
             GetFrameCache<T>().Set((key1.GetHashCode(), key2.GetHashCode()), result);
         }
 
+
         /// <summary>
         /// Sets a value in the frame cache with a specified key.
         /// </summary>

Packages/src/Runtime/Internal/Utilities/Logging.cs

@@ -42,6 +42,7 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -51,6 +52,7 @@ namespace Coffee.UIParticleInternal
             Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -59,6 +61,7 @@ namespace Coffee.UIParticleInternal
             Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -76,6 +79,7 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -119,6 +123,7 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -135,9 +140,6 @@ namespace Coffee.UIParticleInternal
 
                 switch (tag)
                 {
-                    case string name:
-                        sb.Append(name);
-                        break;
                     case Type type:
                         AppendType(sb, type);
                         break;
@@ -164,6 +166,7 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif
@@ -202,6 +205,7 @@ namespace Coffee.UIParticleInternal
 #endif
         }
 
+
 #if !ENABLE_COFFEE_LOGGER
         [Conditional(k_DisableSymbol)]
 #endif

Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs

@@ -15,7 +15,7 @@ namespace Coffee.UIParticleInternal
 
 #if UNITY_EDITOR
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
-        public static void Clear()
+        private static void Clear()
         {
             s_Repository.Clear();
         }
@@ -55,6 +55,7 @@ namespace Coffee.UIParticleInternal
             Profiler.EndSample();
         }
 
+
         /// <summary>
         /// Adds or retrieves a cached material based on the hash.
         /// </summary>

Packages/src/Runtime/Internal/Utilities/Misc.cs

@@ -1,132 +0,0 @@
-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_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) 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
-        }
-
-#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<IconAttribute>();
-            var scripts = MonoImporter.GetAllRuntimeMonoScripts();
-            foreach (var type in types)
-            {
-                var script = scripts.FirstOrDefault(x => x.GetClass() == type);
-                if (!script) continue;
-
-                var path = type.GetCustomAttribute<IconAttribute>()?._path;
-                var icon = AssetDatabase.LoadAssetAtPath<Texture2D>(path);
-                if (!icon) continue;
-
-                s_SetIconForObject(script, icon);
-            }
-        }
-#endif
-    }
-#endif
-}

Packages/src/Runtime/Internal/Utilities/ObjectPool.cs

@@ -6,58 +6,15 @@ namespace Coffee.UIParticleInternal
     /// <summary>
     /// Object pool.
     /// </summary>
-    internal class InternalObjectPool<T> where T : class
+    internal class ObjectPool<T>
     {
-#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.
-            Logging.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);
-            Logging.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 InternalObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        public ObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
         {
             _onCreate = onCreate;
             _onValid = onValid;
@@ -97,40 +54,15 @@ namespace Coffee.UIParticleInternal
             Logging.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 InternalListPool<T>
+    internal static class ListPool<T>
     {
-#if UNITY_2021_1_OR_NEWER
-        /// <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());
+        private static readonly ObjectPool<List<T>> s_ListPool =
+            new ObjectPool<List<T>>(() => new List<T>(), _ => true, x => x.Clear());
 
         /// <summary>
         /// Rent an instance from the pool.
@@ -149,6 +81,5 @@ namespace Coffee.UIParticleInternal
         {
             s_ListPool.Return(ref toRelease);
         }
-#endif
     }
 }

Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs

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

Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs

@@ -14,8 +14,6 @@ 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()
         {
@@ -50,15 +48,6 @@ 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>
@@ -88,17 +77,6 @@ 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();
         }

Packages/src/Runtime/UIParticle.cs

@@ -3,25 +3,22 @@ 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.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/Icons/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
-    public class UIParticle : MaskableGraphic, ISerializationCallbackReceiver
+    public class UIParticle : UIBehaviour, ISerializationCallbackReceiver
     {
         public enum AutoScalingMode
         {
@@ -63,7 +60,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(10, 10, 10);
+        private Vector3 m_Scale3D = new Vector3(1, 1, 1);
 
         [Tooltip("If you want to update material properties (e.g. _MainTex_ST, _Color) in AnimationClip, " +
                  "use this to mark as animatable.")]
@@ -121,23 +118,47 @@ namespace Coffee.UIExtensions
         private float m_CustomViewSize = 10;
 
         [SerializeField]
-        [Tooltip("Time scale multiplier.")]
-        private float m_TimeScaleMultiplier = 1;
+        private bool m_Maskable = true;
 
         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;
 
-        /// <summary>
-        /// Should this graphic be considered a target for ray-casting?
-        /// </summary>
-        public override bool raycastTarget
+        public RectTransform rectTransform => transform as RectTransform;
+
+        public Canvas canvas
         {
-            get => false;
-            set { }
+            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.
+        /// </summary>
+        public bool maskable
+        {
+            get => m_Maskable;
+            set
+            {
+                if (value == m_Maskable) return;
+                m_Maskable = value;
+                UpdateRendererMaterial();
+            }
         }
 
         /// <summary>
@@ -262,15 +283,6 @@ namespace Coffee.UIExtensions
             set => m_CustomViewSize = Mathf.Max(0.1f, value);
         }
 
-        /// <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 =>
@@ -323,15 +335,15 @@ namespace Coffee.UIExtensions
 
         public Vector3 parentScale { get; private set; }
 
-        public Vector3 canvasScale { get; private set; }
+        private Vector3 canvasScale { get; set; }
 
         protected override void OnEnable()
         {
             _isScaleStored = false;
             ResetGroupId();
             UIParticleUpdater.Register(this);
-            RegisterDirtyMaterialCallback(UpdateRendererMaterial);
 
+            //
             if (0 < particles.Count)
             {
                 RefreshParticles(particles);
@@ -341,7 +353,7 @@ namespace Coffee.UIExtensions
                 RefreshParticles();
             }
 
-            base.OnEnable();
+            UpdateRendererMaterial();
         }
 
         /// <summary>
@@ -358,9 +370,15 @@ namespace Coffee.UIExtensions
             _isScaleStored = false;
             UIParticleUpdater.Unregister(this);
             _renderers.ForEach(r => r.Reset());
-            UnregisterDirtyMaterialCallback(UpdateRendererMaterial);
+            _canvas = null;
+        }
 
-            base.OnDisable();
+        /// <summary>
+        /// Called when the state of the parent Canvas is changed.
+        /// </summary>
+        protected override void OnCanvasHierarchyChanged()
+        {
+            _canvas = null;
         }
 
         /// <summary>
@@ -370,6 +388,14 @@ 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()
         {
         }
@@ -591,14 +617,12 @@ namespace Coffee.UIExtensions
             {
                 var ps = particleSystems[i];
                 if (!ps) continue;
-
-                var mainEmitter = ps.GetMainEmitter(particleSystems);
-                GetRenderer(j++).Set(this, ps, false, mainEmitter);
+                GetRenderer(j++).Set(this, ps, false);
 
                 // If the trail is enabled, set it additionally.
                 if (ps.trails.enabled)
                 {
-                    GetRenderer(j++).Set(this, ps, true, mainEmitter);
+                    GetRenderer(j++).Set(this, ps, true);
                 }
             }
         }
@@ -664,17 +688,6 @@ 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++)
@@ -750,7 +763,7 @@ namespace Coffee.UIExtensions
             _bakeCamera.useOcclusionCulling = false;
 
             _bakeCamera.gameObject.SetActive(false);
-            _bakeCamera.gameObject.hideFlags = UIParticleProjectSettings.globalHideFlags;
+            _bakeCamera.gameObject.hideFlags = HideFlags.HideAndDontSave;
 
             return _bakeCamera;
         }

Packages/src/Runtime/UIParticle.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: 

Packages/src/Runtime/UIParticleAttractor.cs

@@ -1,5 +1,4 @@
 using System;
-using System.Collections.Generic;
 using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Events;
@@ -7,7 +6,7 @@ using UnityEngine.Events;
 namespace Coffee.UIExtensions
 {
     [ExecuteAlways]
-    public class UIParticleAttractor : MonoBehaviour, ISerializationCallbackReceiver
+    public class UIParticleAttractor : MonoBehaviour
     {
         public enum Movement
         {
@@ -23,12 +22,8 @@ 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;
@@ -50,7 +45,7 @@ namespace Coffee.UIExtensions
         [SerializeField]
         private UnityEvent m_OnAttracted;
 
-        private List<UIParticle> _uiParticles = new List<UIParticle>();
+        private UIParticle _uiParticle;
 
         public float destinationRadius
         {
@@ -89,46 +84,25 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// The target ParticleSystems to attract. Use <see cref="AddParticleSystem"/> and
-        /// <see cref="RemoveParticleSystem"/> to modify the list.
+        /// The target ParticleSystem to attract.
         /// </summary>
-        public IReadOnlyList<ParticleSystem> particleSystems => m_ParticleSystems;
-
-        public void AddParticleSystem(ParticleSystem ps)
+#if UNITY_EDITOR
+        public new ParticleSystem particleSystem
+#else
+        public ParticleSystem particleSystem
+#endif
         {
-            if (m_ParticleSystems == null)
+            get => m_ParticleSystem;
+            set
             {
-                m_ParticleSystems = new List<ParticleSystem>();
+                m_ParticleSystem = value;
+                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);
         }
 
@@ -139,96 +113,85 @@ namespace Coffee.UIExtensions
 
         private void OnDestroy()
         {
-            _uiParticles = null;
-            m_ParticleSystems = null;
+            _uiParticle = null;
+            m_ParticleSystem = null;
         }
 
         internal void Attract()
         {
-            // Collect UIParticle if needed (same size as m_ParticleSystems)
-            CollectUIParticlesIfNeeded();
+            if (m_ParticleSystem == null) return;
 
-            for (var particleIndex = 0; particleIndex < m_ParticleSystems.Count; particleIndex++)
+            var count = m_ParticleSystem.particleCount;
+            if (count == 0) return;
+
+            var particles = ParticleSystemExtensions.GetParticleArray(count);
+            m_ParticleSystem.GetParticles(particles, count);
+
+            var dstPos = GetDestinationPosition();
+            for (var i = 0; i < count; i++)
             {
-                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);
-                particleSystem.GetParticles(particles, count);
-
-                var uiParticle = _uiParticles[particleIndex];
-                var dstPos = GetDestinationPosition(uiParticle, particleSystem);
-                for (var i = 0; i < count; i++)
+                // Attracted
+                var p = particles[i];
+                if (0f < p.remainingLifetime && Vector3.Distance(p.position, dstPos) < m_DestinationRadius)
                 {
-                    // Attracted
-                    var p = particles[i];
-                    if (0f < p.remainingLifetime && Vector3.Distance(p.position, dstPos) < m_DestinationRadius)
+                    p.remainingLifetime = 0f;
+                    particles[i] = p;
+
+                    if (m_OnAttracted != null)
                     {
-                        p.remainingLifetime = 0f;
-                        particles[i] = p;
-
-                        if (m_OnAttracted != null)
+                        try
                         {
-                            try
-                            {
-                                m_OnAttracted.Invoke();
-                            }
-                            catch (Exception e)
-                            {
-                                Debug.LogException(e);
-                            }
+                            m_OnAttracted.Invoke();
+                        }
+                        catch (Exception e)
+                        {
+                            Debug.LogException(e);
                         }
-
-                        continue;
                     }
 
-                    // Calc attracting time
-                    var delayTime = p.startLifetime * m_DelayRate;
-                    var duration = p.startLifetime - delayTime;
-                    var time = Mathf.Max(0, p.startLifetime - p.remainingLifetime - delayTime);
-
-                    // Delay
-                    if (time <= 0) continue;
-
-                    // Attract
-                    p.position = GetAttractedPosition(p.position, dstPos, duration, time);
-                    p.velocity *= 0.5f;
-                    particles[i] = p;
+                    continue;
                 }
 
-                particleSystem.SetParticles(particles, count);
+                // Calc attracting time
+                var delayTime = p.startLifetime * m_DelayRate;
+                var duration = p.startLifetime - delayTime;
+                var time = Mathf.Max(0, p.startLifetime - p.remainingLifetime - delayTime);
+
+                // Delay
+                if (time <= 0) continue;
+
+                // Attract
+                p.position = GetAttractedPosition(p.position, dstPos, duration, time);
+                p.velocity *= 0.5f;
+                particles[i] = p;
             }
+
+            m_ParticleSystem.SetParticles(particles, count);
         }
 
-        private Vector3 GetDestinationPosition(UIParticle uiParticle, ParticleSystem particleSystem)
+        private Vector3 GetDestinationPosition()
         {
-            var isUI = uiParticle && uiParticle.enabled;
-            var psPos = particleSystem.transform.position;
+            var isUI = _uiParticle && _uiParticle.enabled;
+            var psPos = m_ParticleSystem.transform.position;
             var attractorPos = transform.position;
             var dstPos = attractorPos;
-            var isLocalSpace = particleSystem.IsLocalSpace();
+            var isLocalSpace = m_ParticleSystem.IsLocalSpace();
 
             if (isLocalSpace)
             {
-                dstPos = particleSystem.transform.InverseTransformPoint(dstPos);
+                dstPos = m_ParticleSystem.transform.InverseTransformPoint(dstPos);
             }
 
             if (isUI)
             {
-                var inverseScale = uiParticle.parentScale.Inverse();
-                var scale3d = uiParticle.scale3DForCalc;
+                var inverseScale = _uiParticle.parentScale.Inverse();
+                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;
@@ -274,59 +237,25 @@ namespace Coffee.UIExtensions
             return Vector3.MoveTowards(current, target, speed);
         }
 
-        private void CollectUIParticlesIfNeeded()
+        private void ApplyParticleSystem()
         {
-            if (m_ParticleSystems.Count == 0 || _uiParticles.Count != 0) return;
-
-            // Expand capacity
-            if (_uiParticles.Capacity < m_ParticleSystems.Capacity)
+            _uiParticle = null;
+            if (m_ParticleSystem == null)
             {
-                _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
-        private void OnValidate()
-        {
-            _uiParticles.Clear();
-        }
+                if (Application.isPlaying)
 #endif
-
-        void ISerializationCallbackReceiver.OnBeforeSerialize()
-        {
-            UpgradeIfNeeded();
-        }
-
-        void ISerializationCallbackReceiver.OnAfterDeserialize()
-        {
-        }
-
-        private void UpgradeIfNeeded()
-        {
-            // Multiple ParticleSystems support: from 'm_ParticleSystem' to 'm_ParticleSystems'
-            if (m_ParticleSystem != null)
-            {
-                if (!m_ParticleSystems.Contains(m_ParticleSystem))
                 {
-                    m_ParticleSystems.Add(m_ParticleSystem);
+                    Debug.LogError("No particle system attached to particle attractor script", this);
                 }
 
-                m_ParticleSystem = null;
-                Debug.Log($"Upgraded!");
+                return;
+            }
+
+            _uiParticle = m_ParticleSystem.GetComponentInParent<UIParticle>(true);
+            if (_uiParticle && !_uiParticle.particles.Contains(m_ParticleSystem))
+            {
+                _uiParticle = null;
             }
         }
     }

Packages/src/Runtime/UIParticleAttractor.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: 

Packages/src/Runtime/UIParticleProjectSettings.cs

@@ -17,18 +17,6 @@ namespace Coffee.UIExtensions
             set => instance.m_EnableLinearToGamma = value;
         }
 
-
-        [Header("Editor")]
-        [Tooltip("Hide the automatically generated objects.\n" +
-                 "  - UIParticleRenderer\n" +
-                 "  - UIParticle BakingCamera")]
-        [SerializeField]
-        private bool m_HideGeneratedObjects = true;
-
-        public static HideFlags globalHideFlags => instance.m_HideGeneratedObjects
-            ? HideFlags.DontSave | HideFlags.NotEditable | HideFlags.HideInHierarchy | HideFlags.HideInInspector
-            : HideFlags.DontSave | HideFlags.NotEditable;
-
 #if UNITY_EDITOR
         [SettingsProvider]
         private static SettingsProvider CreateSettingsProvider()

Packages/src/Runtime/UIParticleProjectSettings.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: 

Packages/src/Runtime/UIParticleRenderer.cs

@@ -4,6 +4,7 @@
 #elif UNITY_2022_3_OR_NEWER
 #define PS_BAKE_API_V2
 #endif
+
 using System;
 using System.Collections.Generic;
 using Coffee.UIParticleInternal;
@@ -15,7 +16,6 @@ using UnityEngine.UI;
 
 namespace Coffee.UIExtensions
 {
-    [Icon("Packages/com.coffee.ui-particle/Icons/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
@@ -41,7 +41,6 @@ namespace Coffee.UIExtensions
         private Vector2Int _prevScreenSize;
         private bool _preWarm;
         private ParticleSystemRenderer _renderer;
-        private ParticleSystem _mainEmitter;
 
         public override Texture mainTexture => _isTrail ? null : _particleSystem.GetTextureForSprite();
 
@@ -114,7 +113,6 @@ namespace Coffee.UIExtensions
             _parent = null;
             _particleSystem = null;
             _renderer = null;
-            _mainEmitter = null;
             if (0 <= index)
             {
                 _index = index;
@@ -139,7 +137,6 @@ namespace Coffee.UIExtensions
         {
             base.OnEnable();
 
-            hideFlags = UIParticleProjectSettings.globalHideFlags;
             if (!s_CombineInstances[0].mesh)
             {
                 s_CombineInstances[0].mesh = new Mesh
@@ -164,7 +161,7 @@ namespace Coffee.UIExtensions
             // Create renderer object.
             var go = new GameObject("[generated] UIParticleRenderer", typeof(UIParticleRenderer))
             {
-                hideFlags = UIParticleProjectSettings.globalHideFlags,
+                hideFlags = HideFlags.HideAndDontSave,
                 layer = parent.gameObject.layer
             };
 
@@ -204,6 +201,7 @@ namespace Coffee.UIExtensions
                 return modifiedMaterial;
             }
 
+            //
             var hash = new Hash128(
                 modifiedMaterial ? (uint)modifiedMaterial.GetInstanceID() : 0,
                 texture ? (uint)texture.GetInstanceID() : 0,
@@ -226,7 +224,7 @@ namespace Coffee.UIExtensions
             return _modifiedMaterial;
         }
 
-        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail, ParticleSystem mainEmitter)
+        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail)
         {
             _parent = parent;
             maskable = parent.maskable;
@@ -249,7 +247,10 @@ 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();
@@ -266,7 +267,6 @@ namespace Coffee.UIExtensions
             _prevScreenSize = new Vector2Int(Screen.width, Screen.height);
             _prevCanvasScale = canvas ? canvas.scaleFactor : 1f;
             _delay = true;
-            _mainEmitter = mainEmitter;
 
             canvasRenderer.SetTexture(null);
 
@@ -304,7 +304,7 @@ namespace Coffee.UIExtensions
 
             // Simulate particles.
             Profiler.BeginSample("[UIParticle] Bake Mesh > Simulate Particles");
-            if (!_isTrail && _parent.canSimulate && !_mainEmitter)
+            if (!_isTrail && _parent.canSimulate)
             {
 #if UNITY_EDITOR
                 if (!Application.isPlaying)
@@ -422,16 +422,17 @@ namespace Coffee.UIExtensions
                     workerMesh.LinearToGamma();
                 }
 
-                var components = InternalListPool<Component>.Rent();
+                var components = ListPool<Component>.Rent();
                 GetComponents(typeof(IMeshModifier), components);
+
+#pragma warning disable CS0618 // Type or member is obsolete
                 for (var i = 0; i < components.Count; i++)
                 {
-#pragma warning disable CS0618 // Type or member is obsolete
                     ((IMeshModifier)components[i]).ModifyMesh(workerMesh);
-#pragma warning restore CS0618 // Type or member is obsolete
                 }
+#pragma warning restore CS0618 // Type or member is obsolete
 
-                InternalListPool<Component>.Return(ref components);
+                ListPool<Component>.Return(ref components);
             }
 
             Profiler.EndSample();
@@ -443,7 +444,7 @@ namespace Coffee.UIExtensions
 
             // Get grouped renderers.
             Profiler.BeginSample("[UIParticleRenderer] Set Mesh");
-            var renderers = InternalListPool<UIParticleRenderer>.Rent();
+            var renderers = ListPool<UIParticleRenderer>.Rent();
             if (_parent.useMeshSharing)
             {
                 UIParticleUpdater.GetGroupedRenderers(_parent.groupId, _index, renderers);
@@ -460,7 +461,7 @@ namespace Coffee.UIExtensions
                 r.canvasRenderer.SetMaterial(materialForRendering, 0);
             }
 
-            InternalListPool<UIParticleRenderer>.Return(ref renderers);
+            ListPool<UIParticleRenderer>.Return(ref renderers);
 
             if (_parent.canRender)
             {
@@ -543,30 +544,6 @@ 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))
@@ -629,7 +606,6 @@ namespace Coffee.UIExtensions
                 : main.useUnscaledTime
                     ? Time.unscaledDeltaTime
                     : Time.deltaTime;
-            deltaTime *= _parent.timeScaleMultiplier;
 
             // Pre-warm:
             if (0 < deltaTime && _preWarm)

Packages/src/Runtime/UIParticleUpdater.cs

@@ -40,26 +40,13 @@ namespace Coffee.UIExtensions
 
 #if UNITY_EDITOR
         [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()
         {

Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs

@@ -171,32 +171,5 @@ namespace Coffee.UIParticleInternal
                 action.Invoke(p);
             }
         }
-
-        public static ParticleSystem GetMainEmitter(this ParticleSystem self, List<ParticleSystem> list)
-        {
-            if (!self || 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 || !parent) return false;
-
-            var subEmitters = parent.subEmitters;
-            var count = subEmitters.subEmittersCount;
-            for (var i = 0; i < count; i++)
-            {
-                if (subEmitters.GetSubEmitterSystem(i) == self) return true;
-            }
-
-            return false;
-        }
     }
 }

Packages/src/Samples~/Demo/Scripts/UIParticle_Demo.cs

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

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

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

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

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

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

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

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

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

Packages/src/Shaders/UIAdditive.shader

@@ -40,10 +40,7 @@
         Lighting Off
         ZWrite Off
         ZTest [unity_GUIZTestMode]
-        Fog
-        {
-            Mode Off
-        }
+        Fog { Mode Off }
         Blend One One
 
         ColorMask [_ColorMask]
@@ -64,21 +61,21 @@
 
             struct appdata_t
             {
-                float4 vertex : POSITION;
-                float4 color : COLOR;
+                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 vertex           : SV_POSITION;
+                fixed4 color            : COLOR;
+                float2 texcoord         : TEXCOORD0;
+                float4 worldPosition    : TEXCOORD1;
                 UNITY_VERTEX_OUTPUT_STEREO
             };
-
+            
             fixed4 _Color;
             sampler2D _MainTex;
             float4 _MainTex_ST;
@@ -117,4 +114,4 @@
             ENDCG
         }
     }
-}
+}

Packages/src/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": "4.11.2",
+  "version": "5.0.0-preview.4",
   "unity": "2018.2",
   "license": "MIT",
   "repository": {

ProjectSettings/MinimalResourceSettings.json

@@ -1,11 +0,0 @@
-{
-    "MonoBehaviour": {
-        "m_Enabled": true,
-        "m_EditorHideFlags": 0,
-        "m_Name": "",
-        "m_EditorClassIdentifier": "",
-        "m_OutputDllPaths": [
-            "Packages/com.coffee.ui-particle/Runtime/Coffee.UIParticle.R.dll"
-        ]
-    }
-}

ProjectSettings/ProjectSettings.asset

@@ -124,7 +124,7 @@ PlayerSettings:
   bundleVersion: 1.0
   preloadedAssets:
   - {fileID: 11400000, guid: 86087a0847f384b538391745dad4565c, type: 2}
-  - {fileID: 11400000, guid: 4b9df7b8a4193489299b8f477348ae0c, type: 2}
+  - {fileID: 11400000, guid: be3e05903ef7041d39b3ef8ecdd47f08, type: 2}
   metroInputSource: 0
   wsaTransparentSwapchain: 0
   m_HolographicPauseOnTrackingLoss: 1
@@ -520,7 +520,7 @@ PlayerSettings:
   webGLTemplate: APPLICATION:Default
   webGLAnalyzeBuildSize: 0
   webGLUseEmbeddedResources: 0
-  webGLCompressionFormat: 2
+  webGLCompressionFormat: 1
   webGLLinkerTarget: 0
   webGLThreadsSupport: 0
   scriptingDefineSymbols: