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

# [5.0.0-preview.16](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.15...5.0.0-preview.16) (2025-03-15) ### Bug Fixes * IL2CPP build fails on older versions of Unity ([0da6525](0da652520c)) * NRE on enable ([0cff50e](0cff50ef69)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)
Merge remote-tracking branch 'origin/develop' into develop-preview
2026-05-14 20:20:06 +00:00 · 2025-03-15 08:12:51 +00:00 · 2025-03-15 17:02:36 +09:00 · 2025-03-15 07:59:37 +00:00 · 2025-03-15 16:58:52 +09:00 · 2025-03-14 19:44:02 +09:00
47 changed files with 7937 additions and 2745 deletions
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -0,0 +1,6 @@
+# This is a comment.
+# Each line is a file pattern followed by one or more owners.
+# https://docs.github.com/ja/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owners
+* @mob-sakai
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: mob-sakai # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: mob_sakai # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: mob-sakai
+
+---
+
+NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment (please complete the following information):**
+ - Version [e.g. 1.0.0]
+ - Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
+ - Unity version: [e.g. 2018.2.8f1]
+ - Build options: [e.g. IL2CPP, .Net 4.x, LWRP]
+
+**Additional context**
+Add any other context about the problem here.
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: mob-sakai
+
+---
+
+NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
--- a/.github/ISSUE_TEMPLATE/question.md
+++ b/.github/ISSUE_TEMPLATE/question.md
@@ -0,0 +1,16 @@
+---
+name: Question
+about: Ask a question about this project
+title: ''
+labels: question
+assignees: mob-sakai
+
+---
+
+NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
+
+**Describe what help do you need**
+A description of the question.
+
+**Additional context**
+Add any other context or screenshots about the question here.
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -0,0 +1,37 @@
+
+# Pull Request Template
+
+## Description
+
+- Please include a summary of the change and which issue is fixed.
+- Please also include relevant motivation and context.
+- List any dependencies that are required for this change.
+
+Fixes #{issue_number}
+
+## Type of change
+
+Please write the commit message in the format corresponding to the change type.
+Please see [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) for more information.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)  
+- [ ] New feature (non-breaking change which adds functionality)  
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Update documentations
+- [ ] Others (refactoring, style changes, etc.)
+
+## Test environment
+
+- Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
+- Unity version: [e.g. 2022.2.0f1]
+- Build options: [e.g. IL2CPP, .Net 4.x, URP/HDRP]
+
+## Checklist
+
+- [ ] This pull request is for merging into the `develop` branch
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have checked my code and corrected any misspellings
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -0,0 +1,28 @@
+name: 🚀 Deploy with Zip
+
+on:
+  workflow_dispatch:
+    inputs:
+      zip:
+        description: "The url to the zip file"
+        required: true
+
+jobs:
+  deploy:
+    name: 🚀 Deploy
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - name: 📦 Download zip file To '_site'
+        run: |
+          curl -L ${{ github.event.inputs.zip }} -o _site.zip
+          unzip _site.zip -d _site
+          find _site -name __MACOSX | xargs rm -rf
+
+      - name: 📦 Upload '_site'
+        uses: actions/upload-pages-artifact@v3
+
+      - name: 🚀 Deploy To GitHub Pages
+        uses: actions/deploy-pages@v4
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -5,8 +5,9 @@ on:
  workflow_dispatch:
  push:
    branches:
-      - release
-      - release-*
+      - preview
+      - main
+      - v*.x
    tags-ignore:
      - "**"

@@ -22,9 +23,6 @@ jobs:
      channel: ${{ steps.release.outputs.new_release_channel }}
      released: ${{ steps.release.outputs.new_release_published }}
      tag: ${{ steps.release.outputs.new_release_git_tag }}
-      version: ${{ steps.release.outputs.new_release_version }}
-      merge_to: ${{ steps.summary.outputs.merge_to }}
-      split_to: ${{ steps.summary.outputs.split_to }}
    steps:
      - name: 🚚 Checkout (${{ github.ref_name }})
        uses: actions/checkout@v4
@@ -38,64 +36,9 @@ jobs:
            @semantic-release/changelog
            @semantic-release/git
        env:
-          GITHUB_TOKEN: ${{ github.token }}
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}

-      - id: summary
-        run: |
+      - run: |
          echo "🔖 New release published: '${{ steps.release.outputs.new_release_published }}'" | tee -a $GITHUB_STEP_SUMMARY
-          echo "🔖 New release version: '${{ steps.release.outputs.new_release_version }}'" | tee -a $GITHUB_STEP_SUMMARY
          echo "🔖 New release channel: '${{ steps.release.outputs.new_release_channel }}'" | tee -a $GITHUB_STEP_SUMMARY
          echo "🔖 New release git tag: '${{ steps.release.outputs.new_release_git_tag }}'" | tee -a $GITHUB_STEP_SUMMARY
-          
-          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
-          fi
-
-  merge-to:
-    if: needs.release.outputs.merge_to != ''
-    needs: release
-    name: 🔀 Merge to ${{ needs.release.outputs.merge_to }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - name: 🚚 Checkout (${{ needs.release.outputs.merge_to }})
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ needs.release.outputs.merge_to }}
-          fetch-depth: 0
-      - name: 🔀 Merge '${{ needs.release.outputs.tag }}' into '${{ needs.release.outputs.merge_to }}'
-        run: |
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
-          
-          git merge ${{ needs.release.outputs.tag }}
-          git push origin ${{ needs.release.outputs.merge_to }}
-
-  split-to:
-    if: needs.release.outputs.split_to != ''
-    needs: release
-    name: 🔀 Split package to ${{ needs.release.outputs.split_to }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - name: 🚚 Checkout (${{ needs.release.outputs.tag }})
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ needs.release.outputs.tag }}
-          fetch-depth: 0
-      - name: 🔀 Split subtree 'Packages/src' to '${{ needs.release.outputs.split_to }}'
-        run: |
-          split_to=${{ needs.release.outputs.split_to }}
-          git branch $split_to origin/$split_to
-          git subtree split --prefix=Packages/src --branch $split_to
-          git tag ${{ needs.release.outputs.version }} $split_to
-          git push origin ${{ needs.release.outputs.version }} $split_to:$split_to
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -3,29 +3,36 @@
 #   UNITY_EMAIL: Unity user email to login
 #   UNITY_PASSWORD: Unity user password to login
 name: 🧪 Test
-run-name: 🧪 Test (${{ github.ref_name }})
+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|2021.1|2023.3)"

 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:
+      - "**.md"
+  pull_request_target:
    types:
      - opened
+      - reopened
      - synchronize
+    paths-ignore:
+      - "**.md"

 jobs:
  setup:
@@ -38,9 +45,12 @@ jobs:
        id: setup
        run: |
          echo "==== Target Unity Versions ===="
