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

# [5.0.0-preview.17](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.16...5.0.0-preview.17) (2026-06-08) ### Bug Fixes * add `meshCleared` flag to optimize mesh clearing ([859fa20](859fa20d29)) * add early return for case where subEmitter module is disabled ([d1386a1](d1386a1221)) * avoid endless loop ([eb2e862](eb2e862e80)), closes [#392](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/392) * fix icon ([a9461ec](a9461ecb4d)) * fix Unity6.5 compile errors and warnings ([a5ee687](a5ee687821)), closes [#400](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/400) * fix URL link in README ([a79ffb2](a79ffb2c2b)) * fix URL link in README ([1c8c65d](1c8c65d25e)), closes [#376](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/376) * fix: second and subsequent bursts not displayed when world simulation and non-looping ([df2f3ca](df2f3caafb)), closes [#326](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/326) * ignore "EditorOnly" tagged gameObjects on refresh ([031d46a](031d46a321)) * potential access to UIParticleRenderer that has already been destroyed ([b740dd6](b740dd662d)), closes [#403](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/403) * 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](38aec2ea1a)) * updated support for some changed menu paths ([f8ac986](f8ac9869f1)), closes [#397](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/397) ### Features * explicit null checks ([5384f61](5384f61c56))
chore: update release workflow
2026-06-09 20:23:46 +00:00 · 2026-06-08 18:45:42 +00:00 · 2026-06-09 03:42:57 +09:00 · 2026-06-09 03:41:03 +09:00 · 2026-03-24 17:54:06 +09:00 · 2025-12-24 20:18:34 +09:00
8 changed files with 166 additions and 157 deletions
--- 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@v6
@@ -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/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,46 +1,27 @@
-## [4.12.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.1...v4.12.2) (2026-06-08)
+# [5.0.0-preview.17](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.16...5.0.0-preview.17) (2026-06-08)


 ### Bug Fixes

 * add `meshCleared` flag to optimize mesh clearing ([859fa20](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/859fa20d297c3f44e3361f20dbb7ce966407e03e))
