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-02-21 09:45:26 +00:00 · 2025-02-21 18:38:11 +09:00 · 2025-01-03 14:26:44 +00:00
29 changed files with 391 additions and 298 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,15 +23,12 @@ 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@v5
+        uses: actions/checkout@v4

      - name: 🔖 Run semantic release
-        uses: cycjimmy/semantic-release-action@v5
+        uses: cycjimmy/semantic-release-action@v4
        id: release
        with:
          working_directory: Packages/src
@@ -40,62 +38,7 @@ jobs:
        env:
          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@v5
-        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@v5
-        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
@@ -10,7 +10,6 @@ env:
  MINIMUM_VERSION: 2019.4
  # EXCLUDE_FILTER: The excluded versions of Unity.
  EXCLUDE_FILTER: "(2020.2.0|2021.1|2023.3)"
-  PROJECT_PATH: .

 on:
  workflow_dispatch:
@@ -22,7 +21,7 @@ on:
  push:
    branches:
      - develop
-      - "develop-*"
+      - develop-preview
    tags:
      - "!*"
    paths-ignore:
@@ -72,11 +71,11 @@ jobs:
    steps:
      - name: 🚚 Checkout ($${{ github.ref }})
        if: github.event_name == 'push'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4

      - name: 🚚 Checkout pull request (pull_request_target)
        if: github.event_name == 'pull_request_target'
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha }}
          fetch-depth: 0
@@ -86,27 +85,25 @@ jobs:
        run: |
          git config user.name "GitHub Actions"
          git config user.email "actions@github.com"
-          git rebase ${{ github.event.pull_request.base.sha }}
-          git log --oneline -n 10
+          git merge origin/${{ github.event.pull_request.base.ref }} --no-edit

      - name: 📥 Cache library
        uses: actions/cache@v4
        with:
-          path: ${{ env.PROJECT_PATH }}/Library
-          key: ${{ env.PROJECT_PATH }}-Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
+          path: Library
+          key: Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
          restore-keys: |
-            ${{ env.PROJECT_PATH }}-Library-${{ matrix.unityVersion }}-
-            ${{ env.PROJECT_PATH }}-Library-
+            Library-${{ matrix.unityVersion }}-
+            Library-

      - name: 🛠️ Build Unity Project (Test)
-        uses: game-ci/unity-builder@main
+        uses: game-ci/unity-builder@v4
        timeout-minutes: 45
        with:
          customImage: ghcr.io/mob-sakai/unity3d:${{ matrix.unityVersion }}
          targetPlatform: StandaloneLinux64
          allowDirtyBuild: true
          customParameters: -nographics
-          projectPath: ${{ env.PROJECT_PATH }}
        env:
          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
@@ -121,7 +118,6 @@ jobs:
          customParameters: -nographics
          checkName: ${{ matrix.unityVersion }} Test Results
          githubToken: ${{ github.token }}
-          projectPath: ${{ env.PROJECT_PATH }}
        env:
          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
--- a/Assets/Tests/Editor/NewTestScript.cs
+++ b/Assets/Tests/Editor/NewTestScript.cs
@@ -1,21 +1,16 @@
 using System.Collections;
-using Coffee.UIParticleInternal;
 using NUnit.Framework;
