diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 6e2802e..9a2de65 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -10,26 +10,39 @@ 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]
+**Environment (please complete the following)**
+
+- Package version [e.g. 4.2.0, 3.3.14]
+- Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
+- Unity version: [e.g. 2021.3.7f1]
+- Project options: [e.g. Mono/IL2CPP, .Net Standard 2.1/.Net 4.x, URP/HDRP, GraphicAPIs]
**Additional context**
-Add any other context about the problem here.
+
+Please add any other context about the issue here.
+It will help us resolve the issue.
+
+- Error messages and crash dump
+- Screenshots, gif animations and movie files
+- Reproducible minimal project
+ - The entire project (zipped Assets, Packages, ProjectSettings) is preferred over `.unitypackage`
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index e55417e..8116ebe 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -10,13 +10,17 @@ 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 [...]
+
+A clear and concise description of what the issue is. (e.g. 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.
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index e963f2b..fcf03eb 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -81,4 +81,4 @@ Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcem
[homepage]: https://www.contributor-covenant.org
For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.
\ No newline at end of file
+https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.
diff --git a/LICENSE.md b/LICENSE.md
index 42d2b08..98e88c4 100644
--- a/LICENSE.md
+++ b/LICENSE.md
@@ -1,7 +1,7 @@
-Copyright 2018-2022 mob-sakai
+Copyright 2018-2023 mob-sakai
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
\ No newline at end of file
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/README.md b/README.md
index 1d0e517..999f437 100644
--- a/README.md
+++ b/README.md
@@ -2,16 +2,14 @@ Particle Effect For UGUI (UI Particle)
===
This plugin provide a component to render particle effect for uGUI in Unity 2018.2 or later.
-The particle rendering is maskable and sortable, without Camera, RenderTexture or Canvas.
+The particle rendering is maskable and sortable, without Camera, RenderTexture or Canvas.
+
[](https://openupm.com/packages/com.coffee.ui-particle/)
-[](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
+[](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
+[)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
[](https://github.com/mob-sakai/ParticleEffectForUGUI/releases) [](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/master/LICENSE.txt)
-[](http://makeapullrequest.com)
-
-
-
-
+[](http://makeapullrequest.com)
<< [Description](#Description) | [Demo](#demo) | [Installation](#installation) | [Usage](#usage) | [Development Note](#development-note) | [Change log](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/upm/CHANGELOG.md) >>
@@ -58,6 +56,8 @@ Compares this "Baking mesh" approach with the conventional approach:
* Support CanvasGroup alpha
* No allocations
* Support overlay, camera space and world space
+* Support Universal Render Pipeline (URP) and High Definition Render Pipeline (HDRP)
+* Support disabling `Enter Play Mode Options > Reload Domain`
* Support changing material property with AnimationClip (AnimatableProperty)
* [4.0.0+] Support 8+ materials
@@ -92,39 +92,41 @@ Compares this "Baking mesh" approach with the conventional approach:
### Requirement
-
-
-
-
+Unity 2018.2 or later
-### Using OpenUPM
+### Install via OpenUPM
-This package is available on [OpenUPM](https://openupm.com).
-You can install it via [openupm-cli](https://github.com/openupm/openupm-cli).
+This package is available on [OpenUPM](https://openupm.com).
+It's recommended to install it via [openupm-cli](https://github.com/openupm/openupm-cli).
```
openupm add com.coffee.ui-particle
```
-### Using Git
+### Install via Package Manager Window (using Git URL)
-Find the manifest.json file in the Packages folder of your project and add a line to `dependencies` field.
+1. Select `Window/Package Manager` menu to open `Package Manager` window.
+2. Click `+` and `Install package from git URL...`
+
+3. Input `https://github.com/mob-sakai/ParticleEffectForUGUI.git` and click `Install`
+
-* `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git"`
-
-To update the package, change suffix `#{version}` to the target version.
-
-* `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.0.0",`
Or, use [UpmGitExtension](https://github.com/mob-sakai/UpmGitExtension) to install and update the package.
-### For Unity 2018.2
+### Install via manifest.json (using Git URL)
-Unity 2018.2 supports embedded packages.
+1. Open `Packages/manifest.json` in your project.
+2. Add this line below `"dependencies": {`
+ * `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git",`
+ 
+3. To update the package, change suffix `#{version}`.
+ * `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.2.0",`
+
+### Install as an embed package
1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI/releases) page
-2. Extract it
-3. Import it under `Packages` directory in your Unity project
-
+2. Extract it and place it under `Packages` directory in your project.
+
@@ -161,17 +163,17 @@ Unity 2018.2 supports embedded packages.
`UIParticle` controls the ParticleSystems that is attached to its own game objects and child game objects.
-
+
| Properties | Description |
| -- | -- |
| Maskable | Does this graphic allow masking. |
-| Ignore Canvas Scale | Ignore the scale of the root canvas.
This prevents it from displaying small even in hierarchy scaling mode of `ParticleSystem`. |
| Scale | Scale the rendering.
When the `3D` toggle is enabled, 3D scale (x,y,z) is supported. |
| Animatable Properties | If you want update material properties (e.g. `_MainTex_ST`, `_Color`) in AnimationClip, use this to mark the changes. |
| Mesh Sharing | Particle simulation results are shared within the same group.
A large number of the same effects can be displayed with a small load.
When the `Random` toggle is enabled, it will be grouped randomaly. |
-| Absolute Mode | The particles will be emitted at the ParticleSystem position.
Move the UIParticle/ParticleSystem to move the particle. |
-| Rendering Order | The ParticleSystems to be rendered.
You can change the rendering order and the materials. |
+| Position Mode | **Absolute:** Emit from the world position of the `ParticleSystem`.
**Relative:** Emit from the scaled position of the `ParticleSystem`. |
+| Auto Scaling | Transform.lossyScale (=world scale) will be set to `(1, 1, 1)` on update.
It prevents the root-Canvas scale from affecting the hierarchy-scaled `ParticleSystem`. |
+| Rendering Order | The ParticleSystem list to be rendered.
You can change the order and the materials. |
NOTE: Press `Refresh` button to reconstruct rendering order based on children ParticleSystem's sorting order and z position.
@@ -227,7 +229,7 @@ uiParticle.Stop();
`UIParticleAttractor` attracts particles generated by the specified ParticleSystem.
-
+
| Properties | Description |
@@ -237,6 +239,7 @@ uiParticle.Stop();
| Delay Rate | Delay to start attracting.
It is a percentage of the particle's start lifetime. |
| Max Speed | Maximum speed of attracting.
If this value is too small, attracting may not be completed by the end of the lifetime and `OnAttracted` may not be called. |
| Movement | Attracting movement type. (Linear, Smooth, Sphere) |
+| Update Mode | **Normal:** Update with scaled delta time.
**Unscaled Time:** Update with unscaled delta time. |
| OnAttracted | An event called when attracting is complete (per particle). |
@@ -245,14 +248,31 @@ uiParticle.Stop();
### Shader Limitation
-UIParticles are based on UIVertex.
-Therefore, only xy components is available for each UV in the shader. (zw components will be ignored).
-So unfortunately UIParticles will not work well with some shaders.
-When using custom vertex streams, you can fill zw components with "unnecessary" data.
-https://github.com/mob-sakai/ParticleEffectForUGUI/issues/191
+The use of UI shaders is recommended.
- If you need a simple Additive shader, use the `UI/Additive` shader instead.
- If you need a simple alpha-blend shader, use the `UI/Default` shader instead.
+- If your custom shader does not work properly with UIParticle, consider creating a custom UI shader.
+
+#### Built-in shaders are not supported
+
+UIParticle does not support all built-in shaders except for `UI/Default`.
+If their use is detected, an error is displayed in the inspector.
+Use UI shaders instead.
+
+#### UV.zw components will be discarded
+
+UIParticleRenderer renders the particles based on UIVertex.
+Therefore, only xy components is available for each UV in the shader. (zw components will be discarded).
+So unfortunately UIParticles will not work well with some shaders.
+
+#### Custom vertex streams
+
+When using custom vertex streams, you can fill zw components with "unnecessary" data.
+https://github.com/mob-sakai/ParticleEffectForUGUI/issues/191
+
+
+
### Overheads
diff --git a/Samples~/Cartoon FX & War FX Demo/README.md b/Samples~/Cartoon FX & War FX Demo/README.md
index ea2781c..e51183d 100644
--- a/Samples~/Cartoon FX & War FX Demo/README.md
+++ b/Samples~/Cartoon FX & War FX Demo/README.md
@@ -1,4 +1,4 @@
Cartoon FX & War FX Demo
===
-Please import assets "Cartoon FX Free" and/or "War FX Free" from Unity asset store.
\ No newline at end of file
+Please import assets "Cartoon FX Free" and/or "War FX Free" from Unity asset store.