Release Notes Search

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

Removed: Deprecated HierarchyViewNodesEnumerable has been removed.

Removed: Deprecated HierarchyWindow.InitializingView has been removed.

Removed: Removed the deprecated HierarchyViewModel.HierarchyFlattned.

Added: Added SetBufferData to Raster/Unsafe command buffers and allow SetComputeBufferData for all APIs.

Obsoleted: Deprecating UnityEngine.Rendering.Pool and standarizing UnityEngine.Pool across SRP packages.

Added: Added TestRunProfiler custom spans API.

Added: Added read-only glyph metrics API to FontAsset.

Added: Added LayoutRebuilder.IsLayoutRebuildPending and LayoutGroup.IsLayoutPending() to check whether a UI element still has a pending layout rebuild.

Deprecated: Marked the PositionAsUV1, TMP_TextElement_Legacy, FaceInfo_Legacy, TMP_Glyph, TMP_Sprite, KerningPair and KerningTable classes as deprecated (with a warning). Marked the GlyphValueRecord_Legacy struct as deprecated (with a warning). Marked the EventHandle enum as deprecated (with a warning). Marked TMP_SpriteAsset.spriteInfoList as deprecated (with a warning). Marked Scrollbar.ClickRepeat(PointerEventData eventData) deprecated (with a warning).

Obsoleted: Marked the TMP_FontUtilities class as obsolete (with an error). Marked the KerningPairKey struct as obsolete (with an error). Marked the EventSystem.SetUITookitEventSystemOverride method as obsolete (with an error). Marked the Graphic.m_CachedMesh, Graphic.m_CachedUvs and Graphic.useLegacyMeshGeneration members as obsolete (with an error).

Removed: Removed BaseMeshEffect.ModifyMesh(Mesh mesh). Removed BaseRaycaster.priority property. Removed EventSystem.lastSelectedGameObject property. Removed Graphic.OnPopulateMesh(Mesh m). Removed Image.eventAlphaThreshold property. Removed InputField.onValueChange property. Removed InputField.ScreenToLocal(Vector2 screen). Removed IGraphicEnabledDisabled interface. Removed IMeshModifier.ModifyMesh(Mesh mesh). Removed Mask.OnSiblingGraphicEnabledDisabled(). Removed PointerEventData.worldPosition and PointerEventData.worldNormal properties. Removed RaycastResult.document property. Removed Selectable.allSelectables property. Removed ShaderUtilities.isInitialized and ShaderUtilities.GetShaderPropertyIDs(). Removed StandaloneInputModule.InputMode enum. Removed StandaloneInputModule.inputMode, StandaloneInputModule.allowActivationOnMobileDevice and StandaloneInputModule.forceModuleActive properties. Removed StandaloneInputModule.ForceAutoSelect(). Removed TextMeshPro.textContainer property. Removed TMP_FontAsset.fontInfo property. Removed TMP_Text.enableWordWrapping and TMP_Text.enableKerning properties. Removed TMP_Text.SetText(string sourceText, bool syncTextInputBox = true). Removed TouchInputModule class.

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 the public UnityEngine.EventCommandNames class, which provides the command name constants that the Editor sends with its command events, such as Copy, Paste, and FrameSelected.

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.

Added: Added 4 overloads for DrawProceduralIndirect that add a count parameter and an optional indirect count buffer for Multi Draw Indirect.

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: Added performance.measureUserAgentSpecificMemory to web diagnostics overlay to calculate used JS memory.

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.

URP's three internal 2D shadow shaders are merged into a single five-pass shader; no user-visible rendering change.

Updated the Android Gradle Plugin (AGP) version from 9.0.0 to 9.1.1.

Updated the Gradle version shipped with the Editor from 9.1.0 to 9.3.1.

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).

Disabled static batching by default for new projects.

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: bumped Rules package minimum version to 2.0.0.

Project Auditor: moved Domain Reload issues to Code pages.

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).

Migrate Surface Cache GI to use Ray Query instead of Ray Tracing Shaders.

Require "Raw" target for mesh vertex and index buffers. To achieve this, the "Default Mesh Buffer Target" setting should be set to "Raw" in Project Settings > Graphics.

Surface Cache global illumination now uses only the LOD level selected by the LOD Group's Global Illumination LOD, instead of every level.

Passing null to the dataType parameter in the method DataTypeStyleMapper.Register now means to not show an icon at all for a type instead of showing a default icon.

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.

N4E is now a regular editor-independent package, where previously it was built-in.

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

Changed the signature window to be more consistent and display more information about the installed package.

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.

Changed PhysicsWorld.Explode so that it no longer applies an impulse to trigger shapes by 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.

Changed the Dictionary Inspector warning about ignored entries to offer both Select First and Select All buttons when more than one entry is ignored.

Dictionary fields can now use a class or struct key, or a struct value, that contains a SerializeReference field.

Renamed the Reset to Defaults item in the Dictionary Inspector header context menu to Reset Layout, to make it clear that it restores only the drawer layout and not the dictionary contents.

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.

Added _AdditionalLightsCookieEnableBits and _AdditionalLightsLightTypes to the LightCookies CBuffer.

Allow skipping of shadow, prepass, opaque, and transparent passes when the culling/layer masks would mean nothing would be drawn.

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

Reordered the Screen Space Ambient Occlusion pass when After Opaque is enabled. In previous versions, it used to run in the BeforeRenderingTransparents point in the frame. Now it runs in the AfterRenderingOpaques point in the frame.

The _AdditionalLightsWorldToShadow and _AdditionalShadowParams shader properties are now in a persistent global constant buffer. Overriding these properties at runtime via cmd.SetGlobalMatrixArray / cmd.SetGlobalVectorArray / MaterialPropertyBlock no longer affects URP rendering; the constant buffer binding takes precedence.

Moved the "Restart VFX" shortcut from Shift+Space to Slash.

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.

Updated deprecation message for WebAssembly 2023.

DirectStorage is now enabled by default in new projects for the Windows Standalone player.

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.

Updated XR Core Utilities package to version 6.0.0 in order to match Unity version.

Updated XR Legacy Input Helpers package to version 6.0.0 in order to match Unity version.

XR Management package version updated to 6.0.0.

Fixed a case where in In 3D Editor mode, textures did not generate Sprite subassets when imported as SpriteSprite Generation.

Fixed an issue where changing the SpriteAtlas option in EditorSettings results in render artifacts.

Fixed an issue where Tilemap.tilemapPositionsChanged and tilemapTileChanged callbacks didn't invoke when SetTiles changed only the transform or color of a tile.

Fixed an issue where TilemapRenderer inherited normal maps from other Tiles when a Tile did not have a normal map.

Fixed case of Tile Palette Brush Picks overlay turning itself off in the Scene View when the user clears the search field in the overlay (for example by pressing Backspace).