feat: external time controller

.github/workflows/release.yml

@@ -27,10 +27,10 @@ jobs:
       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
@@ -67,7 +67,7 @@ jobs:
       contents: write
     steps:
       - name: 🚚 Checkout (${{ needs.release.outputs.merge_to }})
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           ref: ${{ needs.release.outputs.merge_to }}
           fetch-depth: 0
@@ -88,7 +88,7 @@ jobs:
       contents: write
     steps:
       - name: 🚚 Checkout (${{ needs.release.outputs.tag }})
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           ref: ${{ needs.release.outputs.tag }}
           fetch-depth: 0

.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 merge origin/${{ github.event.pull_request.base.ref }} --no-edit
-          git log --oneline -n 10
 
       - name: 📥 Cache library
         uses: actions/cache@v4
         with:
-          path: ${{ env.PROJECT_PATH }}/Library
+          path: Library
-          key: ${{ env.PROJECT_PATH }}-Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
+          key: Library-${{ matrix.unityVersion }}-${{ github.event.pull_request.head.sha || github.sha }}
           restore-keys: |
-            ${{ env.PROJECT_PATH }}-Library-${{ matrix.unityVersion }}-
+            Library-${{ matrix.unityVersion }}-
-            ${{ env.PROJECT_PATH }}-Library-
+            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 }}

Assets/ProjectSettings/NanoMonitor.asset

@@ -18,12 +18,11 @@ MonoBehaviour:
   m_EnabledInEditor: 1
   m_AlwaysIncludeAssembly: 1
   m_InstantiateOnLoad: 1