-          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=[]
+          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

          VERSIONS=`echo "[${LATEST_VERSIONS}, ${ADDITIONAL_VERSIONS}]" \
            | jq -c '[ flatten | sort | unique | .[] | select( test("${{ env.EXCLUDE_FILTER }}") | not ) ]'`
@@ -49,33 +59,44 @@ 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: 4
+      max-parallel: 6
      matrix:
        unityVersion: ${{ fromJson(needs.setup.outputs.unityVersions) }}
    steps:
-      - name: 🚚 Checkout
+      - name: 🚚 Checkout ($${{ github.ref }})
+        if: github.event_name == 'push'
        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.sha }}
+          key: Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
          restore-keys: |
            Library-${{ matrix.unityVersion }}-
            Library-

-      - name: 🛠️ Build Unity Project
+      - name: 🛠️ Build Unity Project (Test)
        uses: game-ci/unity-builder@v4
        timeout-minutes: 45
        with:
@@ -83,6 +104,10 @@ 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
@@ -93,4 +118,7 @@ jobs:
          customParameters: -nographics
          checkName: ${{ matrix.unityVersion }} Test Results
          githubToken: ${{ github.token }}
-          coverageOptions: "dontClear;generateHtmlReport;generateBadgeReport;pathFilters:+**/Packages/src/**;assemblyFilters:+<packages>,-*.Editor,-*.Test"
+        env:
+          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
+          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
+          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
--- a/Assets/Demo/Cartoon
+++ b/Assets/Demo/Cartoon
--- a/Assets/Demo/Cartoon
+++ b/Assets/Demo/Cartoon
@@ -0,0 +1,4 @@
+fileFormatVersion: 2
+guid: e34a092899a9547189add96707de1b5a
+DefaultImporter:
+  userData: 
--- a/Demo/Scripts/UIParticle_PerformanceDemo.cs
+++ b/Demo/Scripts/UIParticle_PerformanceDemo.cs
@@ -1,3 +1,4 @@
+using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Serialization;

