From e41b8c5b325c3507aa2fae91d96fb03d52c9ea6f Mon Sep 17 00:00:00 2001 From: "Simon (Darkside) Jackson" Date: Fri, 19 Jun 2026 15:46:19 +0100 Subject: [PATCH 1/4] Release V3 - take 3 :D (#525) * Add hardening to workflows --- .github/workflows/main-publish.yml | 16 +++++++++--- .github/workflows/refreshbranch.yml | 27 ++++++++++++++++++++ .github/workflows/tagrelease.yml | 27 ++++++++++++++++++++ .github/workflows/upversionandtagrelease.yml | 27 ++++++++++++++++++++ 4 files changed, 93 insertions(+), 4 deletions(-) diff --git a/.github/workflows/main-publish.yml b/.github/workflows/main-publish.yml index f667dc63..3452bc7d 100644 --- a/.github/workflows/main-publish.yml +++ b/.github/workflows/main-publish.yml @@ -57,7 +57,10 @@ jobs: secrets: inherit release-Complete: - if: ${{ always() }} + # Only succeed if no upstream release job actually failed. Skipped siblings + # (the build-types that didn't match the PR title) are tolerated; a real + # failure makes this job skip so it can no longer report a false "success". + if: ${{ !failure() && !cancelled() }} needs: [upversion-major-Package, upversion-minor-Package, upversion-patch-Package, release-Package-only] name: Release complete runs-on: ubuntu-latest @@ -67,19 +70,24 @@ jobs: # Refresh the development branch with the main publish refresh-development: - if: ${{ always() }} + # Skip if the release didn't actually complete, so we never refresh + # development from a half-finished or failed release. + if: ${{ needs.release-Complete.result == 'success' }} needs: [release-Complete] name: Refresh development branch uses: ./.github/workflows/refreshbranch.yml with: build-host: ubuntu-latest target-branch: development - source-branch: main + # The branch this release PR merged into (the trigger pins this to the + # release branch). Avoids hardcoding a branch name that doesn't exist. + source-branch: ${{ github.event.pull_request.base.ref }} secrets: inherit # Up version the development branch ready for future development upversion-development: - if: ${{ always() }} + # Only re-version development once it has been refreshed successfully. + if: ${{ needs.refresh-development.result == 'success' }} needs: [refresh-development] name: UpVersion the development branch for the next release uses: ./.github/workflows/upversionandtagrelease.yml diff --git a/.github/workflows/refreshbranch.yml b/.github/workflows/refreshbranch.yml index 129d610c..4ed0862c 100644 --- a/.github/workflows/refreshbranch.yml +++ b/.github/workflows/refreshbranch.yml @@ -29,6 +29,33 @@ jobs: echo "Build Script Version: $scriptVersion" echo "::endgroup::" shell: pwsh + - name: Validate GIT_PAT + env: + GIT_PAT: ${{ secrets.GIT_PAT }} + shell: pwsh + run: | + if ([string]::IsNullOrWhiteSpace($env:GIT_PAT)) { + Write-Error "GIT_PAT secret is empty or not set. Add a valid Personal Access Token to the repository/org secrets and re-run." + exit 1 + } + $headers = @{ + Authorization = "Bearer $env:GIT_PAT" + "User-Agent" = "uiextensions-release-preflight" + Accept = "application/vnd.github+json" + } + try { + $repo = Invoke-RestMethod -Uri "https://api.github.com/repos/$env:GITHUB_REPOSITORY" -Headers $headers -ErrorAction Stop + } + catch { + $code = if ($_.Exception.Response) { [int]$_.Exception.Response.StatusCode } else { "unknown" } + Write-Error "GIT_PAT was rejected by GitHub (HTTP $code). It is likely expired, revoked, or lacks access to $env:GITHUB_REPOSITORY. Regenerate the token and update the GIT_PAT secret. Details: $($_.Exception.Message)" + exit 1 + } + if ($null -ne $repo.permissions -and -not $repo.permissions.push) { + Write-Error "GIT_PAT authenticated but does not have push access to $env:GITHUB_REPOSITORY. Grant 'repo' (classic PAT) or Contents: read & write (fine-grained PAT)." + exit 1 + } + Write-Host "GIT_PAT validated: authenticated with push access to $env:GITHUB_REPOSITORY." - uses: actions/checkout@v7 with: ref: ${{ inputs.target-branch }} diff --git a/.github/workflows/tagrelease.yml b/.github/workflows/tagrelease.yml index 7a8d6826..38d10e03 100644 --- a/.github/workflows/tagrelease.yml +++ b/.github/workflows/tagrelease.yml @@ -29,6 +29,33 @@ jobs: echo "Build Script Version: $scriptVersion" echo "::endgroup::" shell: pwsh + - name: Validate GIT_PAT + env: + GIT_PAT: ${{ secrets.GIT_PAT }} + shell: pwsh + run: | + if ([string]::IsNullOrWhiteSpace($env:GIT_PAT)) { + Write-Error "GIT_PAT secret is empty or not set. Add a valid Personal Access Token to the repository/org secrets and re-run." + exit 1 + } + $headers = @{ + Authorization = "Bearer $env:GIT_PAT" + "User-Agent" = "uiextensions-release-preflight" + Accept = "application/vnd.github+json" + } + try { + $repo = Invoke-RestMethod -Uri "https://api.github.com/repos/$env:GITHUB_REPOSITORY" -Headers $headers -ErrorAction Stop + } + catch { + $code = if ($_.Exception.Response) { [int]$_.Exception.Response.StatusCode } else { "unknown" } + Write-Error "GIT_PAT was rejected by GitHub (HTTP $code). It is likely expired, revoked, or lacks access to $env:GITHUB_REPOSITORY. Regenerate the token and update the GIT_PAT secret. Details: $($_.Exception.Message)" + exit 1 + } + if ($null -ne $repo.permissions -and -not $repo.permissions.push) { + Write-Error "GIT_PAT authenticated but does not have push access to $env:GITHUB_REPOSITORY. Grant 'repo' (classic PAT) or Contents: read & write (fine-grained PAT)." + exit 1 + } + Write-Host "GIT_PAT validated: authenticated with push access to $env:GITHUB_REPOSITORY." - uses: actions/checkout@v7 with: fetch-depth: 0 diff --git a/.github/workflows/upversionandtagrelease.yml b/.github/workflows/upversionandtagrelease.yml index ca7ccdea..bd6732bc 100644 --- a/.github/workflows/upversionandtagrelease.yml +++ b/.github/workflows/upversionandtagrelease.yml @@ -48,6 +48,33 @@ jobs: echo "Build Script Version: $scriptVersion" echo "::endgroup::" shell: pwsh + - name: Validate GIT_PAT + env: + GIT_PAT: ${{ secrets.GIT_PAT }} + shell: pwsh + run: | + if ([string]::IsNullOrWhiteSpace($env:GIT_PAT)) { + Write-Error "GIT_PAT secret is empty or not set. Add a valid Personal Access Token to the repository/org secrets and re-run." + exit 1 + } + $headers = @{ + Authorization = "Bearer $env:GIT_PAT" + "User-Agent" = "uiextensions-release-preflight" + Accept = "application/vnd.github+json" + } + try { + $repo = Invoke-RestMethod -Uri "https://api.github.com/repos/$env:GITHUB_REPOSITORY" -Headers $headers -ErrorAction Stop + } + catch { + $code = if ($_.Exception.Response) { [int]$_.Exception.Response.StatusCode } else { "unknown" } + Write-Error "GIT_PAT was rejected by GitHub (HTTP $code). It is likely expired, revoked, or lacks access to $env:GITHUB_REPOSITORY. Regenerate the token and update the GIT_PAT secret. Details: $($_.Exception.Message)" + exit 1 + } + if ($null -ne $repo.permissions -and -not $repo.permissions.push) { + Write-Error "GIT_PAT authenticated but does not have push access to $env:GITHUB_REPOSITORY. Grant 'repo' (classic PAT) or Contents: read & write (fine-grained PAT)." + exit 1 + } + Write-Host "GIT_PAT validated: authenticated with push access to $env:GITHUB_REPOSITORY." - uses: actions/checkout@v7 with: ref: ${{ inputs.target-branch }} From 5975de7b1ccf76a9e448f1546d58cb1647e42e92 Mon Sep 17 00:00:00 2001 From: action Date: Fri, 19 Jun 2026 15:23:31 +0000 Subject: [PATCH 2/4] Auto increment pre-release version to 3.0.0 [skip ci] --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index ec166e1c..6bb5e0db 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "com.unity.uiextensions", "displayName": "Unity UI Extensions", - "version": "3.0.0-pre.1", + "version": "3.0.0", "description": "An extension project for the Unity3D UI system, all crafted and contributed by the awesome Unity community", "author": "Simon darkside Jackson <@SimonDarksideJ>", "contributors": [ From d47f838ba918bbb9b26f242bd944940a711f525f Mon Sep 17 00:00:00 2001 From: "Simon (Darkside) Jackson" Date: Fri, 19 Jun 2026 18:50:25 +0100 Subject: [PATCH 3/4] Refresh README for V3.0.0 branding [skip ci] --- CHANGELOG.md | 43 +++++ README.md | 471 +++++++++++++++++++++++++-------------------------- 2 files changed, 270 insertions(+), 244 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 83c2e7da..67b27655 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,49 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/). +## Release 3.0.0 - Unity 6, reimagined - 2026/06 + +The V3 relaunch brings **full Unity 6 support**, a refreshed brand, and the start of a two-package ecosystem — the proven uGUI library you know, now joined by a modern UI Toolkit companion. + +> **Two packages. One ecosystem.** These notes cover the **uGUI** package (`com.unity.uiextensions`). Meet its new companion: [UI Toolkit Extensions](https://github.com/Unity-UI-Extensions/com.unity.uitoolkitextensions). + +### Highlights + +- **Full Unity 6 support** — the whole library verified and updated for Unity 6, with legacy dependencies cleared out and the examples refreshed. +- **Two-package ecosystem** — the new UI Toolkit Extensions package launches alongside under the shared 3.0 banner. + +### Added + +- New control: **GridRawImage** +- New control: **UI Knob 2** (`UI_Knob2`) +- New control: **UI Segmented Circle** / Segmented Control +- New control: **UI Graphic Selector** +- UILineConnector: the pivot can now be used as the reference point when drawing lines (#490) +- UILineConnector: new "close line" option to finish a line off and fill any gaps at the end +- BoxSlider: added `SetXWithoutNotify` and `SetYWithoutNotify` + +### Changed / Fixed + +- Reorderable List: fixed a null-reference exception, and resolved element-stacking when moving elements slightly +- Scroll Snap: resolved a race condition that could raise a NaN error when lerping; made rescaling and full-screen scroll snap more resilient +- HSS/VSS: guarded against a divide-by-zero when the scroll snap has a single page; `GetCurrentPage` made more resilient +- Infinite Scroll: resolved out-of-bounds issues +- Flow Layout Group: addressed layout issues and fixed the last line overflowing the rect bounds +- UI Particle System: new "CullingMode" option to resolve unscaled delta time (#486 / #487) +- Gradient2: optimised `ModifyMesh`; fixed radial triangle add order (#384) +- ScrollRect: force `ScrollRect.content` setup (#485) +- UILineConnector: improved point-array calculation (#495); refresh on global scale change +- Layout groups now rebuild on disable/enable +- General TMPro/Text compatibility housekeeping (#477) +- Compile-flag support for Unity 6 (#493) + +### Contributors + +Huge thanks to everyone who contributed to this release: +[@SimonDarksideJ](https://github.com/SimonDarksideJ), [@bluefallsky](https://github.com/bluefallsky), [@hugoymh](https://github.com/hugoymh), [@JavierMonton](https://github.com/JavierMonton), [@Dover8](https://github.com/Dover8), [@fgrg2801](https://github.com/fgrg2801), [@Moderbord](https://github.com/Moderbord). + +----- + ## Release 2.3.2 - Rejuvenation - 2023/11/26 2023 is certainly an interesting year to keep you on your toes, and finding time to keep managing all the requests and updates that come in are taking their toll, especially for a FREE project, but nonetheless, I still do it. diff --git a/README.md b/README.md index 83221812..690e92b3 100644 --- a/README.md +++ b/README.md @@ -1,244 +1,227 @@ -# Unity UI Extensions README - -This is an extension project for the new Unity UI system which can be found at: [Unity UI Source](https://github.com/Unity-Technologies/uGUI) - -> [Check out the control demos on our Tumblr page](https://unityuiextensions.tumblr.com/) - -[![openupm](https://img.shields.io/npm/v/com.unity.uiextensions?label=openupm®istry_uri=https://package.openupm.com)](https://openupm.com/packages/com.unity.uiextensions/) -[![Publish main branch and increment version](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/main-publish.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/main-publish.yml) -[![Publish development branch on Merge](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-publish.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-publish.yml) -[![Build and test UPM packages for platforms, all branches except main](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-buildandtestupmrelease.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-buildandtestupmrelease.yml) - -## [Intro](https://unity-ui-extensions.github.io/GettingStarted) - -For more info, here's a little introduction video for the project: - -[![View Intro Video](http://img.youtube.com/vi/njoIeE4akq0/0.jpg)](http://www.youtube.com/watch?v=njoIeE4akq0 "Unity UI Extensions intro video") - -You can follow the UI Extensions team for updates and news on: - -### [Twitter - #unityuiextensions](https://twitter.com/search?q=%23unityuiextensions) / [Facebook](https://www.facebook.com/UnityUIExtensions/) / [YouTube](https://www.youtube.com/@UnityUIExtensions) - -> Ways to get in touch: -> -> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project -> - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions - ------ - -## [What is this repository for?](https://unity-ui-extensions.github.io/About) - -In this repository is a collection of extension scripts / effects and controls to enhance your Unity UI experience. These scripts have been gathered from many sources, combined and improved over time. - -> The majority of the scripts came from the Scripts thread on the [Unity UI forum here](http://bit.ly/UnityUIScriptsForumPost) - -You can either download / fork this project to access the scripts, or you can also download these pre-compiled Unity Assets, chock full of goodness for each release: - -## [Download Latest - Version 2.3](https://unity-ui-extensions.github.io/Downloads) - -We have expanded where you can download the UnityPackage asset and widened the options to contribute to the project. - -> I will still stress however, ***contribution is optional***. **The assets / code will always remain FREE** - -| [![Download from Itch.IO](https://unity-ui-extensions.github.io/SiteImages/itchio.png)](https://unityuiextensions.itch.io/uiextensions2-0 "Download from Itch.IO") | [![Download from Itch.IO](https://unity-ui-extensions.github.io/SiteImages/unionassets.png)](https://unionassets.com/unity-ui-extensions "Download from Union Assets") | [![Download from Itch.IO](https://unity-ui-extensions.github.io/SiteImages/patreon.jpg)](https://www.patreon.com/UnityUIExtensions "Support Unity UI Extensions on Patreon & download")| -| :--- | :--- | :--- | -| [Grab from Itchio](https://unityuiextensions.itch.io/uiextensions2-0) | [Obtain via Union Assets](https://unionassets.com/unity-ui-extensions) |[Support through Patreon](https://www.patreon.com/UnityUIExtensions) | - -> Still available to download on the [GitHub site](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) if you prefer - -To view previous releases, visit the [release archive](https://unity-ui-extensions.github.io/Downloads) - ------ - -## [Supporting the UI Extensions project](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ) - -If you wish to further support the Unity UI Extensions project itself, then you can either subsidize your downloads above, or using the links below. - -All funds go to support the project, no matter the amount. **Donations in code are also extremely welcome** - -|[![Donate via PayPal](https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-150px.png)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ "Donating via Paypal")|[![Buy us a Coffee](https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/5cbed8a4ae2b88347c06c923_BuyMeACoffee_blue-p-500.png)](https://ko-fi.com/uiextensions "Buy us a Coffee")| -|-|-| -||| - -> (PayPal account not required and you can remain anonymous if you wish) - ------ - -## [Getting Started](https://unity-ui-extensions.github.io/GettingStarted) - -To get started with the project, here's a little guide: - -[![View Getting Started Video](http://img.youtube.com/vi/sVLeYmsNQAI/0.jpg)](http://www.youtube.com/watch?v=sVLeYmsNQAI "Unity UI getting started video") - ------ - -## [Updates:](https://unity-ui-extensions.github.io/ReleaseNotes/RELEASENOTES) - -## Release 2.4.0 - Unity supports Unity UI - 2025/11/20 - -Stay tuned as we begin work on a Unity 6 update, to verify Unity 6 support and possibly get some new controls in the mix. - -## Release 2.3.2 - Rejuvenation - 2023/11/26 - -2023 is certainly an interesting year to keep you on your toes, and finding time to keep managing all the requests and updates that come in are taking their toll, especially for a FREE project, but nonetheless, I still do it. - -Mainly bugfixes for the end of year update, promoting some resolutions that have been verified and tested since the last release. - -To get up to speed with the Unity UI Extensions, check out the [Getting Started](https://unity-ui-extensions.github.io/GettingStarted.html) Page. - -> Ways to get in touch: -> -> - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions -> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project -> -> Much easier that posting a question / issue on YouTube, Twitter or Facebook :D - -## Breaking changes - -For customers upgrading from earlier versions of Unity to Unity 2020, please be aware of the Breaking change related to Text Based components. You will need to manually replace any UI using the older ```Text``` component and replace them with ```TextMeshPro``` versions. This is unavoidable due to Unity deprecating the Text component. - -> New users to 2022 are unaffected as all the Editor commands have been updated to use the newer TextMeshPro versions. - -For more details, see the [deprecation notice](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions/428) on GitHub. - -## Added - -- Add CalculatePointOnCurve for uilinerenderer (@victornor) - -## Changed - -- fix: Fixed an null reference exception with the ResetSelectableHighlight (@FejZa) -- fix: Resolved an issue where the last line in a flow layout group would overflow the rect bounds. -- fix: GetPosition when Segments is null (@victornor) -- fix: Fix Bug! NicerOutline color.a Loss when m_UseGraphicAlpha is true (wanliyun) -- fix: Update to force Enumerated start for Accordion elements, Resolves: #455 -- Added argument to the UpdateLayout method for the HSS/VSS to move to a new starting page. -- Updated implementations to handle 2023 support, with 2023 moving in to public release. -- Added extra event on the AutoCompleteComboBox, to fire when an item in the list is selected, with its display name. -- FlowLayoutGroup components updated to latest (likely the last as the author has stopped development) - -## Deprecated - -- All deprecated Text based components now have "obsolete" tags, to avoid breaking code. Note, these do not function in 2022 and above, as Unity have "changed" things. For any affected component, I recommend updating to use TextMeshPro native features. - -- [UI Extensions Issue log](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/issues) - -## Upgrade Notes - -We recommend using the UPM delivery method. If you are using the Unity asset, there should be no issues updating but if you have a problem, just deleted the old Unity-UI-Extensions folder and import the asset new. - ------ - -## Release History - -For the full release history, follow the below link to the full release notes page. - -### [Release Notes](https://unity-ui-extensions.github.io/ReleaseNotes/RELEASENOTES) - ------ - -## [Controls and extensions listed in this project](https://unity-ui-extensions.github.io/Controls) - -There are almost 70+ extension controls / effect and other utilities in the project which are listed on the following page: - -> ## [Check out the control demos on our Tumblr page](https://www.tumblr.com/blog/unityuiextensions) -> -> | [![UI Line Renderer](https://unity-ui-extensions.github.io/SiteImages/LineRenderer.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Line Renderer") | [![UI Knob](https://unity-ui-extensions.github.io/SiteImages/UIKnob.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Knob") | [![ScrollSnap](https://unity-ui-extensions.github.io/SiteImages/ScrollSnap.gif)](https://www.tumblr.com/blog/unityuiextensions "Scroll Snap")| -> | :--- | :--- | :--- | -> | [UI Line Renderer](https://www.tumblr.com/blog/unityuiextensions) | [UI Knob](https://www.tumblr.com/blog/unityuiextensions) |[Scroll Snap](https://www.tumblr.com/blog/unityuiextensions) | - -## [UI Extensions controls list](https://unity-ui-extensions.github.io/Controls) - -[Controls](https://unity-ui-extensions.github.io/Controls.html#controls) - -|Accordion|ColorPicker|Selection Box|UI Flippable|ComboBox| -|-|-|-|-|-| -|AutoComplete ComboBox|DropDown List|BoundToolTip|UIWindowBase|UI Knob| -|TextPic|Input Focus|Box Slider|Cooldown Button|Segmented Control| -|Stepper|Range Slider|Radial Slider|MultiTouch Scroll Rect|MinMax SLider| - -[Primitives](https://unity-ui-extensions.github.io/Controls.html#primitives) - -|UILineRenderer|UILineTextureRenderer|UICircle|DiamondGraph|UICornerCut| -|-|-|-|-|-| -|UIPolygon|UISquircle|||| - -[Layouts](https://unity-ui-extensions.github.io/Controls.html#layouts) - -|Horizontal Scroll Snap|Vertical Scroll Snap|Flow Layout Group|Radial Layout|Tile Size Fitter| -|-|-|-|-|-| -|Scroll Snap (alt implementation)|Reorderable List|UI Vertical Scroller|Curved Layout|Table Layout| -|FancyScrollView|Card UI|Scroll Position Controller (obsolete)|Content Scroll Snap Horizontal|Scroller| -|ResizePanel|RescalePanel|RescaleDragPanel||| - -[Effects](https://unity-ui-extensions.github.io/Controls.html#effect-components) - -|Best Fit Outline|Curved Text|Gradient|Gradient2|Letter Spacing| -|-|-|-|-|-| -|NicerOutline|RaycastMask|UIFlippable|UIImageCrop|SoftAlphaMask| -|CylinderText|UIParticleSystem|CurlyUI|Shine Effect|Shader Effects| - -> Text Effects are not supported with TextMeshPro due to its architecture, try using the native TextMeshPro effects instead. - -[Additional Components](https://unity-ui-extensions.github.io/Controls.html#additional-components) - -|ReturnKeyTrigger|TabNavigation|uGUITools|ScrollRectTweener|ScrollRectLinker| -|-|-|-|-|-| -|ScrollRectEx|UI_InfiniteScroll|UI_ScrollRectOcclusion|UIScrollToSelection|UISelectableExtension| -|switchToRectTransform|ScrollConflictManager|CLFZ2 (Encryption)|DragCorrector|PPIViewer| -|UI_TweenScale|UI_MagneticInfiniteScroll|UI_ScrollRectOcclusion|NonDrawingGraphic| -|UILineConnector| -|UIHighlightable|Menu Manager|Pagination Manager||| - -*More to come* - ------ - -## [How do I get set up?](https://unity-ui-extensions.github.io/UPMInstallation.html) - -The recommended way to add the Unity UI Extensions project to your solution is to use the Unity package Manager. Simply use the Unity Package Manager to reference the project to install it - -New for 2020, we have added OpenUPM support and the package can be installed using the following [OpenUPM CLI](https://openupm.com/docs/) command: - -```cli -`openupm add com.unity.uiextensions` -``` - -> For more details on using [OpenUPM CLI, check the docs here](https://github.com/openupm/openupm-cli#installation). - -- Unity Package Manager - manual - -Alternatively, you can also add the package manually through the Unity package manager using the scope ```com.unity.uiextensions```, see the [Unity Package Manager docs](https://learn.unity.com/tutorial/the-package-manager) for more information. - -- Unity 2018 or lower -The pre-compiled Unity assets are the only solution for Unity 2018 or earlier due to the changes in the Unity UI framework in Unity made for 2019. -Either clone / download this repository to your machine and then copy the scripts in, or use the pre-packaged .UnityPackage for your version of Unity and import it as a custom package in to your project. - -## [Contribution guidelines](https://unity-ui-extensions.github.io/ContributionGuidelines) - -Got a script you want added? Then just fork the [GitHub repository](https://github.com/unity-UI-Extensions/com.unity.uiextensions) and submit a PR. All contributions accepted (including fixes) - -Just ensure: - -- The header of the script should match the standard used in all scripts. -- The script uses the **Unity.UI.Extensions** namespace so they do not affect any other developments. -- (optional) Add Component and Editor options where possible. (editor options are in the Editor\UIExtensionsMenuOptions.cs file) - -## [License](https://raw.githubusercontent.com/Unity-UI-Extensions/com.unity.uiextensions/release/LICENSE.md) - -All scripts conform to the BSD-3-Clause license and are free to use / distribute. See the [LICENSE](https://raw.githubusercontent.com/Unity-UI-Extensions/com.unity.uiextensions/release/LICENSE.md) file for more information = - -## [Like what you see?](https://unity-ui-extensions.github.io/FurtherInfo) - -All these scripts were put together for my latest book Unity3D UI Essentials -Check out the [page on my blog](http://bit.ly/Unity3DUIEssentials) for more details and learn all about the inner workings of the new Unity UI System. - -## [The downloads](https://unity-ui-extensions.github.io/Downloads) - -As this repo was created to support my new Unity UI Title ["Unity 3D UI Essentials"](http://bit.ly/Unity3DUIEssentials), in the downloads section you will find two custom assets (SpaceShip-DemoScene-Start.unitypackage and RollABallSample-Start.unitypackage). These are just here as starter scenes for doing UI tasks in the book. - -I will add more sample scenes for the UI examples in this repository and detail them above over time. - -## [Previous Releases](https://unity-ui-extensions.github.io/Downloads) - -Please see the [full downloads list](https://unity-ui-extensions.github.io/Downloads) for all previous releases and their corresponding download links. +

+ + Unity UI Extensions — uGUI + +

+ +

Stop rebuilding UI from scratch

+ +

+ 100+ battle-tested uGUI controls for Unity — open source, community-driven, production-ready.
+ The controls you would build anyway, already polished and edge-case handled. +

+ +

+ 100+ controls · 21 example scenes · battle-tested since 2015 · 100% free · BSD-3-Clause +

+ +

+ openupm + Publish main branch and increment version + Publish development branch on Merge + Build and test UPM packages for platforms, all branches except main +

+ +----- + +## [Supercharge your Unity UI](https://unity-ui-extensions.github.io/ugui/) + +Unity UI Extensions is the flagship open-source UI control collection for Unity's **uGUI** system — the controls you would build anyway, already polished and edge-case handled. Gathered from many sources, combined and improved, and battle-tested by the community since 2015. + +> Built on the Unity UI system: [Unity UI Source](https://github.com/Unity-Technologies/uGUI) + +For more info, here's a little introduction video for the project: + +[![View Intro Video](http://img.youtube.com/vi/njoIeE4akq0/0.jpg)](http://www.youtube.com/watch?v=njoIeE4akq0 "Unity UI Extensions intro video") + +You can follow the UI Extensions team for updates and news on: + +### [Twitter - #unityuiextensions](https://twitter.com/search?q=%23unityuiextensions) / [Facebook](https://www.facebook.com/UnityUIExtensions/) / [YouTube](https://www.youtube.com/@UnityUIExtensions) + +> Ways to get in touch: +> +> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project +> - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions + +----- + +## [What is this repository for?](https://unity-ui-extensions.github.io/ugui/) + +In this repository is a collection of extension scripts / effects and controls to enhance your Unity UI experience. These scripts have been gathered from many sources, combined and improved over time. + +> The majority of the scripts came from the Scripts thread on the [Unity UI forum here](http://bit.ly/UnityUIScriptsForumPost) + +You can either download / fork this project to access the scripts, or you can download these pre-compiled Unity Assets, chock full of goodness for each release: + +## [Download the latest release — Version 3.0](https://unity-ui-extensions.github.io/ugui/install/) + +Prefer a ready-made package? Grab the pre-compiled UnityPackage for every release. We've widened the options to contribute to the project too. + +> I will still stress however, ***contribution is optional***. **The assets / code will always remain FREE** + +| [![Download from itch.io](https://unity-ui-extensions.github.io/SiteImages/itchio.png)](https://unityuiextensions.itch.io/uiextensions2-0 "Download from itch.io") | [![Support on Patreon](https://unity-ui-extensions.github.io/SiteImages/patreon.jpg)](https://www.patreon.com/UnityUIExtensions "Support Unity UI Extensions on Patreon & download") | +| :---: | :---: | +| [Grab it on itch.io](https://unityuiextensions.itch.io/uiextensions2-0) | [Support via Patreon](https://www.patreon.com/UnityUIExtensions) | + +> Still available to download on the [GitHub site](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) if you prefer + +To view previous releases, visit the [release archive](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) + +> ### 🎛️ Two packages. One ecosystem. +> +> This is the **uGUI** package (`com.unity.uiextensions`), for Unity's established UI system. Building with Unity 6's modern runtime UI? Meet its companion: +> +> **[UI Toolkit Extensions →](https://github.com/Unity-UI-Extensions/com.unity.uitoolkitextensions)** — a growing library of controls, components and utilities for the UI Toolkit solution. + +----- + +## [Supporting the UI Extensions project](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ) + +If you wish to further support the Unity UI Extensions project itself, then you can either subsidise your downloads above, or use the links below. + +All funds go to support the project, no matter the amount. **Donations in code are also extremely welcome.** + +|[![Donate via PayPal](https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-150px.png)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=89L8T9N6BR7LJ "Donating via Paypal")|[![Buy us a Coffee](https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/5cbed8a4ae2b88347c06c923_BuyMeACoffee_blue-p-500.png)](https://ko-fi.com/uiextensions "Buy us a Coffee")| +|-|-| +||| + +> (PayPal account not required and you can remain anonymous if you wish) + +----- + +## [Getting Started](https://unity-ui-extensions.github.io/ugui/install/) + +To get started with the project, here's a little guide: + +[![View Getting Started Video](http://img.youtube.com/vi/sVLeYmsNQAI/0.jpg)](http://www.youtube.com/watch?v=sVLeYmsNQAI "Unity UI getting started video") + +----- + +## What's new in 3.0 — Unity 6, reimagined + +The V3 relaunch brings **full Unity 6 support**, a fresh coat of paint, and the start of a two-package ecosystem. + +- **Unity 6 ready** — the whole library verified and updated for Unity 6, with legacy dependencies cleared out. +- **New controls** — GridRawImage, UI Knob 2, UI Segmented Circle and a UI Graphic Selector join the collection. +- **Battle-hardened** — fixes across Reorderable List, Scroll Snap, Infinite Scroll, Flow Layout Group, UI Particle System and more. +- **Sharper UILineConnector** — pivot reference points, closing lines and smarter point-array maths. + +> 📓 Read the full, detailed [Release Notes](https://unity-ui-extensions.github.io/ugui/releasenotes/). + +### Earlier releases + +Looking for previous versions? The complete history lives on the [Release Notes](https://unity-ui-extensions.github.io/ugui/releasenotes/) page. + +### Upgrade notes + +We recommend the UPM delivery method. If you are using the Unity asset, there should be no issues updating — but if you hit a problem, just delete the old Unity-UI-Extensions folder and import the asset fresh. + +> **Upgrading from Unity 2019 or earlier?** Text-based components were replaced with `TextMeshPro` equivalents when Unity deprecated the legacy `Text` component. See the [deprecation notice](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions/428) for details. New projects on 2022+ are unaffected. + +----- + +## [Controls and extensions listed in this project](https://unity-ui-extensions.github.io/ugui/#controls) + +There are 100+ extension controls / effects and other utilities in the project which are listed on the following page: + +> ## [Check out the control demos on our Tumblr page](https://www.tumblr.com/blog/unityuiextensions) +> +> | [![UI Line Renderer](https://unity-ui-extensions.github.io/SiteImages/LineRenderer.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Line Renderer") | [![UI Knob](https://unity-ui-extensions.github.io/SiteImages/UIKnob.gif)](https://www.tumblr.com/blog/unityuiextensions "UI Knob") | [![ScrollSnap](https://unity-ui-extensions.github.io/SiteImages/ScrollSnap.gif)](https://www.tumblr.com/blog/unityuiextensions "Scroll Snap")| +> | :--- | :--- | :--- | +> | [UI Line Renderer](https://www.tumblr.com/blog/unityuiextensions) | [UI Knob](https://www.tumblr.com/blog/unityuiextensions) |[Scroll Snap](https://www.tumblr.com/blog/unityuiextensions) | + +## [UI Extensions controls list](https://unity-ui-extensions.github.io/ugui/#controls) + +[Controls](https://unity-ui-extensions.github.io/ugui/controls/) + +|Accordion|ColorPicker|Selection Box|UI Flippable|ComboBox| +|-|-|-|-|-| +|AutoComplete ComboBox|DropDown List|BoundToolTip|UIWindowBase|UI Knob| +|TextPic|Input Focus|Box Slider|Cooldown Button|Segmented Control| +|Stepper|Range Slider|Radial Slider|MultiTouch Scroll Rect|MinMax SLider| + +[Primitives](https://unity-ui-extensions.github.io/ugui/controls/) + +|UILineRenderer|UILineTextureRenderer|UICircle|DiamondGraph|UICornerCut| +|-|-|-|-|-| +|UIPolygon|UISquircle|||| + +[Layouts](https://unity-ui-extensions.github.io/ugui/controls/) + +|Horizontal Scroll Snap|Vertical Scroll Snap|Flow Layout Group|Radial Layout|Tile Size Fitter| +|-|-|-|-|-| +|Scroll Snap (alt implementation)|Reorderable List|UI Vertical Scroller|Curved Layout|Table Layout| +|FancyScrollView|Card UI|Scroll Position Controller (obsolete)|Content Scroll Snap Horizontal|Scroller| +|ResizePanel|RescalePanel|RescaleDragPanel||| + +[Effects](https://unity-ui-extensions.github.io/ugui/controls/) + +|Best Fit Outline|Curved Text|Gradient|Gradient2|Letter Spacing| +|-|-|-|-|-| +|NicerOutline|RaycastMask|UIFlippable|UIImageCrop|SoftAlphaMask| +|CylinderText|UIParticleSystem|CurlyUI|Shine Effect|Shader Effects| + +> Text Effects are not supported with TextMeshPro due to its architecture, try using the native TextMeshPro effects instead. + +[Additional Components](https://unity-ui-extensions.github.io/ugui/controls/) + +|ReturnKeyTrigger|TabNavigation|uGUITools|ScrollRectTweener|ScrollRectLinker| +|-|-|-|-|-| +|ScrollRectEx|UI_InfiniteScroll|UI_ScrollRectOcclusion|UIScrollToSelection|UISelectableExtension| +|switchToRectTransform|ScrollConflictManager|CLFZ2 (Encryption)|DragCorrector|PPIViewer| +|UI_TweenScale|UI_MagneticInfiniteScroll|UI_ScrollRectOcclusion|NonDrawingGraphic| +|UILineConnector| +|UIHighlightable|Menu Manager|Pagination Manager||| + +*More to come* + +----- + +## [How do I get set up?](https://unity-ui-extensions.github.io/ugui/install/) + +The recommended way to add the Unity UI Extensions project to your solution is to use the Unity package Manager. Simply use the Unity Package Manager to reference the project to install it + +New for 2020, we have added OpenUPM support and the package can be installed using the following [OpenUPM CLI](https://openupm.com/docs/) command: + +```cli +`openupm add com.unity.uiextensions` +``` + +> For more details on using [OpenUPM CLI, check the docs here](https://github.com/openupm/openupm-cli#installation). + +- Unity Package Manager - manual + +Alternatively, you can also add the package manually through the Unity package manager using the scope ```com.unity.uiextensions```, see the [Unity Package Manager docs](https://learn.unity.com/tutorial/the-package-manager) for more information. + +- Unity 2018 or lower +The pre-compiled Unity assets are the only solution for Unity 2018 or earlier due to the changes in the Unity UI framework in Unity made for 2019. +Either clone / download this repository to your machine and then copy the scripts in, or use the pre-packaged .UnityPackage for your version of Unity and import it as a custom package in to your project. + +## [Contribution guidelines](https://github.com/Unity-UI-Extensions/com.unity.uiextensions) + +Got a script you want added? Then just fork the [GitHub repository](https://github.com/unity-UI-Extensions/com.unity.uiextensions) and submit a PR. All contributions accepted (including fixes) + +Just ensure: + +- The header of the script should match the standard used in all scripts. +- The script uses the **Unity.UI.Extensions** namespace so they do not affect any other developments. +- (optional) Add Component and Editor options where possible. (editor options are in the Editor\UIExtensionsMenuOptions.cs file) + +## [License](https://raw.githubusercontent.com/Unity-UI-Extensions/com.unity.uiextensions/release/LICENSE.md) + +All scripts conform to the BSD-3-Clause licence and are free to use / distribute. See the [LICENSE](https://raw.githubusercontent.com/Unity-UI-Extensions/com.unity.uiextensions/release/LICENSE.md) file for more information. + +## [Like what you see?](http://bit.ly/Unity3DUIEssentials) + +All these scripts were put together for my latest book Unity3D UI Essentials +Check out the [page on my blog](http://bit.ly/Unity3DUIEssentials) for more details and learn all about the inner workings of the new Unity UI System. + +## [The downloads](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) + +As this repo was created to support my new Unity UI Title ["Unity 3D UI Essentials"](http://bit.ly/Unity3DUIEssentials), in the downloads section you will find two custom assets (SpaceShip-DemoScene-Start.unitypackage and RollABallSample-Start.unitypackage). These are just here as starter scenes for doing UI tasks in the book. + +I will add more sample scenes for the UI examples in this repository and detail them above over time. + +## [Previous Releases](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) + +Please see the [full downloads list](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/releases) for all previous releases and their corresponding download links. From aee813a383ec74ce2d28e2d3c5c075f5c2615c88 Mon Sep 17 00:00:00 2001 From: stardust motion <44144837+StardustMotion@users.noreply.github.com> Date: Thu, 2 Jul 2026 16:57:25 +0900 Subject: [PATCH 4/4] Fixed ColorPicker's precision not working that extra space prevents ToString("F") from evaluating properly --- Runtime/Scripts/Controls/ColorPicker/ColorLabel.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Runtime/Scripts/Controls/ColorPicker/ColorLabel.cs b/Runtime/Scripts/Controls/ColorPicker/ColorLabel.cs index 20411a76..8c985691 100644 --- a/Runtime/Scripts/Controls/ColorPicker/ColorLabel.cs +++ b/Runtime/Scripts/Controls/ColorPicker/ColorLabel.cs @@ -72,9 +72,9 @@ private void UpdateValue() private string ConvertToDisplayString(float value) { if (precision > 0) - return value.ToString("f " + precision); + return value.ToString("f" + precision); else return Mathf.FloorToInt(value).ToString(); } } -} \ No newline at end of file +}