-  m_Prefab: {fileID: 4567906826058368312, guid: 7cebff2d255b9433cbe23b243c193329,
+  m_Prefab: {fileID: 7211429669315726685, guid: b73940fc30a2f4eb9a73783e9c1f8da6,
     type: 3}
   m_Interval: 0.5
   m_Anchor: 0
   m_Width: 750
-  m_HelpUrl: https://github.com/mob-sakai/ParticleEffectForUGUI
   m_CustomMonitorItems:
   - m_Format: Screen:{0}x{1}
     m_Arg0:

Assets/ProjectSettings/NanoMonitor.prefab.meta

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

Assets/ProjectSettings/UIParticle.asset

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

Assets/ProjectSettings/UIParticle.asset.meta

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

Packages/packages-lock.json

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

Packages/src/CHANGELOG.md

@@ -1,35 +1,3 @@
-## [4.11.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.2...v4.11.3) (2025-10-14)
-
-
-### Bug Fixes
-
-* fix icon ([a9461ec](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9461ecb4d40d7fe878e12465d6e38faae7ae65b))
-* fix URL link in README ([1c8c65d](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1c8c65d25e7f6fe7b1d20da4461333df8fc7578e)), closes [#376](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/376)
-* fix: second and subsequent bursts not displayed when world simulation and non-looping ([df2f3ca](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/df2f3caafbe279f1457d74f8183cb561ac14aa17)), closes [#326](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/326)
-* UIParticle in canvas with 0f-0.01f alpha value does not start to play until alpha value is greater than 0.01f, causes play calls to be delayed unintentionally if canvas alpha value is set to mentioned value range ([38aec2e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/38aec2ea1afd77677d629c86665a3342d92e49d9))
-
-## [4.11.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.1...v4.11.2) (2025-03-15)
-
-
-### Bug Fixes
-
-* IL2CPP build fails on older versions of Unity ([0da6525](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0da652520cd165b43de7404c0b0ab1fbcf9349d1))
-* NRE on enable ([0cff50e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0cff50ef696aa53fb7c46a9a737b7cf3a05b7b9b)), closes [#359](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/359)
-
-## [4.11.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.11.0...v4.11.1) (2025-02-21)
-
-
-### Bug Fixes
-
-* component icons will no longer be displayed in the scene view ([6dfbdae](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/6dfbdae38d3822ab9c2c6f0e4ca1ca32ee98a239))
-
-# [4.11.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.10.7...v4.11.0) (2025-02-21)
-
-
-### Features
-
-* add '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)
 
 

Packages/src/Editor/UIParticleEditor.cs

@@ -62,7 +62,6 @@ namespace Coffee.UIExtensions
         private SerializedProperty _autoScalingMode;
         private SerializedProperty _useCustomView;
         private SerializedProperty _customViewSize;
-        private SerializedProperty _timeScaleMultiplier;
         private ReorderableList _ro;
         private bool _showMax;
         private bool _is3DScaleMode;
@@ -101,7 +100,6 @@ namespace Coffee.UIExtensions
             _autoScalingMode = serializedObject.FindProperty("m_AutoScalingMode");
             _useCustomView = serializedObject.FindProperty("m_UseCustomView");
             _customViewSize = serializedObject.FindProperty("m_CustomViewSize");
-            _timeScaleMultiplier = serializedObject.FindProperty("m_TimeScaleMultiplier");
 
             var sp = serializedObject.FindProperty("m_Particles");
             _ro = new ReorderableList(sp.serializedObject, sp, true, true, true, true)
@@ -246,9 +244,6 @@ namespace Coffee.UIExtensions
                 _customViewSize.floatValue = Mathf.Max(0.1f, _customViewSize.floatValue);
             }
 
-            // Time Scale Multiplier
-            EditorGUILayout.PropertyField(_timeScaleMultiplier);
-
             // Target ParticleSystems.
             EditorGUI.BeginChangeCheck();
             _ro.DoLayoutList();

Packages/src/Icons.meta

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

Packages/src/README.md

@@ -144,7 +144,7 @@ _This package requires **Unity 2018.3 or later**._
 
 #### Install as Embedded Package
 
-1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI/releases) and extract it.
+1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI.git/releases) and extract it.
 2. Place it in your project's `Packages` directory.  
    ![](https://github.com/mob-sakai/mob-sakai/assets/12690315/0b7484b4-5fca-43b0-a9ef-e5dbd99bcdb4)
 - If you want to fix bugs or add features, install it as an embedded package.
@@ -158,7 +158,7 @@ _This package requires **Unity 2018.3 or later**._
 
 `UIParticle` controls the ParticleSystems that are attached to its own game objects and child game objects.
 
-![](https://github.com/user-attachments/assets/bc9eb783-afce-4102-ac61-aee9ea8d6f2f)
+![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/1cf5753b-33fc-4cef-91c3-413c515a954f)
 
 - **Maskable**: Does this graphic allow maskable.
 - **Scale**: Scale the rendering particles. When the `3D` toggle is enabled, 3D scale (x, y, z) is supported.
@@ -180,7 +180,6 @@ _This package requires **Unity 2018.3 or later**._
   - **UIParticle:** UIParticle.scale will be adjusted.
 - **Use Custom View:** Use this if the particles are not displayed correctly due to min/max particle size.
   - **Custom view size:** Change the bake view size.
-- **Time Scale Multiplier:** Time scale multiplier.
 - **Rendering Order**: The ParticleSystem list to be rendered. You can change the order and the materials.
 
 **NOTE:** Press the `Refresh` button to reconstruct the rendering order based on children ParticleSystem's sorting order
@@ -211,7 +210,7 @@ and z-position.
 If you want to mask particles, set a stencil-supported shader (such as `UI/UIAdditive`) to the material for
 ParticleSystem.
 If you use some custom shaders, see
-the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-mask-and-rectmask2d-component)
+the [How to Make a Custom Shader to Support Mask/RectMask2D Component](#how-to-make-a-custom-shader-to-support-maskrectmask2d-component)
 section.
 
 ![](https://user-images.githubusercontent.com/12690315/95017591-3b512700-0695-11eb-864e-04166ea1809a.png)

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

@@ -204,7 +204,7 @@ namespace Coffee.UIParticleInternal
             target.enabled = false;
 
             // Find MonoScript of the specified component.
-            foreach (var script in MonoImporter.GetAllRuntimeMonoScripts())
+            foreach (var script in Resources.FindObjectsOfTypeAll<MonoScript>())
             {
                 if (script.GetClass() != typeof(T))
                 {

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

@@ -3,16 +3,11 @@ using System.Diagnostics;
 using UnityEditor;
 using UnityEngine;
 using Object = UnityEngine.Object;
-#if UNITY_EDITOR
+#if UNITY_EDITOR && UNITY_2021_2_OR_NEWER
-using System.IO;
-using System.Linq;
-using System.Reflection;
-#if UNITY_2021_2_OR_NEWER
 using UnityEditor.SceneManagement;
-#else
+#elif UNITY_EDITOR
 using UnityEditor.Experimental.SceneManagement;
 #endif
-#endif
 
 namespace Coffee.UIParticleInternal
 {
@@ -77,56 +72,5 @@ namespace Coffee.UIParticleInternal
 
         public static bool isBatchOrBuilding => Application.isBatchMode || BuildPipeline.isBuildingPlayer;
 #endif
-
-        [Conditional("UNITY_EDITOR")]
-        public static void QueuePlayerLoopUpdate()
-        {
-#if UNITY_EDITOR
-            if (!EditorApplication.isPlaying)
-            {
-                EditorApplication.QueuePlayerLoopUpdate();
     }
-#endif
-        }
-    }
-
-#if !UNITY_2021_2_OR_NEWER
-    [AttributeUsage(AttributeTargets.Class)]
-    [Conditional("UNITY_EDITOR")]
-    internal class IconAttribute : Attribute
-    {
-        private readonly string _path;
-
-        public IconAttribute(string path)
-        {
-            _path = path;
-        }
-
-#if UNITY_EDITOR
-        private static Action<Object, Texture2D> s_SetIconForObject = typeof(EditorGUIUtility)
-            .GetMethod("SetIconForObject", BindingFlags.Static | BindingFlags.NonPublic)
-            .CreateDelegate(typeof(Action<Object, Texture2D>), null) as Action<Object, Texture2D>;
-
-        [InitializeOnLoadMethod]
-        private static void InitializeOnLoadMethod()
-        {
-            if (Misc.isBatchOrBuilding) return;
-
-            var types = TypeCache.GetTypesWithAttribute<IconAttribute>();
-            var scripts = MonoImporter.GetAllRuntimeMonoScripts();
-            foreach (var type in types)
-            {
-                var script = scripts.FirstOrDefault(x => x.GetClass() == type);
-                if (!script) continue;
-
-                var path = type.GetCustomAttribute<IconAttribute>()?._path;
-                var icon = AssetDatabase.LoadAssetAtPath<Texture2D>(path);
-                if (!icon) continue;
-
-                s_SetIconForObject(script, icon);
-            }
-        }
-#endif
-    }
-#endif
 }

Packages/src/Runtime/UIParticle.cs

@@ -17,7 +17,6 @@ namespace Coffee.UIExtensions
     /// <summary>
     /// Render maskable and sortable particle effect ,without Camera, RenderTexture or Canvas.
     /// </summary>
-    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
@@ -120,10 +119,6 @@ namespace Coffee.UIExtensions
                  "Change the bake view size.")]
         private float m_CustomViewSize = 10;
 
-        [SerializeField]
-        [Tooltip("Time scale multiplier.")]
-        private float m_TimeScaleMultiplier = 1;
-
         private readonly List<UIParticleRenderer> _renderers = new List<UIParticleRenderer>();
         private Camera _bakeCamera;
         private int _groupId;
@@ -262,15 +257,6 @@ namespace Coffee.UIExtensions
             set => m_CustomViewSize = Mathf.Max(0.1f, value);
         }
 
-        /// <summary>
-        /// Time scale multiplier.
-        /// </summary>
-        public float timeScaleMultiplier
-        {
-            get => m_TimeScaleMultiplier;
-            set => m_TimeScaleMultiplier = value;
-        }
-
         internal bool useMeshSharing => m_MeshSharing != MeshSharing.None;
 
         internal bool isPrimary =>

Packages/src/Runtime/UIParticle.cs.meta

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

Packages/src/Runtime/UIParticleRenderer.cs

@@ -15,7 +15,6 @@ using UnityEngine.UI;
 
 namespace Coffee.UIExtensions
 {
-    [Icon("Packages/com.coffee.ui-particle/Editor/UIParticleIcon.png")]
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
@@ -283,6 +282,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");
@@ -311,13 +314,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)
@@ -630,9 +626,8 @@ namespace Coffee.UIExtensions
             var deltaTime = paused
                 ? 0
                 : main.useUnscaledTime
-                    ? Time.unscaledDeltaTime
+                    ? 0
                     : Time.deltaTime;
-            deltaTime *= _parent.timeScaleMultiplier;
 
             // Pre-warm:
             if (0 < deltaTime && _preWarm)

Packages/src/Runtime/UIParticleRenderer.cs.meta

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

Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs

@@ -187,8 +187,6 @@ namespace Coffee.UIParticleInternal
 
         public static bool IsSubEmitterOf(this ParticleSystem self, ParticleSystem parent)
         {
-            if (!self || !parent) return false;
-
             var subEmitters = parent.subEmitters;
             var count = subEmitters.subEmittersCount;
             for (var i = 0; i < count; i++)

Packages/src/package.json

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