Release Notes Search

Removed: Deprecated HierarchyFlattened.Hierarchy has been removed.

Removed: Deprecated HierarchyFlattenedNodeChildren has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase constructor taking a Hierarchy parameter has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.ChangesPending has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.Dispose has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.IntegrateChanges has been removed.

Removed: Deprecated HierarchyViewModel.ClearFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithAllFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithAnyFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithoutAllFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithoutAnyFlags has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAllFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAnyFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAllFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAnyFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAllFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAnyFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAllFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAnyFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.Hierarchy has been removed.

Removed: Deprecated HierarchyViewModel.HierarchyFlattned has been removed.

Removed: Deprecated HierarchyViewModel.SetFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewModel.ToggleFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewNodesEnumerable has been removed.

Removed: Deprecated HierarchyWindow.InitializingView has been removed.

Added: Added TestRunProfiler custom spans API.

Added: Added api for measuring Min-content text.

Added: Added APIs FindPanelRenderer and FindUIDocument.

Added: Added support to capture a VisualElement to a RenderTexture.

Added: Added z-index USS property support for controlling the stacking order of overlapping elements within a stacking context. Enable via Project Settings > UI Toolkit > Experimental Renderer Features > Enable Z-Index.

Added: Added UxmlSerializedDataPropertyDrawer, UxmlAttributeField, and UxmlAttributeFieldDecorator to support custom property drawers for UI Toolkit elements in the Inspector.

Added: Experimental VisualElement Components.

Changed: Added CLI args to Integration and Runtime test runners to select target browser and platform.

Removed: Removed the deprecated MovieTexture API.

Added: Added new "Maximum Size Reduction" and "Maximum Size Reduction with LTO" Code Optimization settings. When enabled this will further optimize compiled IL2CPP code as well as apply extra link time optimizations (these are distinct from LTO). Testing across multiple projects and devices showed that compared to the default "Shorter Build Time" setting, "Maximum Size Reduction" reduces code size by an average of 28.50% at the cost of 5.25% frame time performance regression.

Added Burst and Collections as dependency for com.unity.2d.tilemap package.

Changed Tilemap component data structure for better compatibility with jobs.

Refactored URP 2D shadow shaders into a consolidated multi-pass form with named passes (Self, UnshadowMark, UnshadowUnmark, ProjectedSelf, ProjectedUnshadow). Groundwork for upcoming custom-shader and ShaderGraph master node support; no user-visible rendering change.

Renamed the Sprite "Physics Shape" API and Sprite Editor tab to "Physics Outline" to avoid confusion with PhysicsCore2D's PhysicsShape. The old API is deprecated but still works and auto-upgrades.

Introducing a number of command-line arguments and environment variables related to the cache server (making it possible to disable upload and download from/to the cache server of specific types of importers).

GTK : Added Support for variable condition transition drag n drop.

GTK : Fixed an issue where the + button was not focusable.

GTK: Fixed an issue where the transition counter was off center.

Project Auditor: Added the ability to skip built-in analyzers for ones that have been migrated to the Project Auditor Rules package.

Project Auditor: new severity icons/colors.

Project Auditor: removing opt-in checkbox for Roslyn.

Removed the NetCoreRuntime from the Editor install.

Tweaked some Surface Cache quality presets.

Updated the main toolbar UX, new design for toggles and better visualization of the groups of elements.

Added an option to hide Unity-Namespaced Systems in the System window.

Added HasHierarchy tag component to TransformRef when it becomes part of a hierarchy.

Bumped the scene serialized CurrentFileFormatVersion version number because the alignment of Entity is changed to 8 bytes.

Display meta chunk entities matching queries in System window and Search window.

Entities: com.unity.charactercontroller is now embedded as a core package in Unity.

Fixed the incorrect icon for shared and chunk components in the System window.

HierarchyColor from the Subscene monobehavior is now an error-level obsolete member.

Moved the ImHex .hexpat generation used for binary debugging of .entities files, from the UNITY_DOTS_IMHEX script define to an editor preference (Entities > Debugging).

Moved mesh deformation compute shaders to from default built-in resources to built-in extra resources.

Removed un-unused UnityAot2 Hashes.

Added a -CPULightmapper=no command line switch to the Windows Editor installer that skips installing components only the CPU Progressive Lightmapper requires, currently the end-of-life Microsoft Visual C++ 2010 runtime.

Removed assertions from ToFileDescriptor.

Changed the run mode of a local player (Scenario Control / Manual Control) to be stored per developer instead of in the scenario asset, so it no longer travels with the asset in version control. Existing scenarios reset to Scenario Control the first time you open them in this version.

Unity Transport: The RoslynAnalyzerFix asset post-processor (and its assembly) have been removed from the package. This deprecated hook did not serve a purpose anymore since the analyzer was removed from the package in version 2.5.0.

Always automatically generate the NetcodeConfig singleton. This is a breaking change for any project that uses EntityManager.CreateSingleton<NetcodeConfig>() to create the singleton explicitly. You can update your code to use SystemAPI.GetSingleton<NetcodeConfig>() instead.

Added localization package 2.0. This version is designed to work with the built in localization module.

Help boxes learn more links are at the end of the text in the Package Manager window.

Marked the Analytics Library package (com.unity.analytics) as deprecated. Migrate to Unity Analytics (com.unity.services.analytics).

Updated the icons for Installed, Refresh, Installed as dependency and removed the icons for available for import, and available for download.

Changed the default value of PhysicsBodyDefinition.transformWriteMode from Off to Interpolation. Existing PhysicsCoreSettings2D assets are unaffected; only newly created assets use the new default.

Added an infobox to Build Profiles window that informs you of the new Managed Code Variants feature. This infobox can be permanently dismissed by pressing the "Dismiss" button.

Added CoreCLR runtime, .NET base class library, and managed Unity engine PDBs to the public symbol server.

Moved the Particle Shader Graph sample from the HDRP package to the Shader Graph package.

Always show the UXML document link and asset actions in the element inspector header outside the UI Stage.

AttributeOverrides are now shown as disabled during main stage authoring.

Changed the Text attribute field to 3 lines by default instead of 1 when editing in the UI Builder or Scene inspector.

Mata passes for GI no longer requires _EMISSION but checks purely from gi material flags.

Provided clear messaging that custom light probes are not fully supported in VFX Graph yet.

Further reduce the code size of Web builds using the "Disk Size" Code Optimization settings. Testing across multiple projects and devices showed that compared to the default "Shorter Build Time" setting, "Disk Size" reduced code size by an average of 8.75%, with this change the reduction is now an average of 21.35%. As always these settings are a trade-off between size and runtime performance, the same testing showed that the average frame time performance regression grows from 2.13% to 4.56% with the performance regression being reduced when LTO is enabled.

Move progressive asset loading data files to Build directory of player build output.

Windows builds now link the Visual C++ runtime dynamically instead of statically, and Unity copies the required Visual C++ runtime DLLs (such as vcruntime140.dll and msvcp140.dll) into the build output next to the executable. A new "Copy Visual C++ runtime libraries" option under Publishing Settings (on by default) lets you skip copying them if you install the redistributable another way, for example via your own installer or a distribution platform such as Steam.