+* 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)
+* fix icon ([a9461ec](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9461ecb4d40d7fe878e12465d6e38faae7ae65b))
 * fix Unity6.5 compile errors and warnings ([a5ee687](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a5ee6878212be2fc4d7b48879426f239e8753009)), closes [#400](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/400)
-* potential access to UIParticleRenderer that has already been destroyed ([b740dd6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b740dd662d423c6bef849662ce1b0bfbb4940ed4)), closes [#403](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/403)
-* updated support for some changed menu paths ([f8ac986](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/f8ac9869f141238169730e74f5d65c4fc6081f51)), closes [#397](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/397)
-
-## [4.12.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.12.0...v4.12.1) (2026-03-24)
-
-
-### Bug Fixes
-
+* fix URL link in README ([a79ffb2](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a79ffb2c2b4c26f23d2925cb18674fda5d8bc9cb))
+* 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)
 * 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)
+* potential access to UIParticleRenderer that has already been destroyed ([b740dd6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b740dd662d423c6bef849662ce1b0bfbb4940ed4)), closes [#403](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/403)
+* 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))
+* updated support for some changed menu paths ([f8ac986](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/f8ac9869f141238169730e74f5d65c4fc6081f51)), closes [#397](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/397)


 ### 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
@@ -48,28 +29,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
@@ -77,6 +50,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/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");
@@ -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 -->

@@ -27,6 +27,8 @@ You can render, mask, and sort your `ParticleSystems` for UI without the need fo
    - [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)
+- [🔄 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/ParticleEffectForUGUI/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/UIParticle.cs
+++ b/Packages/src/Runtime/UIParticle.cs
@@ -3,9 +3,9 @@ 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")]
@@ -22,7 +22,7 @@ namespace Coffee.UIExtensions
    [ExecuteAlways]
    [RequireComponent(typeof(RectTransform))]
    [RequireComponent(typeof(CanvasRenderer))]
-    public class UIParticle : MaskableGraphic, ISerializationCallbackReceiver
+    public class UIParticle : UIBehaviour, ISerializationCallbackReceiver
    {
        public enum AutoScalingMode
        {
@@ -64,7 +64,7 @@ namespace Coffee.UIExtensions

        [Tooltip("Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.")]
        [SerializeField]
-        private Vector3 m_Scale3D = new Vector3(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 +125,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 +352,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 +370,7 @@ namespace Coffee.UIExtensions
                RefreshParticles();
            }

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

        /// <summary>
@@ -360,9 +388,15 @@ namespace Coffee.UIExtensions
            UIParticleUpdater.Unregister(this);
            _renderers.RemoveAll(r => r == null);
            _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>
@@ -372,6 +406,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()
        {
        }
@@ -668,17 +710,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/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.2",
-  "unity": "2018.2",
+  "version": "5.0.0-preview.17",
+  "unity": "2019.3",
  "license": "MIT",
  "repository": {
    "type": "git",
Author	SHA1	Message	Date
semantic-release-bot	cf402745f6	chore(release): 5.0.0-preview.17 [skip ci] # [5.0.0-preview.17](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/5.0.0-preview.16...5.0.0-preview.17) (2026-06-08) ### Bug Fixes * add `meshCleared` flag to optimize mesh clearing ([`859fa20`](`859fa20d29`)) * add early return for case where subEmitter module is disabled ([`d1386a1`](`d1386a1221`)) * avoid endless loop ([`eb2e862`](`eb2e862e80`)), closes [#392](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/392) * fix icon ([`a9461ec`](`a9461ecb4d`)) * fix Unity6.5 compile errors and warnings ([`a5ee687`](`a5ee687821`)), closes [#400](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/400) * fix URL link in README ([`a79ffb2`](`a79ffb2c2b`)) * fix URL link in README ([`1c8c65d`](`1c8c65d25e`)), closes [#376](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/376) * fix: second and subsequent bursts not displayed when world simulation and non-looping ([`df2f3ca`](`df2f3caafb`)), closes [#326](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/326) * ignore "EditorOnly" tagged gameObjects on refresh ([`031d46a`](`031d46a321`)) * potential access to UIParticleRenderer that has already been destroyed ([`b740dd6`](`b740dd662d`)), closes [#403](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/403) * 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`](`38aec2ea1a`)) * updated support for some changed menu paths ([`f8ac986`](`f8ac9869f1`)), closes [#397](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/397) ### Features * explicit null checks ([`5384f61`](`5384f61c56`))	2026-06-08 18:45:42 +00:00
mob-sakai	9dbd16920f	chore: update release workflow	2026-06-09 03:42:57 +09:00
mob-sakai	cc339fb3f0	Merge branch 'develop' into develop-preview # Conflicts: # .github/workflows/release.yml # Packages/src/CHANGELOG.md # Packages/src/package.json	2026-06-09 03:41:03 +09:00
mob-sakai	4f79848a7c	Merge remote-tracking branch 'origin/release' into develop-preview # Conflicts: # Packages/src/CHANGELOG.md # Packages/src/package.json	2026-03-24 17:54:06 +09:00
mob-sakai	a92d0b9280	Merge remote-tracking branch 'origin/develop' into develop-preview # Conflicts: # Packages/src/CHANGELOG.md # Packages/src/package.json	2025-12-24 20:18:34 +09:00
mob-sakai	a79ffb2c2b	fix: fix URL link in README	2025-10-14 20:58:00 +09:00
mob-sakai	37fb189d72	Merge branch 'develop' into develop-preview # Conflicts: # .github/workflows/release.yml # Packages/src/CHANGELOG.md # Packages/src/README.md # Packages/src/package.json	2025-10-14 20:55:52 +09:00
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