-using UnityEngine;
 using UnityEngine.TestTools;

 namespace Coffee.UIParticle.Editor.Tests
 {
    public class NewTestScript
    {
-        [TestCase(-1)]
-        [TestCase(0)]
-        [TestCase(2048)]
-        [TestCase(3000)]
-        public void GetParticleArray(int requiredSize)
+        // A Test behaves as an ordinary method
+        [Test]
+        public void NewTestScriptSimplePasses()
        {
-            var array = ParticleSystemExtensions.GetParticleArray(requiredSize);
-            Debug.Log($"requiredSize: {requiredSize}, array.Length: {array.Length}");
+            // Use the Assert class to test conditions
        }

        // A UnityTest behaves like a coroutine in Play Mode. In Edit Mode you can use
--- 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,36 +1,4 @@
-## [4.12.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.0...v4.12.1) (2026-03-24)
-
-
-### Bug Fixes
-
-* ignore "EditorOnly" tagged gameObjects on refresh ([031d46a](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/031d46a3216c942d2d1a6ccfadf5f0b9e3ce3006))
-
-# [4.12.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.4...v4.12.0) (2026-03-24)
-
-
-### Features
-
-* explicit null checks ([5384f61](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/5384f61c569e9f78ff9d5b45acfc6f5c2f021a87))
-
-## [4.11.4](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.3...v4.11.4) (2025-12-24)
-
-
-### Bug Fixes
-
-* add early return for case where subEmitter module is disabled ([d1386a1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/d1386a12216743a6e09f1b9b87bea1dfcf7702e4))
-* avoid endless loop ([eb2e862](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/eb2e862e80e549c8cf16ddfed776c101c2413bac)), closes [#392](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/392)
-
-## [4.11.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.2...v4.11.3) (2025-10-14)
-
-
-### Bug Fixes
-
-* fix icon ([a9461ec](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9461ecb4d40d7fe878e12465d6e38faae7ae65b))
-* fix URL link in README ([1c8c65d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1c8c65d25e7f6fe7b1d20da4461333df8fc7578e)), closes [#376](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/376)
-* fix: second and subsequent bursts not displayed when world simulation and non-looping ([df2f3ca](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/df2f3caafbe279f1457d74f8183cb561ac14aa17)), closes [#326](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/326)
-* UIParticle in canvas with 0f-0.01f alpha value does not start to play until alpha value is greater than 0.01f, causes play calls to be delayed unintentionally if canvas alpha value is set to mentioned value range ([38aec2e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/38aec2ea1afd77677d629c86665a3342d92e49d9))
-
-## [4.11.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.1...v4.11.2) (2025-03-15)
+# [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
@@ -38,28 +6,20 @@
 * 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)
+# [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))
-
-# [4.11.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.7...v4.11.0) (2025-02-21)
+* 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))

-## [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](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/47ee45cbbe651a8f87ca2b8a3948f8b88db8211e)), closes [#351](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/351)
-
-## [4.10.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.5...v4.10.6) (2025-01-03)
+# [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
@@ -67,6 +27,19 @@
 * 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)


--- a/Packages/src/Editor/AnimatablePropertyEditor.cs
+++ b/Packages/src/Editor/AnimatablePropertyEditor.cs
@@ -76,7 +76,7 @@ namespace Coffee.UIExtensions
            for (var j = 0; j < mats.Count; j++)
            {
                var mat = mats[j];
-                if (mat == null || mat.shader == null) continue;
+                if (!mat || !mat.shader) continue;

                for (var i = 0; i < ShaderUtil.GetPropertyCount(mat.shader); i++)
                {
--- 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,7 +25,7 @@ namespace Coffee.UIExtensions
 {
    [CustomEditor(typeof(UIParticle))]
    [CanEditMultipleObjects]
-    internal class UIParticleEditor : GraphicEditor
+    internal class UIParticleEditor : Editor
    {
        internal class State : ScriptableSingleton<State>
        {
@@ -87,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");
@@ -110,7 +107,7 @@ namespace Coffee.UIExtensions
                {
                    var ps = sp.GetArrayElementAtIndex(index).objectReferenceValue as ParticleSystem;
                    var materialCount = 0;
-                    if (ps != null && ps.TryGetComponent<ParticleSystemRenderer>(out var psr))
+                    if (ps && ps.TryGetComponent<ParticleSystemRenderer>(out var psr))
                    {
                        materialCount = psr.sharedMaterials.Length;
                    }
@@ -124,7 +121,7 @@ namespace Coffee.UIExtensions
                    var p = sp.GetArrayElementAtIndex(index);
                    EditorGUI.ObjectField(rect, p, GUIContent.none);
                    var ps = p.objectReferenceValue as ParticleSystem;
-                    if (ps == null || !ps.TryGetComponent<ParticleSystemRenderer>(out var psr)) return;
+                    if (!ps || !ps.TryGetComponent<ParticleSystemRenderer>(out var psr)) return;

                    rect.x += 15;
                    rect.width -= 15;
@@ -191,7 +188,7 @@ namespace Coffee.UIExtensions
        public override void OnInspectorGUI()
        {
            var current = target as UIParticle;
-            if (current == null) return;
+            if (!current) return;

            Profiler.BeginSample("(UIP:E) OnInspectorGUI");
            serializedObject.Update();
@@ -267,7 +264,7 @@ namespace Coffee.UIExtensions
            Profiler.BeginSample("(UIP:E) Non-UI built-in shader is not supported.");
            foreach (var mat in s_TempMaterials)
            {
-                if (mat == null || mat.shader == null) continue;
+                if (!mat || !mat.shader) continue;
                var shader = mat.shader;
                if (IsBuiltInObject(shader) && !shader.name.StartsWith("UI/"))
                {
@@ -286,7 +283,7 @@ namespace Coffee.UIExtensions
            {
                foreach (var mat in s_TempMaterials)
                {
-                    if (mat == null || mat.shader == null) continue;
+                    if (!mat || !mat.shader) continue;
                    var shader = mat.shader;
                    if (!s_Shaders.Add(shader)) continue;

@@ -464,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/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/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>

--- a/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs
@@ -38,7 +38,7 @@ namespace Coffee.UIParticleInternal
        private static void GetComponentsInChildren_Internal<T>(this Component self, List<T> results, int depth)
            where T : Component
        {
-            if (self == null || results == null || depth < 0) return;
+            if (!self || results == null || depth < 0) return;

            var tr = self.transform;
            if (tr.TryGetComponent<T>(out var t))
@@ -59,7 +59,7 @@ namespace Coffee.UIParticleInternal
        /// </summary>
        public static T GetOrAddComponent<T>(this Component self) where T : Component
        {
-            if (self == null) return null;
+            if (!self) return null;
            return self.TryGetComponent<T>(out var component)
                ? component
                : self.gameObject.AddComponent<T>();
@@ -166,7 +166,7 @@ namespace Coffee.UIParticleInternal
 #if !UNITY_2021_2_OR_NEWER && !UNITY_2020_3_45 && !UNITY_2020_3_46 && !UNITY_2020_3_47 && !UNITY_2020_3_48
        public static T GetComponentInParent<T>(this Component self, bool includeInactive) where T : Component
        {
-            if (self == null) return null;
+            if (!self) return null;
            if (!includeInactive) return self.GetComponentInParent<T>();

            var current = self.transform;
@@ -184,9 +184,9 @@ namespace Coffee.UIParticleInternal
        /// <summary>
        /// Verify whether it can be converted to the specified component.
        /// </summary>
-            internal static bool CanConvertTo<T>(this Object context) where T : MonoBehaviour
+        internal static bool CanConvertTo<T>(this Object context) where T : MonoBehaviour
        {
-            return context != null && context.GetType() != typeof(T);
+            return context && context.GetType() != typeof(T);
        }

        /// <summary>
--- a/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
@@ -32,10 +32,10 @@ namespace Coffee.UIParticleInternal
        /// </summary>
        public static Texture2D GetActualTexture(this Sprite self)
        {
-            if (self == null) return null;
+            if (!self) return null;

            var ret = s_GetActiveAtlasTextureMethod(self);
-            return ret != null ? ret : self.texture;
+            return ret ? ret : self.texture;
        }

        /// <summary>
@@ -43,7 +43,7 @@ namespace Coffee.UIParticleInternal
        /// </summary>
        public static SpriteAtlas GetActiveAtlas(this Sprite self)
        {
-            if (self == null) return null;
+            if (!self) return null;

            return s_GetActiveAtlasMethod(self);
        }
@@ -53,7 +53,7 @@ namespace Coffee.UIParticleInternal
        /// </summary>
        internal static Texture2D GetActualTexture(this Sprite self)
        {
-            return self != null ? self.texture : null;
+            return self ? self.texture : null;
        }
 #endif
    }
--- a/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs
+++ b/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs
@@ -37,7 +37,7 @@ namespace Coffee.UIParticleInternal
            foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
            {
                var defaultSettings = GetDefaultSettings(t);
-                if (defaultSettings == null)
+                if (!defaultSettings)
                {
                    // When create a new instance, automatically set it as default settings.
                    defaultSettings = CreateInstance(t) as PreloadedProjectSettings;
@@ -48,7 +48,7 @@ namespace Coffee.UIParticleInternal
                    SetDefaultSettings(defaultSettings);
                }

-                if (defaultSettings != null)
+                if (defaultSettings)
                {
                    defaultSettings.OnInitialize();
                }
@@ -66,7 +66,7 @@ namespace Coffee.UIParticleInternal
        private static Object[] GetPreloadedSettings(Type type)
        {
            return PlayerSettings.GetPreloadedAssets()
-                .Where(x => x != null && x.GetType() == type)
+                .Where(x => x && x.GetType() == type)
                .ToArray();
        }

@@ -76,12 +76,12 @@ namespace Coffee.UIParticleInternal
                   ?? AssetDatabase.FindAssets($"t:{nameof(PreloadedProjectSettings)}")
                       .Select(AssetDatabase.GUIDToAssetPath)
                       .Select(AssetDatabase.LoadAssetAtPath<PreloadedProjectSettings>)
-                       .FirstOrDefault(x => x != null && x.GetType() == type);
+                       .FirstOrDefault(x => x && x.GetType() == type);
        }

        protected static void SetDefaultSettings(PreloadedProjectSettings asset)
        {
-            if (asset == null) return;
+            if (!asset) return;

            var type = asset.GetType();
            if (string.IsNullOrEmpty(AssetDatabase.GetAssetPath(asset)))
@@ -103,7 +103,7 @@ namespace Coffee.UIParticleInternal
            var preloadedAssets = PlayerSettings.GetPreloadedAssets();
            var projectSettings = GetPreloadedSettings(type);
            PlayerSettings.SetPreloadedAssets(preloadedAssets
-                .Where(x => x != null)
+                .Where(x => x)
                .Except(projectSettings.Except(new[] { asset }))
                .Append(asset)
                .Distinct()
@@ -133,19 +133,19 @@ namespace Coffee.UIParticleInternal
 #if UNITY_EDITOR
        private string _jsonText;

-        public static bool hasInstance => s_Instance != null;
+        public static bool hasInstance => s_Instance;

        public static T instance
        {
            get
            {
-                if (s_Instance != null) return s_Instance;
+                if (s_Instance) return s_Instance;

                s_Instance = GetDefaultSettings(typeof(T)) as T;
-                if (s_Instance != null) return s_Instance;
+                if (s_Instance) return s_Instance;

                s_Instance = CreateInstance<T>();
-                if (s_Instance == null)
+                if (!s_Instance)
                {
                    s_Instance = null;
                    return s_Instance;
@@ -174,7 +174,7 @@ namespace Coffee.UIParticleInternal
            }
        }
 #else
-    public static T instance => s_Instance != null ? s_Instance : s_Instance = CreateInstance<T>();
+        public static T instance => s_Instance ? s_Instance : s_Instance = CreateInstance<T>();
 #endif

        /// <summary>
@@ -183,7 +183,7 @@ namespace Coffee.UIParticleInternal
        protected virtual void OnEnable()
        {
 #if UNITY_EDITOR
-            var isDefaultSettings = s_Instance == null || s_Instance == this || GetDefaultSettings(typeof(T)) == this;
+            var isDefaultSettings = !s_Instance || s_Instance == this || GetDefaultSettings(typeof(T)) == this;
            if (!isDefaultSettings)
            {
                DestroyImmediate(this, true);
@@ -193,7 +193,7 @@ namespace Coffee.UIParticleInternal
            EditorApplication.playModeStateChanged += OnPlayModeStateChanged;
 #endif

-            if (s_Instance != null) return;
+            if (s_Instance) return;
            s_Instance = this as T;
        }

@@ -222,7 +222,7 @@ namespace Coffee.UIParticleInternal

            public override void OnGUI(string searchContext)
            {
-                if (_target == null)
+                if (!_target)
                {
                    if (_editor)
                    {
--- a/Packages/src/Runtime/Internal/Utilities/Logging.cs
+++ b/Packages/src/Runtime/Internal/Utilities/Logging.cs
@@ -48,7 +48,7 @@ namespace Coffee.UIParticleInternal
        public static void LogIf(bool enable, object tag, object message, Object context = null)
        {
            if (!enable) return;
-            Log_Internal(LogType.Log, tag, message, context != null ? context : tag as Object);
+            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
        }

 #if !ENABLE_COFFEE_LOGGER
@@ -56,7 +56,7 @@ namespace Coffee.UIParticleInternal
 #endif
        public static void Log(object tag, object message, Object context = null)
        {
-            Log_Internal(LogType.Log, tag, message, context != null ? context : tag as Object);
+            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
        }

 #if !ENABLE_COFFEE_LOGGER
@@ -64,13 +64,13 @@ namespace Coffee.UIParticleInternal
 #endif
        public static void LogWarning(object tag, object message, Object context = null)
        {
-            Log_Internal(LogType.Warning, tag, message, context != null ? context : tag as Object);
+            Log_Internal(LogType.Warning, tag, message, context ? context : tag as Object);
        }

        public static void LogError(object tag, object message, Object context = null)
        {
 #if ENABLE_COFFEE_LOGGER
-            Log_Internal(LogType.Error, tag, message, context != null ? context : tag as Object);
+            Log_Internal(LogType.Error, tag, message, context ? context : tag as Object);
 #else
            Debug.LogError($"{tag}: {message}", context);
 #endif
--- a/Packages/src/Runtime/Internal/Utilities/Misc.cs
+++ b/Packages/src/Runtime/Internal/Utilities/Misc.cs
@@ -29,7 +29,7 @@ namespace Coffee.UIParticleInternal

        public static void Destroy(Object obj)
        {
-            if (obj == null) return;
+            if (!obj) return;
 #if UNITY_EDITOR
            if (!Application.isPlaying)
            {
@@ -44,7 +44,7 @@ namespace Coffee.UIParticleInternal

        public static void DestroyImmediate(Object obj)
        {
-            if (obj == null) return;
+            if (!obj) return;
 #if UNITY_EDITOR
            if (Application.isEditor)
            {
@@ -61,7 +61,7 @@ namespace Coffee.UIParticleInternal
        public static void SetDirty(Object obj)
        {
 #if UNITY_EDITOR
-            if (obj == null) return;
+            if (!obj) return;
            EditorUtility.SetDirty(obj);
 #endif
        }
@@ -117,11 +117,11 @@ namespace Coffee.UIParticleInternal
            foreach (var type in types)
            {
                var script = scripts.FirstOrDefault(x => x.GetClass() == type);
-                if (script == null) continue;
+                if (!script) continue;

                var path = type.GetCustomAttribute<IconAttribute>()?._path;
                var icon = AssetDatabase.LoadAssetAtPath<Texture2D>(path);
-                if (icon == null) continue;
+                if (!icon) continue;

                s_SetIconForObject(script, icon);
            }
--- a/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs
@@ -90,7 +90,7 @@ namespace Coffee.UIParticleInternal
            Profiler.BeginSample("(COF)[ObjectRepository] GetFromCache");
            if (_cache.TryGetValue(hash, out var entry))
            {
-                if (entry.storedObject == null)
+                if (!entry.storedObject)
                {
                    Release(ref entry.storedObject);
                    Profiler.EndSample();
@@ -116,7 +116,7 @@ namespace Coffee.UIParticleInternal

        private void Add(Hash128 hash, ref T obj, T newObject)
        {
-            if (newObject == null)
+            if (!newObject)
            {
                Release(ref obj);
                obj = newObject;
@@ -151,7 +151,7 @@ namespace Coffee.UIParticleInternal
                && _cache.TryGetValue(hash, out var entry))
            {
                entry.reference--;
-                if (entry.reference <= 0 || entry.storedObject == null)
+                if (entry.reference <= 0 || !entry.storedObject)
                {
                    Remove(entry);
                }
@@ -192,7 +192,7 @@ namespace Coffee.UIParticleInternal
            public void Release(Action<T> onRelease)
            {
                reference = 0;
-                if (storedObject != null)
+                if (storedObject)
                {
                    onRelease?.Invoke(storedObject);
                }
--- a/Packages/src/Runtime/UIParticle.cs
+++ b/Packages/src/Runtime/UIParticle.cs
@@ -3,13 +3,12 @@ using System.Collections.Generic;
 using System.Runtime.CompilerServices;
 using Coffee.UIParticleInternal;
 using UnityEngine;
+using UnityEngine.EventSystems;
 using UnityEngine.Rendering;
 using UnityEngine.Serialization;
-using UnityEngine.UI;
 using Random = UnityEngine.Random;

 [assembly: InternalsVisibleTo("Coffee.UIParticle.Editor")]
-[assembly: InternalsVisibleTo("Coffee.UIParticle.Editor.Tests")]
 [assembly: InternalsVisibleTo("Coffee.UIParticle.PerformanceDemo")]
 [assembly: InternalsVisibleTo("Coffee.UIParticle.Demo")]

@@ -18,11 +17,11 @@ namespace Coffee.UIExtensions
    /// <summary>
    /// Render maskable and sortable particle effect ,without Camera, RenderTexture or Canvas.
    /// </summary>
-    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
+    [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
        {
@@ -64,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.")]
@@ -125,20 +124,48 @@ namespace Coffee.UIExtensions
        [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>
@@ -324,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);
@@ -342,7 +369,7 @@ namespace Coffee.UIExtensions
                RefreshParticles();
            }

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

        /// <summary>
@@ -359,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>
@@ -371,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()
        {
        }
@@ -471,7 +512,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < _renderers.Count; i++)
            {
                var r = _renderers[i];
-                if (r == null || r.material == null) continue;
+                if (!r || !r.material) continue;
                result.Add(r.material);
            }
        }
@@ -489,7 +530,7 @@ namespace Coffee.UIExtensions
        /// </summary>
        public void SetParticleSystemInstance(GameObject instance, bool destroyOldParticles)
        {
-            if (instance == null) return;
+            if (!instance) return;

            var childCount = transform.childCount;
            for (var i = 0; i < childCount; i++)
@@ -518,7 +559,7 @@ namespace Coffee.UIExtensions
        /// </summary>
        public void SetParticleSystemPrefab(GameObject prefab)
        {
-            if (prefab == null) return;
+            if (!prefab) return;

            SetParticleSystemInstance(Instantiate(prefab.gameObject), true);
        }
@@ -538,14 +579,12 @@ namespace Coffee.UIExtensions
        /// </summary>
        private void RefreshParticles(GameObject root)
        {
-            if (root == null) return;
+            if (!root) return;
            root.GetComponentsInChildren(true, particles);
            for (var i = particles.Count - 1; 0 <= i; i--)
            {
                var ps = particles[i];
-                if (!ps
-                    || ps.gameObject.CompareTag("EditorOnly") // Ignore "EditorOnly" tagged ParticleSystems.
-                    || ps.GetComponentInParent<UIParticle>(true) != this) // Ignore ParticleSystems that are not under this UIParticle.
+                if (!ps || ps.GetComponentInParent<UIParticle>(true) != this)
                {
                    particles.RemoveAt(i);
                }
@@ -593,7 +632,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < particleSystems.Count; i++)
            {
                var ps = particleSystems[i];
-                if (ps == null) continue;
+                if (!ps) continue;

                var mainEmitter = ps.GetMainEmitter(particleSystems);
                GetRenderer(j++).Set(this, ps, false, mainEmitter);
@@ -644,7 +683,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < _renderers.Count; i++)
            {
                var r = _renderers[i];
-                if (r != null) continue;
+                if (r) continue;

                RefreshParticles(particles);
                break;
@@ -654,7 +693,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < _renderers.Count; i++)
            {
                var r = _renderers[i];
-                if (r == null) continue;
+                if (!r) continue;

                r.UpdateMesh(bakeCamera);
            }
@@ -667,23 +706,12 @@ namespace Coffee.UIExtensions
                : Random.Range(m_GroupId, m_GroupMaxId + 1);
        }

-        protected override void UpdateMaterial()
-        {
-        }
-
-        /// <summary>
-        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
-        /// </summary>
-        protected override void UpdateGeometry()
-        {
-        }
-
        private void UpdateRendererMaterial()
        {
            for (var i = 0; i < _renderers.Count; i++)
            {
                var r = _renderers[i];
-                if (r == null) continue;
+                if (!r) continue;
                r.maskable = maskable;
                r.SetMaterialDirty();
            }
@@ -696,7 +724,7 @@ namespace Coffee.UIExtensions
                _renderers.Add(UIParticleRenderer.AddRenderer(this, index));
            }

-            if (_renderers[index] == null)
+            if (!_renderers[index])
            {
                _renderers[index] = UIParticleRenderer.AddRenderer(this, index);
            }
@@ -706,13 +734,13 @@ namespace Coffee.UIExtensions

        private Camera GetBakeCamera()
        {
-            if (canvas == null) return Camera.main;
+            if (!canvas) return Camera.main;
            if (!useCustomView && canvas.renderMode != RenderMode.ScreenSpaceOverlay && canvas.rootCanvas.worldCamera)
            {
                return canvas.rootCanvas.worldCamera;
            }

-            if (_bakeCamera != null)
+            if (_bakeCamera)
            {
                _bakeCamera.orthographicSize = useCustomView ? customViewSize : 10;
                return _bakeCamera;
@@ -731,7 +759,7 @@ namespace Coffee.UIExtensions
            }

            // Create baking camera.
-            if (_bakeCamera == null)
+            if (!_bakeCamera)
            {
                var go = new GameObject("[generated] UIParticle BakingCamera");
                go.SetActive(false);
--- a/Packages/src/Runtime/UIParticleAttractor.cs
+++ b/Packages/src/Runtime/UIParticleAttractor.cs
@@ -208,7 +208,7 @@ namespace Coffee.UIExtensions

        private Vector3 GetDestinationPosition(UIParticle uiParticle, ParticleSystem particleSystem)
        {
-            var isUI = uiParticle != null && uiParticle.enabled;
+            var isUI = uiParticle && uiParticle.enabled;
            var psPos = particleSystem.transform.position;
            var attractorPos = transform.position;
            var dstPos = attractorPos;
--- a/Packages/src/Runtime/UIParticleRenderer.cs
+++ b/Packages/src/Runtime/UIParticleRenderer.cs
@@ -15,7 +15,7 @@ using UnityEngine.UI;

 namespace Coffee.UIExtensions
 {
-    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
+    [Icon("Packages/com.coffee.ui-particle/Icons/UIParticleIcon.png")]
    [ExecuteAlways]
    [RequireComponent(typeof(RectTransform))]
    [RequireComponent(typeof(CanvasRenderer))]
@@ -55,7 +55,7 @@ namespace Coffee.UIExtensions
                s_Corners[1] = transform.TransformPoint(_lastBounds.min.x, _lastBounds.max.y, 0);
                s_Corners[2] = transform.TransformPoint(_lastBounds.max.x, _lastBounds.max.y, 0);
                s_Corners[3] = transform.TransformPoint(_lastBounds.max.x, _lastBounds.min.y, 0);
-                if (canvas != null)
+                if (canvas)
                {
                    var worldToLocalMatrix = canvas.rootCanvas.transform.worldToLocalMatrix;
                    for (var i = 0; i < 4; ++i)
@@ -95,7 +95,7 @@ namespace Coffee.UIExtensions
        {
            get
            {
-                if (_materialForRendering == null)
+                if (!_materialForRendering)
                {
                    _materialForRendering = base.materialForRendering;
                }
@@ -106,7 +106,7 @@ namespace Coffee.UIExtensions

        public void Reset(int index = -1)
        {
-            if (_renderer != null)
+            if (_renderer)
            {
                _renderer.enabled = true;
            }
@@ -121,7 +121,7 @@ namespace Coffee.UIExtensions
            }

            //_emitter = null;
-            if (isActiveAndEnabled)
+            if (this && isActiveAndEnabled)
            {
                material = null;
                canvasRenderer.Clear();
@@ -140,7 +140,7 @@ namespace Coffee.UIExtensions
            base.OnEnable();

            hideFlags = UIParticleProjectSettings.globalHideFlags;
-            if (s_CombineInstances[0].mesh == null)
+            if (!s_CombineInstances[0].mesh)
            {
                s_CombineInstances[0].mesh = new Mesh
                {
@@ -283,6 +283,10 @@ namespace Coffee.UIExtensions
                || !transform.lossyScale.GetScaled(_parent.scale3DForCalc).IsVisible() // Scale is not visible.
                || (!_particleSystem.IsAlive() && !_particleSystem.isPlaying) // No particle.
                || (_isTrail && !_particleSystem.trails.enabled) // Trail, but it is not enabled.
+#if UNITY_2018_3_OR_NEWER
+                || canvasRenderer.GetInheritedAlpha() <
+                0.01f // #102: Do not bake particle system to mesh when the alpha is zero.
+#endif
            )
            {
                Profiler.BeginSample("[UIParticleRenderer] Clear Mesh");
@@ -294,24 +298,6 @@ namespace Coffee.UIExtensions
                return;
            }

-            // Reset custom data.
-            // var customData = _particleSystem.customData;
-            // if (!customData.enabled || customData.GetMode(ParticleSystemCustomData.Custom1) == ParticleSystemCustomDataMode.Disabled)
-            // {
-            //     customData.SetVector(ParticleSystemCustomData.Custom1, 0, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom1, 1, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom1, 2, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom1, 3, 0);
-            // }
-            //
-            // if (!customData.enabled || customData.GetMode(ParticleSystemCustomData.Custom2) == ParticleSystemCustomDataMode.Disabled)
-            // {
-            //     customData.SetVector(ParticleSystemCustomData.Custom2, 0, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom2, 1, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom2, 2, 0);
-            //     customData.SetVector(ParticleSystemCustomData.Custom2, 3, 0);
-            // }
-
            var main = _particleSystem.main;
            var scale = GetWorldScale();
            var psPos = _particleSystem.transform.position;
@@ -329,13 +315,6 @@ namespace Coffee.UIExtensions
 #endif
                {
                    ResolveResolutionChange(psPos, scale);
-
-                    // fix: second and subsequent bursts not displayed when world simulation and non-looping. (#326)
-                    if (!_particleSystem.IsLocalSpace() && !main.loop && _particleSystem.time == 0)
-                    {
-                        _delay = true;
-                    }
-
                    Simulate(scale, _parent.isPaused || _delay);

                    if (_delay && !_parent.isPaused)
@@ -731,7 +710,7 @@ namespace Coffee.UIExtensions
            if (s_Mpb.isEmpty) return;

            // #41: Copy the value from MaterialPropertyBlock to CanvasRenderer
-            if (materialForRendering == null) return;
+            if (!materialForRendering) return;

            for (var i = 0; i < _parent.m_AnimatableProperties.Length; i++)
            {
--- a/Packages/src/Runtime/UIParticleUpdater.cs
+++ b/Packages/src/Runtime/UIParticleUpdater.cs
@@ -16,25 +16,25 @@ namespace Coffee.UIExtensions

        public static void Register(UIParticle particle)
        {
-            if (particle == null) return;
+            if (!particle) return;
            s_ActiveParticles.Add(particle);
        }

        public static void Unregister(UIParticle particle)
        {
-            if (particle == null) return;
+            if (!particle) return;
            s_ActiveParticles.Remove(particle);
        }

        public static void Register(UIParticleAttractor attractor)
        {
-            if (attractor == null) return;
+            if (!attractor) return;
            s_ActiveAttractors.Add(attractor);
        }

        public static void Unregister(UIParticleAttractor attractor)
        {
-            if (attractor == null) return;
+            if (!attractor) return;
            s_ActiveAttractors.Remove(attractor);
        }

@@ -71,7 +71,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < s_ActiveParticles.Count; i++)
            {
                var uip = s_ActiveParticles[i];
-                if (uip == null || uip.canvas == null || !uip.isPrimary || !s_UpdatedGroupIds.Add(uip.groupId)) continue;
+                if (!uip || !uip.canvas || !uip.isPrimary || !s_UpdatedGroupIds.Add(uip.groupId)) continue;

                uip.UpdateTransformScale();
                uip.UpdateRenderers();
@@ -81,7 +81,7 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < s_ActiveParticles.Count; i++)
            {
                var uip = s_ActiveParticles[i];
-                if (uip == null || uip.canvas == null) continue;
+                if (!uip || !uip.canvas) continue;

                uip.UpdateTransformScale();

@@ -125,7 +125,7 @@ namespace Coffee.UIExtensions
                var uip = s_ActiveParticles[i];
                if (!uip.useMeshSharing || uip.groupId != groupId) continue;
                if (uip.isPrimary) return uip;
-                if (primary == null && uip.canSimulate) primary = uip;
+                if (!primary && uip.canSimulate) primary = uip;
            }

            return primary;
--- a/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
+++ b/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
@@ -13,7 +13,11 @@ namespace Coffee.UIParticleInternal
        {
            if (s_TmpParticles.Length < size)
            {
-                size = Mathf.NextPowerOfTwo(size);
+                while (s_TmpParticles.Length < size)
+                {
+                    size = Mathf.NextPowerOfTwo(size);
+                }
+
                s_TmpParticles = new ParticleSystem.Particle[size];
            }

@@ -84,11 +88,11 @@ namespace Coffee.UIParticleInternal
                var bRenderer = b.GetComponent<ParticleSystemRenderer>();

                // Render queue: ascending
-                var aMat = aRenderer.sharedMaterial != null ? aRenderer.sharedMaterial : aRenderer.trailMaterial;
-                var bMat = bRenderer.sharedMaterial != null ? bRenderer.sharedMaterial : bRenderer.trailMaterial;
-                if (aMat == null && bMat == null) return 0;
-                if (aMat == null) return -1;
-                if (bMat == null) return 1;
+                var aMat = aRenderer.sharedMaterial ? aRenderer.sharedMaterial : aRenderer.trailMaterial;
+                var bMat = bRenderer.sharedMaterial ? bRenderer.sharedMaterial : bRenderer.trailMaterial;
+                if (!aMat && !bMat) return 0;
+                if (!aMat) return -1;
+                if (!bMat) return 1;

                if (sortByMaterial)
                {
@@ -142,7 +146,7 @@ namespace Coffee.UIParticleInternal

        public static Texture2D GetTextureForSprite(this ParticleSystem self)
        {
-            if (self == null) return null;
+            if (!self) return null;

            // Get sprite's texture.
            var tsaModule = self.textureSheetAnimation;
@@ -151,7 +155,7 @@ namespace Coffee.UIParticleInternal
            for (var i = 0; i < tsaModule.spriteCount; i++)
            {
                var sprite = tsaModule.GetSprite(i);
-                if (sprite == null) continue;
+                if (!sprite) continue;

                return sprite.GetActualTexture();
            }
@@ -163,14 +167,14 @@ namespace Coffee.UIParticleInternal
        {
            foreach (var p in self)
            {
-                if (p == null) continue;
+                if (!p) continue;
                action.Invoke(p);
            }
        }

        public static ParticleSystem GetMainEmitter(this ParticleSystem self, List<ParticleSystem> list)
        {
-            if (self == null || list == null || list.Count == 0) return null;
+            if (!self || list == null || list.Count == 0) return null;

            for (var i = 0; i < list.Count; i++)
            {
@@ -183,11 +187,9 @@ namespace Coffee.UIParticleInternal

        public static bool IsSubEmitterOf(this ParticleSystem self, ParticleSystem parent)
        {
-            if (self == null || parent == null) return false;
+            if (!self || !parent) return false;

            var subEmitters = parent.subEmitters;
-            if (!subEmitters.enabled) return false; // No sub emitters.
-
            var count = subEmitters.subEmittersCount;
            for (var i = 0; i < count; i++)
            {
--- a/Packages/src/Samples~/Demo/Scripts/CopyItemOnStart.cs
+++ b/Packages/src/Samples~/Demo/Scripts/CopyItemOnStart.cs
@@ -15,7 +15,7 @@ namespace Coffee.UIExtensions.Demo

        private void Start()
        {
-            if (m_Origin == null) return;
+            if (!m_Origin) return;
            m_Origin.SetActive(false);

            var parent = m_Origin.transform.parent;
--- a/Packages/src/Samples~/Demo/Scripts/UIElementDragger.cs
+++ b/Packages/src/Samples~/Demo/Scripts/UIElementDragger.cs
@@ -42,7 +42,7 @@ public class UIElementDragger : MonoBehaviour, IBeginDragHandler, IDragHandler,
                break;
            case Target.Custom:
                _rectTransform.localPosition += delta;
-                if (m_CustomTarget != null)
+                if (m_CustomTarget)
                {
                    if (m_UseCanvasScale)
                    {
--- 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.12.1",
-  "unity": "2018.2",
+  "version": "5.0.0-preview.16",
+  "unity": "2019.3",
  "license": "MIT",
  "repository": {
    "type": "git",
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	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	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
mob-sakai	2842b3db7d	Merge branch 'develop' into develop-preview	2025-01-03 23:14: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