@@ -46,11 +47,7 @@ namespace Coffee.UIExtensions.Demo

            if (!flag)
            {
-#if UNITY_2023_1_OR_NEWER
-                foreach (var ps in FindObjectsByType<ParticleSystem>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-                foreach (var ps in FindObjectsOfType<ParticleSystem>())
-#endif
+                foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
                {
                    ps.Play(false);
                }
@@ -79,11 +76,7 @@ namespace Coffee.UIExtensions.Demo

        public void ParticleSystem_SetScale(float scale)
        {
-#if UNITY_2023_1_OR_NEWER
-            foreach (var ps in FindObjectsByType<ParticleSystem>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-            foreach (var ps in FindObjectsOfType<ParticleSystem>())
-#endif
+            foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
            {
                ps.transform.localScale = new Vector3(scale, scale, scale);
            }
--- a/Assets/ProjectSettings/NanoMonitor.asset
+++ b/Assets/ProjectSettings/NanoMonitor.asset
@@ -18,11 +18,12 @@ MonoBehaviour:
  m_EnabledInEditor: 1
  m_AlwaysIncludeAssembly: 1
  m_InstantiateOnLoad: 1
-  m_Prefab: {fileID: 7211429669315726685, guid: b73940fc30a2f4eb9a73783e9c1f8da6,
+  m_Prefab: {fileID: 4567906826058368312, guid: 7cebff2d255b9433cbe23b243c193329,
    type: 3}
  m_Interval: 0.5
  m_Anchor: 0
  m_Width: 750
+  m_HelpUrl: https://github.com/mob-sakai/ParticleEffectForUGUI
  m_CustomMonitorItems:
  - m_Format: Screen:{0}x{1}
    m_Arg0:
--- a/Assets/ProjectSettings/NanoMonitor.prefab
+++ b/Assets/ProjectSettings/NanoMonitor.prefab
--- a/Assets/ProjectSettings/NanoMonitor.prefab.meta
+++ b/Assets/ProjectSettings/NanoMonitor.prefab.meta
@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: b73940fc30a2f4eb9a73783e9c1f8da6
-PrefabImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
--- a/Assets/ProjectSettings/UIParticleProjectSettings.asset
+++ b/Assets/ProjectSettings/UIParticleProjectSettings.asset
@@ -10,7 +10,7 @@ MonoBehaviour:
  m_Enabled: 1
  m_EditorHideFlags: 0
  m_Script: {fileID: 11500000, guid: f22a23b9d98e440478697f4adf30e61c, type: 3}
-  m_Name: UIParticle
+  m_Name: UIParticleProjectSettings
  m_EditorClassIdentifier: 
  m_EnableLinearToGamma: 1
  m_HideGeneratedObjects: 1
--- a/Assets/ProjectSettings/UIParticleProjectSettings.asset.meta
+++ b/Assets/ProjectSettings/UIParticleProjectSettings.asset.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 4b9df7b8a4193489299b8f477348ae0c
+guid: a5b9278dfbd194d04b1c6ae7031928c1
 NativeFormatImporter:
  externalObjects: {}
  mainObjectFileID: 11400000
--- a/Packages/manifest.json
+++ b/Packages/manifest.json
@@ -1,6 +1,7 @@
 {
  "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.unity.test-framework": "1.1.33",
--- a/Packages/packages-lock.json
+++ b/Packages/packages-lock.json
@@ -5,7 +5,14 @@
      "depth": 0,
      "source": "git",
      "dependencies": {},
-      "hash": "4e5f735ccf956ee469b5014ae781068c49a2825d"
+      "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"
    },
    "com.coffee.nano-monitor": {
      "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
@@ -14,7 +21,7 @@
      "dependencies": {
        "com.unity.ugui": "1.0.0"
      },
-      "hash": "4e5f735ccf956ee469b5014ae781068c49a2825d"
+      "hash": "3c280f1a8f4db5038b881ff07f270efd9638fa31"
    },
    "com.coffee.ui-particle": {
      "version": "file:src",
--- a/Packages/src/.releaserc.json
+++ b/Packages/src/.releaserc.json
@@ -1,12 +1,13 @@
 {
  "branches": [
-    "release",
-    "release-4.x",
+    "main",
+    "[0-9]+.x",
    {
-      "name": "release-preview",
-      "prerelease": "preview"
+      "name": "preview",
+      "prerelease": true
    }
  ],
+  "tagFormat": "${version}",
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
--- a/Packages/src/CHANGELOG.md
+++ b/Packages/src/CHANGELOG.md
@@ -1,3 +1,73 @@
+# [5.0.0-preview.16](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.15...5.0.0-preview.16) (2025-03-15)
+
+
+### Bug Fixes
+
+* IL2CPP build fails on older versions of Unity ([0da6525](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0da652520cd165b43de7404c0b0ab1fbcf9349d1))
+* NRE on enable ([0cff50e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0cff50ef696aa53fb7c46a9a737b7cf3a05b7b9b)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)
+
+# [5.0.0-preview.15](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.14...5.0.0-preview.15) (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))
+* 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)
+
+
+### Features
+
+* add 'TimeScaleMultiplier' option ([925af0b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/925af0b6046f65f23a778f67cefa8ff9cbedb513))
+
+# [5.0.0-preview.14](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.13...5.0.0-preview.14) (2025-01-03)
+
+
+### Bug Fixes
+
+* sub-emitter particles may not render correctly in certain scenarios ([8276684](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/8276684c3b1646f0490ed64557547ba15281664a)), closes [#348](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/348)
+* sub-emitter's `inherit velocity` module doubles at runtime ([67de3d1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/67de3d1bd3e16dc9b564625cb990c53d75769506)), closes [#349](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/349)
+
+# [5.0.0-preview.13](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.12...5.0.0-preview.13) (2025-01-03)
+
+
+### Features
+
+* change the default value of `UIParticle.scale` from `10` to `1` ([9955eef](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/9955eefdc22cf565502f85c87cd2efd3a25fbe50))
+* UIParticle no longer inherits from MaskableGraphic ([c09bfb8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c09bfb81abc9179bf5fc49d29eaf7fc4ed01a4dc))
+
+
+### BREAKING CHANGES
+
+* Some members inherited from MaskableGraphic will no longer be available.
+
+## [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)


--- a/Packages/src/Editor/UIParticleEditor.cs
+++ b/Packages/src/Editor/UIParticleEditor.cs
@@ -2,7 +2,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
 using UnityEditor;
-using UnityEditor.UI;
 using UnityEditorInternal;
 using UnityEngine;
 using UnityEngine.Profiling;
@@ -26,8 +25,13 @@ 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.
        //################################
@@ -46,7 +50,6 @@ 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;
@@ -58,8 +61,10 @@ 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
@@ -81,10 +86,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");
@@ -95,6 +98,7 @@ namespace Coffee.UIExtensions
            _autoScalingMode = serializedObject.FindProperty("m_AutoScalingMode");
            _useCustomView = serializedObject.FindProperty("m_UseCustomView");
            _customViewSize = serializedObject.FindProperty("m_CustomViewSize");
+            _timeScaleMultiplier = serializedObject.FindProperty("m_TimeScaleMultiplier");

            var sp = serializedObject.FindProperty("m_Particles");
            _ro = new ReorderableList(sp.serializedObject, sp, true, true, true, true)
@@ -163,6 +167,19 @@ 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>
@@ -181,7 +198,11 @@ namespace Coffee.UIExtensions

            // Scale
            EditorGUI.BeginDisabledGroup(!_meshSharing.hasMultipleDifferentValues && _meshSharing.intValue == 4);
-            s_XYZMode = DrawFloatOrVector3Field(_scale3D, s_XYZMode);
+            if (DrawFloatOrVector3Field(_scale3D, _is3DScaleMode) != _is3DScaleMode)
+            {
+                State.instance.is3DScaleMode = _is3DScaleMode = !_is3DScaleMode;
+            }
+
            EditorGUI.EndDisabledGroup();

            // AnimatableProperties
@@ -222,6 +243,9 @@ namespace Coffee.UIExtensions
                _customViewSize.floatValue = Mathf.Max(0.1f, _customViewSize.floatValue);
            }

+            // Time Scale Multiplier
+            EditorGUILayout.PropertyField(_timeScaleMultiplier);
+
            // Target ParticleSystems.
            EditorGUI.BeginChangeCheck();
            _ro.DoLayoutList();
@@ -437,9 +461,11 @@ namespace Coffee.UIExtensions
        {
            if (!p || (ignoreCurrent && target == p)) return;

-            var cr = p.canvasRenderer;
-            DestroyImmediate(p);
-            DestroyImmediate(cr);
+            Misc.DestroyImmediate(p);
+            if (p.TryGetComponent<CanvasRenderer>(out var cr))
+            {
+                Misc.DestroyImmediate(cr);
+            }

 #if UNITY_2018_3_OR_NEWER
            var stage = PrefabStageUtility.GetCurrentPrefabStage();
--- a/Packages/src/Editor/UIParticleIcon.png
+++ b/Packages/src/Editor/UIParticleIcon.png
--- a/Packages/src/Editor/UIParticleIcon.png.meta
+++ b/Packages/src/Editor/UIParticleIcon.png.meta
--- a/Packages/src/Icons.meta
+++ b/Packages/src/Icons.meta
@@ -1,8 +0,0 @@
-fileFormatVersion: 2
-guid: 7a55e246f37df405bac88eac692e3a86
-folderAsset: yes
-DefaultImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
--- a/Packages/src/README.md
+++ b/Packages/src/README.md
@@ -1,9 +1,9 @@
-# <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"/> UI Particle v5 <!-- omit in toc -->

 [![](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/badge/Unity-2018.2+-57b9d3.svg?style=flat&logo=unity)
+![](https://img.shields.io/badge/Unity-2019.3+-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)
@@ -11,7 +11,7 @@
 [![](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](#-description-) | [📌 Key Features](#-key-features) | [🎮 Demo](#-demo) | [⚙ Installation](#-installation) | [🔄 Upgrading to 5.x](#-upgrading-from-3x4x-to-5x) | [🚀 Usage](#-usage) | [🛠 Development Note](#-development-note) | [🤝 Contributing](#-contributing) >>

 ## 📝 Description <!-- omit in toc -->

@@ -26,7 +26,9 @@ You can render, mask, and sort your `ParticleSystems` for UI without the need fo
    - [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)
+  - [Install as Embedded Package](#install-as-embedded-package)
+- [🔄 Upgrading from v3/v4 to v5](#-upgrading-from-v3v4-to-v5)
+  - [Breaking Changes](#breaking-changes)
 - [🚀 Usage](#-usage)
  - [Component: UIParticle](#component-uiparticle)
  - [Basic Usage](#basic-usage)
@@ -104,7 +106,7 @@ You can render, mask, and sort your `ParticleSystems` for UI without the need fo

 ## ⚙ Installation

-_This package requires **Unity 2018.3 or later**._
+_This package requires **Unity 2019.3 or later**._

 #### Install via OpenUPM

@@ -116,16 +118,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@5.0.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`  
+- Click `+ > Add package from git URL...` and input the repository URL: `https://github.com/mob-sakai/ParticleEffectForUGUI.git?path=Packages/src`  
  ![](https://github.com/user-attachments/assets/f88f47ad-c606-44bd-9e86-ee3f72eac548)
 - To update the package, change suffix `#{version}` to the target version.
-  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.9.0`
+  - e.g. `https://github.com/mob-sakai/ParticleEffectForUGUI.git?path=Packages/src#5.0.0`

 #### Install via UPM (Manually)

@@ -133,22 +135,41 @@ _This package requires **Unity 2018.3 or later**._
  ```json
  {
    "dependencies": {
-      "com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git",
+      "com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git?path=Packages/src",
      ...
    }
  }
  ```

 - 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?path=Packages/src#5.0.0",`

-#### Install as Embedded Package
+### Install as Embedded Package

-1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI.git/releases) and extract it.
-2. Place it in your project's `Packages` directory.  
-   ![](https://github.com/mob-sakai/mob-sakai/assets/12690315/0b7484b4-5fca-43b0-a9ef-e5dbd99bcdb4)
- If you want to fix bugs or add features, install it as an embedded package.
- To update the package, you need to re-download it and replace the contents.
+1. Download the `Source code (zip)` file from [Releases](https://github.com/mob-sakai/SoftMaskForUGUI/releases) and
+   extract it.
+2. Move the `<extracted_dir>/Packages/src` directory into your project's `Packages` directory.  
+   ![](https://github.com/user-attachments/assets/187cbcbe-5922-4ed5-acec-cf19aa17d208)
+    - You can rename the `src` directory if needed.
+    - If you intend to fix bugs or add features, installing it as an embedded package is recommended.
+    - To update the package, re-download it and replace the existing contents.
+
+<br><br>
+
+## 🔄 Upgrading from v3/v4 to v5
+
+### Breaking Changes
+
+- The default value of `UIParticle.scale` has been changed from `10` to `1`.
+- `UIParticle` no longer inherits from `MaskableGraphic`.
+- If you are installing via git URL, add `?path=Packages/src`.
+   ```json
+   // v3/v4
+   "com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git",
+   
+   // v5
+   "com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git?path=Packages/src",
+   ```

 <br><br>

@@ -158,7 +179,7 @@ _This package requires **Unity 2018.3 or later**._

 `UIParticle` controls the ParticleSystems that are attached to its own game objects and child game objects.

-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/1cf5753b-33fc-4cef-91c3-413c515a954f)
+![](https://github.com/user-attachments/assets/bc9eb783-afce-4102-ac61-aee9ea8d6f2f)

 - **Maskable**: Does this graphic allow maskable.
 - **Scale**: Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.
@@ -180,6 +201,7 @@ _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
@@ -210,7 +232,7 @@ and z-position.
 If you want to mask particles, set a stencil-supported shader (such as `UI/UIAdditive`) to the material for
 ParticleSystem.
 If you use some custom shaders, see
-the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-maskrectmask2d-component)
+the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-mask-and-rectmask2d-component)
 section.

 ![](https://user-images.githubusercontent.com/12690315/95017591-3b512700-0695-11eb-864e-04166ea1809a.png)
--- a/Packages/src/Runtime/Coffee.UIParticle.R.dll
+++ b/Packages/src/Runtime/Coffee.UIParticle.R.dll
--- a/Packages/src/Runtime/Coffee.UIParticle.R.dll.meta
+++ b/Packages/src/Runtime/Coffee.UIParticle.R.dll.meta
@@ -0,0 +1,33 @@
+fileFormatVersion: 2
+guid: 4d73b3825bf044d418ae21bb331d3902
+PluginImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  iconMap: {}
+  executionOrder: {}
+  defineConstraints: []
+  isPreloaded: 0
+  isOverridable: 1
+  isExplicitlyReferenced: 0
+  validateReferences: 1
+  platformData:
+  - first:
+      Any: 
+    second:
+      enabled: 1
+      settings: {}
+  - first:
+      Editor: Editor
+    second:
+      enabled: 0
+      settings:
+        DefaultValueInitialized: true
+  - first:
+      Windows Store Apps: WindowsStoreApps
+    second:
+      enabled: 0
+      settings:
+        CPU: AnyCPU
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs
+++ b/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 = ListPool<T>.Rent();
+            var results = InternalListPool<T>.Rent();
            self.GetComponentsInChildren_Internal(results, depth);
            var array = results.ToArray();
-            ListPool<T>.Return(ref results);
+            InternalListPool<T>.Return(ref results);
            return array;
        }

@@ -134,6 +134,35 @@ 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
        {
@@ -175,7 +204,7 @@ namespace Coffee.UIParticleInternal
            target.enabled = false;

            // Find MonoScript of the specified component.
-            foreach (var script in Resources.FindObjectsOfTypeAll<MonoScript>())
+            foreach (var script in MonoImporter.GetAllRuntimeMonoScripts())
            {
                if (script.GetClass() != typeof(T))
                {
--- a/Packages/src/Runtime/Internal/Extensions/Misc.cs
+++ b/Packages/src/Runtime/Internal/Extensions/Misc.cs
@@ -1,48 +0,0 @@
-using System.Diagnostics;
-using UnityEditor;
-using UnityEngine;
-
-namespace Coffee.UIParticleInternal
-{
-    internal static class Misc
-    {
-        public static void Destroy(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
-            }
-        }
-
-        public static void DestroyImmediate(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (Application.isEditor)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
-            }
-        }
-
-        [Conditional("UNITY_EDITOR")]
-        public static void SetDirty(Object obj)
-        {
-#if UNITY_EDITOR
-            if (!obj) return;
-            EditorUtility.SetDirty(obj);
-#endif
-        }
-    }
-}
--- a/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
@@ -17,11 +17,15 @@ namespace Coffee.UIParticleInternal
            Type.GetType("UnityEditor.Experimental.U2D.SpriteEditorExtension, UnityEditor")
            ?? Type.GetType("UnityEditor.U2D.SpriteEditorExtension, UnityEditor");

-        private static readonly MethodInfo s_GetActiveAtlasTextureMethod = s_SpriteEditorExtensionType
-            .GetMethod("GetActiveAtlasTexture", BindingFlags.Static | BindingFlags.NonPublic);
+        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_GetActiveAtlasMethod = s_SpriteEditorExtensionType
-            .GetMethod("GetActiveAtlas", 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));

        /// <summary>
        /// Get the actual texture of a sprite in play mode or edit mode.
@@ -30,9 +34,7 @@ namespace Coffee.UIParticleInternal
        {
            if (!self) return null;

-            if (Application.isPlaying) return self.texture;
-
-            var ret = s_GetActiveAtlasTextureMethod.Invoke(null, new object[] { self }) as Texture2D;
+            var ret = s_GetActiveAtlasTextureMethod(self);
            return ret ? ret : self.texture;
        }

@@ -43,7 +45,7 @@ namespace Coffee.UIParticleInternal
        {
            if (!self) return null;

-            return s_GetActiveAtlasMethod.Invoke(null, new object[] { self }) as SpriteAtlas;
+            return s_GetActiveAtlasMethod(self);
        }
 #else
        /// <summary>
--- a/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs
+++ b/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;
@@ -14,6 +14,14 @@ namespace Coffee.UIParticleInternal
    public abstract class PreloadedProjectSettings : ScriptableObject
 #if UNITY_EDITOR
    {
+        private class Postprocessor : AssetPostprocessor
+        {
+            private static void OnPostprocessAllAssets(string[] _, string[] __, string[] ___, string[] ____)
+            {
+                Initialize();
+            }
+        }
+
        private class PreprocessBuildWithReport : IPreprocessBuildWithReport
        {
            int IOrderedCallback.callbackOrder => 0;
@@ -24,32 +32,32 @@ namespace Coffee.UIParticleInternal
            }
        }

-        [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 = t.GetProperty("instance", flags)
-                        ?.GetValue(null, null) as PreloadedProjectSettings;
+                    defaultSettings = CreateInstance(t) as PreloadedProjectSettings;
+                    SetDefaultSettings(defaultSettings);
                }
                else if (GetPreloadedSettings(t).Length != 1)
                {
                    SetDefaultSettings(defaultSettings);
                }
-            }

-            EditorApplication.QueuePlayerLoopUpdate();
+                if (defaultSettings)
+                {
+                    defaultSettings.OnInitialize();
+                }
+            }
        }

        protected static string GetDefaultName(Type type, bool nicify)
        {
-            var typeName = type.Name.Replace("ProjectSettings", "");
+            var typeName = type.Name;
            return nicify
                ? ObjectNames.NicifyVariableName(typeName)
                : typeName;
@@ -74,6 +82,7 @@ namespace Coffee.UIParticleInternal
        protected static void SetDefaultSettings(PreloadedProjectSettings asset)
        {
            if (!asset) return;
+
            var type = asset.GetType();
            if (string.IsNullOrEmpty(AssetDatabase.GetAssetPath(asset)))
            {
@@ -84,7 +93,11 @@ namespace Coffee.UIParticleInternal

                var assetPath = $"Assets/ProjectSettings/{GetDefaultName(type, false)}.asset";
                assetPath = AssetDatabase.GenerateUniqueAssetPath(assetPath);
-                AssetDatabase.CreateAsset(asset, assetPath);
+                if (!File.Exists(assetPath))
+                {
+                    AssetDatabase.CreateAsset(asset, assetPath);
+                    asset.OnCreateAsset();
+                }
            }

            var preloadedAssets = PlayerSettings.GetPreloadedAssets();
@@ -98,6 +111,14 @@ namespace Coffee.UIParticleInternal

            AssetDatabase.Refresh();
        }
+
+        protected virtual void OnCreateAsset()
+        {
+        }
+
+        protected virtual void OnInitialize()
+        {
+        }
    }
 #else
    {
@@ -112,6 +133,8 @@ namespace Coffee.UIParticleInternal
 #if UNITY_EDITOR
        private string _jsonText;

+        public static bool hasInstance => s_Instance;
+
        public static T instance
        {
            get
--- a/Packages/src/Runtime/Internal/Utilities/FastAction.cs
+++ b/Packages/src/Runtime/Internal/Utilities/FastAction.cs
@@ -10,8 +10,9 @@ namespace Coffee.UIParticleInternal
    /// </summary>
    internal class FastActionBase<T>
    {
-        private static readonly ObjectPool<LinkedListNode<T>> s_NodePool =
-            new ObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true, x => x.Value = default);
+        private static readonly InternalObjectPool<LinkedListNode<T>> s_NodePool =
+            new InternalObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true,
+                x => x.Value = default);

        private readonly LinkedList<T> _delegates = new LinkedList<T>();

--- a/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs
+++ b/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs
@@ -15,7 +15,7 @@ namespace Coffee.UIParticleInternal

 #if UNITY_EDITOR
        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
-        private static void Clear()
+        public static void Clear()
        {
            s_Repository.Clear();
        }
--- a/Packages/src/Runtime/Internal/Utilities/Misc.cs
+++ b/Packages/src/Runtime/Internal/Utilities/Misc.cs
@@ -0,0 +1,132 @@
+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
+}
--- a/Packages/src/Runtime/Internal/Extensions/Misc.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/Misc.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 39ed6a6b0a72e482488bd298b2ae762e
+guid: 182319ecc315e4858b119764af0fbcb0
 MonoImporter:
  externalObjects: {}
  serializedVersion: 2
--- a/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs
@@ -6,15 +6,58 @@ namespace Coffee.UIParticleInternal
    /// <summary>
    /// Object pool.
    /// </summary>
-    internal class ObjectPool<T>
+    internal class InternalObjectPool<T> where T : class
    {
+#if UNITY_2021_1_OR_NEWER
+        private readonly Predicate<T> _onValid; // Delegate for checking if instances are valid
+        private readonly UnityEngine.Pool.ObjectPool<T> _pool;
+
+        public InternalObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        {
+            _pool = new UnityEngine.Pool.ObjectPool<T>(onCreate, null, onReturn);
+            _onValid = onValid;
+        }
+
+        /// <summary>
+        /// Rent an instance from the pool.
+        /// When you no longer need it, return it with <see cref="Return" />.
+        /// </summary>
+        public T Rent()
+        {
+            while (0 < _pool.CountInactive)
+            {
+                var instance = _pool.Get();
+                if (_onValid(instance))
+                {
+                    return instance;
+                }
+            }
+
+            // If there are no instances in the pool, create a new one.
+            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 ObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        public InternalObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
        {
            _onCreate = onCreate;
            _onValid = onValid;
@@ -54,15 +97,40 @@ 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 ListPool<T>
+    internal static class InternalListPool<T>
    {
-        private static readonly ObjectPool<List<T>> s_ListPool =
-            new ObjectPool<List<T>>(() => new List<T>(), _ => true, x => x.Clear());
+#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());

        /// <summary>
        /// Rent an instance from the pool.
@@ -81,5 +149,6 @@ namespace Coffee.UIParticleInternal
        {
            s_ListPool.Return(ref toRelease);
        }
+#endif
    }
 }
--- a/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs
+++ b/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs
@@ -14,6 +14,8 @@ 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()
        {
@@ -48,6 +50,15 @@ namespace Coffee.UIParticleInternal
            remove => s_AfterCanvasRebuildAction.Remove(value);
        }

+        /// <summary>
+        /// Event that occurs when the screen size changes.
+        /// </summary>
+        public static event Action onScreenSizeChanged
+        {
+            add => s_OnScreenSizeChangedAction.Add(value);
+            remove => s_OnScreenSizeChangedAction.Remove(value);
+        }
+
        /// <summary>
        /// Initializes the UIExtraCallbacks to ensure proper event handling.
        /// </summary>
@@ -77,6 +88,17 @@ namespace Coffee.UIParticleInternal
        /// </summary>
        private static void OnBeforeCanvasRebuild()
        {
+            var screenSize = new Vector2Int(Screen.width, Screen.height);
+            if (s_LastScreenSize != screenSize)
+            {
+                if (s_LastScreenSize != default)
+                {
+                    s_OnScreenSizeChangedAction.Invoke();
+                }
+
+                s_LastScreenSize = screenSize;
+            }
+
            s_BeforeCanvasRebuildAction.Invoke();
            InitializeAfterCanvasRebuild();
        }
--- a/Packages/src/Runtime/UIParticle.cs
+++ b/Packages/src/Runtime/UIParticle.cs
@@ -3,22 +3,25 @@ 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
        {
@@ -60,7 +63,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.")]
@@ -117,20 +120,52 @@ namespace Coffee.UIExtensions
                 "Change the bake view size.")]
        private float m_CustomViewSize = 10;

+        [SerializeField]
+        [Tooltip("Time scale multiplier.")]
+        private float m_TimeScaleMultiplier = 1;
+
+        [SerializeField]
+        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>
@@ -255,6 +290,15 @@ 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 =>
@@ -307,15 +351,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);
@@ -325,7 +369,7 @@ namespace Coffee.UIExtensions
                RefreshParticles();
            }

-            base.OnEnable();
+            UpdateRendererMaterial();
        }

        /// <summary>
@@ -342,9 +386,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>
@@ -354,6 +404,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()
        {
        }
@@ -575,12 +633,14 @@ namespace Coffee.UIExtensions
            {
                var ps = particleSystems[i];
                if (!ps) continue;
-                GetRenderer(j++).Set(this, ps, false);
+
+                var mainEmitter = ps.GetMainEmitter(particleSystems);
+                GetRenderer(j++).Set(this, ps, false, mainEmitter);

                // If the trail is enabled, set it additionally.
                if (ps.trails.enabled)
                {
-                    GetRenderer(j++).Set(this, ps, true);
+                    GetRenderer(j++).Set(this, ps, true, mainEmitter);
                }
            }
        }
@@ -646,17 +706,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++)
--- a/Packages/src/Runtime/UIParticle.cs.meta
+++ b/Packages/src/Runtime/UIParticle.cs.meta
@@ -5,7 +5,7 @@ MonoImporter:
  serializedVersion: 2
  defaultReferences: []
  executionOrder: 0
-  icon: {fileID: 2800000, guid: 5f0675613942149309588d556e33d990, type: 3}
+  icon: {instanceID: 0}
  userData: 
  assetBundleName: 
  assetBundleVariant: 
--- a/Packages/src/Runtime/UIParticleRenderer.cs
+++ b/Packages/src/Runtime/UIParticleRenderer.cs
@@ -15,6 +15,7 @@ using UnityEngine.UI;

 namespace Coffee.UIExtensions
 {
+    [Icon("Packages/com.coffee.ui-particle/Icons/UIParticleIcon.png")]
    [ExecuteAlways]
    [RequireComponent(typeof(RectTransform))]
    [RequireComponent(typeof(CanvasRenderer))]
@@ -40,6 +41,7 @@ namespace Coffee.UIExtensions
        private Vector2Int _prevScreenSize;
        private bool _preWarm;
        private ParticleSystemRenderer _renderer;
+        private ParticleSystem _mainEmitter;

        public override Texture mainTexture => _isTrail ? null : _particleSystem.GetTextureForSprite();

@@ -112,6 +114,7 @@ namespace Coffee.UIExtensions
            _parent = null;
            _particleSystem = null;
            _renderer = null;
+            _mainEmitter = null;
            if (0 <= index)
            {
                _index = index;
@@ -223,7 +226,7 @@ namespace Coffee.UIExtensions
            return _modifiedMaterial;
        }

-        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail)
+        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail, ParticleSystem mainEmitter)
        {
            _parent = parent;
            maskable = parent.maskable;
@@ -246,10 +249,7 @@ namespace Coffee.UIExtensions

            ps.TryGetComponent(out _renderer);
            _renderer.enabled = false;
-
-            //_emitter = emitter;
            _isTrail = isTrail;
-
            _renderer.GetSharedMaterials(s_Materials);
            material = s_Materials[isTrail ? 1 : 0];
            s_Materials.Clear();
@@ -266,6 +266,7 @@ namespace Coffee.UIExtensions
            _prevScreenSize = new Vector2Int(Screen.width, Screen.height);
            _prevCanvasScale = canvas ? canvas.scaleFactor : 1f;
            _delay = true;
+            _mainEmitter = mainEmitter;

            canvasRenderer.SetTexture(null);

@@ -303,7 +304,7 @@ namespace Coffee.UIExtensions

            // Simulate particles.
            Profiler.BeginSample("[UIParticle] Bake Mesh > Simulate Particles");
-            if (!_isTrail && _parent.canSimulate)
+            if (!_isTrail && _parent.canSimulate && !_mainEmitter)
            {
 #if UNITY_EDITOR
                if (!Application.isPlaying)
@@ -421,7 +422,7 @@ namespace Coffee.UIExtensions
                    workerMesh.LinearToGamma();
                }

-                var components = ListPool<Component>.Rent();
+                var components = InternalListPool<Component>.Rent();
                GetComponents(typeof(IMeshModifier), components);
                for (var i = 0; i < components.Count; i++)
                {
@@ -430,7 +431,7 @@ namespace Coffee.UIExtensions
 #pragma warning restore CS0618 // Type or member is obsolete
                }

-                ListPool<Component>.Return(ref components);
+                InternalListPool<Component>.Return(ref components);
            }

            Profiler.EndSample();
@@ -442,7 +443,7 @@ namespace Coffee.UIExtensions

            // Get grouped renderers.
            Profiler.BeginSample("[UIParticleRenderer] Set Mesh");
-            var renderers = ListPool<UIParticleRenderer>.Rent();
+            var renderers = InternalListPool<UIParticleRenderer>.Rent();
            if (_parent.useMeshSharing)
            {
                UIParticleUpdater.GetGroupedRenderers(_parent.groupId, _index, renderers);
@@ -459,7 +460,7 @@ namespace Coffee.UIExtensions
                r.canvasRenderer.SetMaterial(materialForRendering, 0);
            }

-            ListPool<UIParticleRenderer>.Return(ref renderers);
+            InternalListPool<UIParticleRenderer>.Return(ref renderers);

            if (_parent.canRender)
            {
@@ -542,6 +543,30 @@ namespace Coffee.UIExtensions
                    return Matrix4x4.Translate(psPos)
                           * Matrix4x4.Scale(scale);
                case ParticleSystemSimulationSpace.World:
+                    if (_isTrail)
+                    {
+                        return Matrix4x4.Translate(psPos)
+                               * Matrix4x4.Scale(scale)
+                               * Matrix4x4.Translate(-psPos);
+                    }
+
+                    if (_mainEmitter)
+                    {
+                        if (_mainEmitter.IsLocalSpace())
+                        {
+                            return Matrix4x4.Translate(psPos)
+                                   * Matrix4x4.Scale(scale)
+                                   * Matrix4x4.Translate(-psPos);
+                        }
+                        else
+                        {
+                            psPos = _particleSystem.transform.position - _mainEmitter.transform.position;
+                            return Matrix4x4.Translate(psPos)
+                                   * Matrix4x4.Scale(scale)
+                                   * Matrix4x4.Translate(-psPos);
+                        }
+                    }
+
                    return Matrix4x4.Scale(scale);
                case ParticleSystemSimulationSpace.Custom:
                    return Matrix4x4.Translate(_particleSystem.main.customSimulationSpace.position.GetScaled(scale))
@@ -604,6 +629,7 @@ namespace Coffee.UIExtensions
                : main.useUnscaledTime
                    ? Time.unscaledDeltaTime
                    : Time.deltaTime;
+            deltaTime *= _parent.timeScaleMultiplier;

            // Pre-warm:
            if (0 < deltaTime && _preWarm)
--- a/Packages/src/Runtime/UIParticleRenderer.cs.meta
+++ b/Packages/src/Runtime/UIParticleRenderer.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: 
--- a/Packages/src/Runtime/UIParticleUpdater.cs
+++ b/Packages/src/Runtime/UIParticleUpdater.cs
@@ -40,13 +40,26 @@ 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()
        {
--- a/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
+++ b/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
@@ -171,5 +171,32 @@ 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;
+        }
    }
 }
--- a/Packages/src/Samples~/Demo/Scripts/UIParticle_Demo.cs
+++ b/Packages/src/Samples~/Demo/Scripts/UIParticle_Demo.cs
@@ -1,3 +1,4 @@
+using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Serialization;
 using UnityEngine.UI;
@@ -51,11 +52,7 @@ namespace Coffee.UIExtensions.Demo

        public void EnableAnimations(bool flag)
        {
-#if UNITY_2023_1_OR_NEWER
-            foreach (var animator in FindObjectsByType<Animator>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-            foreach (var animator in FindObjectsOfType<Animator>())
-#endif
+            foreach (var animator in Misc.FindObjectsOfType<Animator>())
            {
                animator.enabled = flag;
            }
@@ -83,11 +80,7 @@ namespace Coffee.UIExtensions.Demo

        public void UIParticle_Scale(float scale)
        {
-#if UNITY_2023_1_OR_NEWER
-            foreach (var uip in FindObjectsByType<UIParticle>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-            foreach (var uip in FindObjectsOfType<UIParticle>())
-#endif
+            foreach (var uip in Misc.FindObjectsOfType<UIParticle>())
            {
                uip.scale = scale;
            }
@@ -95,11 +88,7 @@ namespace Coffee.UIExtensions.Demo

        public void ParticleSystem_WorldSpaseSimulation(bool flag)
        {
-#if UNITY_2023_1_OR_NEWER
-            foreach (var p in FindObjectsByType<ParticleSystem>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-            foreach (var p in FindObjectsOfType<ParticleSystem>())
-#endif
+            foreach (var p in Misc.FindObjectsOfType<ParticleSystem>())
            {
                var main = p.main;
                main.simulationSpace = flag
@@ -135,11 +124,7 @@ namespace Coffee.UIExtensions.Demo

        public void ParticleSystem_SetScale(float scale)
        {
-#if UNITY_2023_1_OR_NEWER
-            foreach (var ps in FindObjectsByType<ParticleSystem>(FindObjectsInactive.Include, FindObjectsSortMode.None))
-#else
-            foreach (var ps in FindObjectsOfType<ParticleSystem>())
-#endif
+            foreach (var ps in Misc.FindObjectsOfType<ParticleSystem>())
            {
                ps.transform.localScale = new Vector3(scale, scale, scale);
            }
--- a/Packages/src/package.json
+++ b/Packages/src/package.json
@@ -2,8 +2,8 @@
  "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.10.1",
-  "unity": "2018.2",
+  "version": "5.0.0-preview.16",
+  "unity": "2019.3",
  "license": "MIT",
  "repository": {
    "type": "git",
--- a/ProjectSettings/MinimalResourceSettings.json
+++ b/ProjectSettings/MinimalResourceSettings.json
@@ -0,0 +1,11 @@
+{
+    "MonoBehaviour": {
+        "m_Enabled": true,
+        "m_EditorHideFlags": 0,
+        "m_Name": "",
+        "m_EditorClassIdentifier": "",
+        "m_OutputDllPaths": [
+            "Packages/com.coffee.ui-particle/Runtime/Coffee.UIParticle.R.dll"
+        ]
+    }
+}
Author	SHA1	Message	Date
semantic-release-bot	9523ae12c0	chore(release): 5.0.0-preview.16 [skip ci] # [5.0.0-preview.16](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.15...5.0.0-preview.16) (2025-03-15) ### Bug Fixes * IL2CPP build fails on older versions of Unity ([`0da6525`](`0da652520c`)) * NRE on enable ([`0cff50e`](`0cff50ef69`)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)	2025-03-15 08:12:51 +00:00
mob-sakai	96106370e5	Merge remote-tracking branch 'origin/develop' into develop-preview # Conflicts: # Packages/src/CHANGELOG.md # Packages/src/package.json	2025-03-15 17:02:36 +09:00
semantic-release-bot	bb2d588e0c	chore(release): 4.11.2 [skip ci] ## [4.11.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.1...v4.11.2) (2025-03-15) ### Bug Fixes * IL2CPP build fails on older versions of Unity ([`0da6525`](`0da652520c`)) * NRE on enable ([`0cff50e`](`0cff50ef69`)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)	2025-03-15 07:59:37 +00:00
mob-sakai	078005a1a7	chore: fix NanoMonitor link url	2025-03-15 16:58:52 +09:00
mob-sakai	0cff50ef69	fix: NRE on enable close #359	2025-03-14 19:44:02 +09:00
mob-sakai	0da652520c	fix: IL2CPP build fails on older versions of Unity	2025-03-14 19:29:41 +09:00
mob-sakai	4199492e3a	chore: update internal	2025-03-14 19:29:22 +09:00
mob-sakai	1f88bb255e	chore: fix settings icon	2025-03-14 19:24:22 +09:00
semantic-release-bot	73d208e9b8	chore(release): 5.0.0-preview.15 [skip ci] # [5.0.0-preview.15](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.14...5.0.0-preview.15) (2025-02-21) ### Bug Fixes * component icons will no longer be displayed in the scene view ([`6dfbdae`](`6dfbdae38d`)) * editor crashed on exit play mode (editor, windows) ([`47ee45c`](`47ee45cbbe`)), closes [#351](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/351) ### Features * add 'TimeScaleMultiplier' option ([`925af0b`](`925af0b604`))	2025-02-21 09:45:26 +00:00
mob-sakai	bfac4d4e2f	Merge remote-tracking branch 'origin/develop' into develop-preview # Conflicts: # Packages/src/CHANGELOG.md # Packages/src/Runtime/UIParticle.cs # Packages/src/package.json	2025-02-21 18:38:11 +09:00
semantic-release-bot	e3791866b7	chore(release): 4.11.1 [skip ci] ## [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`](`6dfbdae38d`))	2025-02-21 09:35:05 +00:00
mob-sakai	6dfbdae38d	fix: component icons will no longer be displayed in the scene view	2025-02-21 18:22:24 +09:00
mob-sakai	b63220b871	doc: update readme	2025-02-21 17:57:12 +09:00
semantic-release-bot	3fd2bea599	chore(release): 4.11.0 [skip ci] # [4.11.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.7...v4.11.0) (2025-02-21) ### Features * add 'TimeScaleMultiplier' option ([`925af0b`](`925af0b604`))	2025-02-21 07:17:09 +00:00
mob-sakai	925af0b604	feat: add 'TimeScaleMultiplier' option	2025-02-21 16:10:06 +09:00
semantic-release-bot	d1a1e23e50	chore(release): 4.10.7 [skip ci] ## [4.10.7](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.6...v4.10.7) (2025-01-14) ### Bug Fixes * editor crashed on exit play mode (editor, windows) ([`47ee45c`](`47ee45cbbe`)), closes [#351](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/351)	2025-01-14 11:49:21 +00:00
mob-sakai	47ee45cbbe	fix: editor crashed on exit play mode (editor, windows) close #351	2025-01-07 10:25:23 +09:00
semantic-release-bot	88d956ece8	chore(release): 5.0.0-preview.14 [skip ci] # [5.0.0-preview.14](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.13...5.0.0-preview.14) (2025-01-03) ### Bug Fixes * sub-emitter particles may not render correctly in certain scenarios ([`8276684`](`8276684c3b`)), closes [#348](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/348) * sub-emitter's `inherit velocity` module doubles at runtime ([`67de3d1`](`67de3d1bd3`)), closes [#349](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/349)	2025-01-03 14:26:44 +00:00
semantic-release-bot	1b0110320b	chore(release): 4.10.6 [skip ci] ## [4.10.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.5...v4.10.6) (2025-01-03) ### Bug Fixes * sub-emitter particles may not render correctly in certain scenarios ([`8276684`](`8276684c3b`)), closes [#348](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/348) * sub-emitter's `inherit velocity` module doubles at runtime ([`67de3d1`](`67de3d1bd3`)), closes [#349](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/349)	2025-01-03 14:24:40 +00:00
mob-sakai	2842b3db7d	Merge branch 'develop' into develop-preview	2025-01-03 23:14:17 +09:00
mob-sakai	a1ca74f854	chore: update coffee.internal	2025-01-03 23:13:17 +09:00
mob-sakai	8276684c3b	fix: sub-emitter particles may not render correctly in certain scenarios close #348	2025-01-03 23:13:17 +09:00
mob-sakai	67de3d1bd3	fix: sub-emitter's `inherit velocity` module doubles at runtime close #349	2025-01-03 23:13:17 +09:00
semantic-release-bot	c2958d5d7d	chore(release): 5.0.0-preview.13 [skip ci] # [5.0.0-preview.13](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.12...5.0.0-preview.13) (2025-01-03) ### Features * change the default value of `UIParticle.scale` from `10` to `1` ([`9955eef`](`9955eefdc2`)) * UIParticle no longer inherits from MaskableGraphic ([`c09bfb8`](`c09bfb81ab`)) ### BREAKING CHANGES * Some members inherited from MaskableGraphic will no longer be available.	2025-01-03 14:12:36 +00:00
mob-sakai	7456b5d555	docs: update documents	2025-01-03 23:08:20 +09:00
mob-sakai	9955eefdc2	feat: change the default value of `UIParticle.scale` from `10` to `1`	2025-01-03 23:02:15 +09:00
mob-sakai	c09bfb81ab	feat: UIParticle no longer inherits from MaskableGraphic BREAKING CHANGE: Some members inherited from MaskableGraphic will no longer be available.	2025-01-03 23:02:15 +09:00
mob-sakai	fab2ed1697	chore: update coffee.internal	2025-01-03 22:58:23 +09:00
mob-sakai	ef4dbc3cba	fix: sub-emitter particles may not render correctly in certain scenarios close #248	2025-01-03 22:50:36 +09:00
mob-sakai	27551a4d47	fix: sub-emitter's `inherit velocity` module doubles at runtime close #249	2025-01-03 22:29:07 +09:00
semantic-release-bot	90d966e659	chore(release): 4.10.5 [skip ci] ## [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`](`934f4b8f1c`)), closes [#346](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/346)	2024-12-23 03:54:11 +00:00
mob-sakai	0036b03d12	refactor: update coffee.internal	2024-12-23 12:53:15 +09:00
mob-sakai	934f4b8f1c	fix: '3D' scale toggle in the inspector does not keep on reload close #346	2024-12-22 13:10:21 +09:00
semantic-release-bot	fe4fcc5ddd	chore(release): 4.10.4 [skip ci] ## [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`](`95235a929b`)), closes [#345](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/345)	2024-12-19 08:50:19 +00:00
mob-sakai	072aac521b	chore: update test workflow	2024-12-18 19:50:31 +09:00
mob-sakai	95235a929b	fix: rendering issues when playing with opening a prefab stage close #345	2024-12-18 19:46:32 +09:00
semantic-release-bot	1a748f19d0	chore(release): 4.10.3 [skip ci] ## [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`](`abe09485f6`)), closes [#342](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/342)	2024-11-20 16:56:36 +00:00
mob-sakai	f9ce2c6c96	chore: update workflows	2024-11-21 01:46:37 +09:00
mob-sakai	abe09485f6	fix: if not configured as a preloaded asset, the project settings asset will be regenerated close #342	2024-11-21 01:39:16 +09:00
mob-sakai	253fb52650	refactor: update coffee.internal	2024-11-21 01:36:51 +09:00
mob-sakai	3544c593e2	chore: add demo for cfxrf	2024-11-21 01:26:03 +09:00
semantic-release-bot	4faf151c87	chore(release): 4.10.2 [skip ci] ## [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`](`afe00a1dde`)), closes [#335](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/335)	2024-11-01 02:15:40 +00:00
Jie	afe00a1dde	fix: trail incorrect offset close #335	2024-11-01 11:14:03 +09:00