Release Notes Search

Generated code for some cases of pointer arithmetic is now vectorized by Clang.

Removed un-needing boxing that can occur with the if (x is Type t) pattern.

Updated Math.Pow and MathF.Pow to match behavior of .NET.

Fixed Append being allowed when changing Symlink Sources option

iOS builds now use .NET 10 base class libraries.

Make AppDelegate and SceneDelegate methods in UnityPlayer public

Linux IL2CPP builds now use .NET 10 base class libraries.

macOS IL2CPP builds now use .NET 10 base class libraries.

Analytics for .unityPackage signature at export time, from UI, API and CLI

Improves keyboard navigation in the package manager details and toolbar

Improved the accuracy of bouncing, which is now resolved after the rest of the contact solving each simulation step.

Improved the performance of contact creation and shape queries.

Improved the PhysicsCore2D Profiler to show timing information in a consistent hierarchy which indicates not only the times taken but also where in relation to other timings they occur.

Improved native memory attribution so several kernel, plugin and file system allocations are reported against a named root instead of Unrooted in the Memory Profiler.

Replaced the Scene View orientation gizmo with a lighter UI Toolkit implementation, reducing its per-repaint cost and giving it a new flat-icon style.

Improved loading of serialized data whose layout does not match the script it belongs to: the player now logs a serialization error instead of crashing.

The editor console and shader inspector now emit warnings when invalid KEYWORD_TYPE_FLAG keywords are detected.

Added a one-time scan that lists themes affected by the theme priority change, with a report file written to Logs/ and an on-demand scan button in Project Settings > UI Toolkit.

Added a warning when a theme style sheet is imported by a regular style sheet, since the theme's priority does not apply in that case.

Added nested formats to the Smart Strings time formatter, so a nested list format can choose the separators between time units. The time formatter also accepts a DateTime or DateTimeOffset without format text.

Importing a localization table collection now warns when two of its keys hold the same ID, or when it has no shared table data.

Improved Smart Strings: plural formatting now works for languages without plural forms and for a count of two in French, conditional formats read numbers the same way in every culture, and dictionary lookups follow the case-sensitivity setting.

Improved style sheet import diagnostics: an @import placed after style rules now produces a warning explaining that its position does not affect selector priority.

Reduced the amount of memory each VisualElement uses.

Add Depth Pyramid for GTAO in URP

Reduced Editor startup time on Windows by removing an unnecessary wait for a background device-identifier lookup.

Windows IL2CPP builds now use .NET 10 base class libraries.

Graphics: Reduced CPU main thread time on URP XR Quad Views by having the inner view reuse the outer view's cached volume stack instead of re-evaluating the volume framework per stacked camera per frame.

Graphics: Reduced GPU frame time on Quad Views by reprojecting the outer pass's motion vectors into the inner pass instead of rendering its own motion vector pass.

Improved GPU performance when QuadViews are enabled in Forward/Forward+ (and when not using SpaceWarp) via reducing the amount of redundant geometry rendering in the focus-inner region during the low-resolution periphery pass.

Deprecated: Deprecated the Write Groups API

Deprecated: Deprecated the HierarchySearchProvider class. The standalone Entities Hierarchy window has been replaced by the integrated Editor Hierarchy window.

Obsoleted: Obsoleted Unity.Assertions.Assert in favour of UnityEngine.Assertions.Assert, which it forwarded to. The API Updater converts existing uses.

Removed: Removed the Entities Journaling window and the EntitiesJournaling API, deprecated in Unity 6.5; use the IDebugOnAdded and IDebugOnRemoved component lifecycle callbacks instead.

Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).

Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).

Deprecated: LightingSettings.lightmapper is now deprecated. The lightmapper in use is determined by the Default Light Baker setting in the Graphics settings (UnityEditor.Rendering.EditorGraphicsSettings.defaultLightBaker).

Obsoleted: LightingSettings.Lightmapper.ProgressiveCPU now produces a compiler error; use LightingSettings.Lightmapper.ProgressiveGPU or LightingSettings.Lightmapper.UnityComputeGPU instead.

Added: Added Graphics.disableDepthAndStencilBuffers, a read-only property that returns whether Disable Depth and Stencil Buffers is enabled in Player Settings.

Added: Added SystemInfo.supportsPrecompiledGraphicsStateStats, which reports whether the current graphics device can return precompiled graphics state statistics. It is false on every graphics device that does not expose them, and the statistics are all zero in that case.

Added: Added UnityEngine.Rendering.PrecompiledGraphicsState.GetStats, which returns statistics of the precompiled graphics states usage for the current graphics device (if supported).

Deprecated: Deprecated the C# APIs associated with Baked Occlusion Culling. They continue to work but now produce compiler warnings and will be removed in a future release. Consider migrating to GPU Occlusion Culling where supported.

Deprecated: Deprecated the OcclusionArea and OcclusionPortal component APIs. They continue to work but will be removed in a future release. Consider migrating to GPU Occlusion Culling where supported.

Added: Added LicensingUtility.HasPro, HasEduLicense, IsPersonal, and GetAuthToken, which replace the deprecated license helpers on UnityEditorInternal.InternalEditorUtility.

Added: EntitlementGroupInfo.TryGetExpirationUtc (not yet used, except in tests) for reading an entitlement group's expiry as a DateTime.

Changed: Moved the licensing API from the UnityEditor.Experimental.Licensing namespace to UnityEditor.Licensing. Existing code is updated automatically when the project is imported.

Deprecated: Deprecated the license helper methods on UnityEditorInternal.InternalEditorUtility.

Removed: Removed UnityEditorInternal.InternalEditorUtility.GetLicenseFlags, which already produced a compile error when used.

Added: Added "currentSpringForce" to "PhysicsDistanceJoint", "PhysicsSliderJoint" and "PhysicsWheelJoint", and "currentSpringTorque" to "PhysicsHingeJoint".

Added: Added "origin" overloads to the cast queries "PhysicsWorld.CastShape", "PhysicsWorld.CastShapeProxy" and "PhysicsWorld.CastGeometry", so the cast geometry can be authored in a local frame and positioned by a world-space point.

Added: Added "origin" overloads to the overlap queries "PhysicsWorld.TestOverlapShape", "PhysicsWorld.OverlapShape", "PhysicsWorld.TestOverlapShapeProxy", "PhysicsWorld.OverlapShapeProxy", "PhysicsWorld.TestOverlapGeometry" and "PhysicsWorld.OverlapGeometry", matching the cast queries.

Added: Added "PhysicsBody.drawDepth" and "PhysicsBody.SetDrawDepth3D()" to set the depth a body is drawn at when it has no transform object.

Added: Added "PhysicsBodyDefinition.drawTarget" and "PhysicsBodyDefinition.drawDepth" so a body can be created with its draw target and draw depth.

Added: Added "PhysicsConstants.MaxBounceIterations" and "PhysicsConstants.MinMaximumLinearSpeed".

Added: Added "PhysicsWorld.bounceIterations", "PhysicsWorld.bouncePropagation" and the matching "PhysicsWorldDefinition" properties, to control how bounces are resolved.

Added: Added "WorldProfile.bounceImpulses", also shown in the 2D Physics Profiler module.

Changed: The batch and span setters on "PhysicsBody", "PhysicsShape" and "PhysicsJoint", along with "PhysicsWorld.Simulate", "PhysicsWorld.DrawShapes", "PhysicsSpace.SetBatchProxyAABB" and "PhysicsSpace.SetBatchProxyCategories", now return the number of items ignored because they were invalid and log a single warning when any are ignored.

Deprecated: Deprecated "PhysicsWorld.elementDepth" and "PhysicsWorld.SetElementDepth3D()" in favor of "PhysicsWorld.drawDepth" and "PhysicsWorld.SetDrawDepth3D()". The old names upgrade automatically.

Changed: Changed SerializedProperty.numericType to report the underlying integer width instead of Unknown for FileSize, Type*, and EntityId fields.

Changed: Changed SerializedProperty.propertyType to report Integer instead of Generic for fields whose serialized type is FileSize or Type*.

Added: Exposed additional resource binding information for shader compilation results.

Added: Added LocalizedFontAsset, a localized reference to a FontAsset that lets UI Toolkit text change font with the locale.

Added: Added IFormattingExtensionsToggle to Smart Strings, which lets a source skip formatter extensions for the placeholder it resolved.

Added: Added ParserSettings.SelectorCharFilter and SelectorFilterType to Smart Strings. Set the filter to VisualUnicodeChars to use characters from any script in a selector.

Added: Added PluralRules.RestoreDefault to Smart Strings, which restores the built-in pluralization rules.

Removed support for Mono-based Android players

Renamed the "Build App Bundle (Google Play)" build setting to "Build App Bundle".

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

Removed support for x64 and Universal Simulator architectures.

Asset Import: Changed how Unity picks an asset's main object, so that objects an AssetPostprocessor adds with AddObjectToAsset no longer replaces the object the importer produces. To make an added object the main object, call AssetImportContext.SetMainObject in the postprocessor. Unity reimports all assets the first time you open an existing project, and some assets might have a different main object afterwards. Refer to the Unity 7.0 upgrade guide.

Updated the asset import pipeline, so Unity reimports all assets in a project the first time you open it in this version of the Editor.

IProcessSceneWithReport and PostProcessSceneAttribute APIs are deprecated. Use AssetPostprocessor.OnProcessScene instead so that AssetImportContext and its built-in dependencies registration is available to better support incremental builds.

bee_backend now requires glibc >= 2.35 on linux (ubuntu 22.04 or later)

Burst now compiles macOS players for Apple Silicon only, and the Burst AOT Settings no longer offer x64 CPU architectures for macOS.

Structs with auto-layout can now be used in Burst as long as they are not a part of a method's signature or a job's struct. This allows tuples to be used in structs that don't cross the managed-native barrier again.

Update the native Selection API to use ObjectPtr instead of ObjectRef.

Removed experimental label from CoreCLR

Changed the Editor preferences folder to Editor-7.x, which is seeded on first launch by copying the existing Editor-5.x folder so that earlier Editor versions keep their own preferences.

Changed the Project Auditor Suppressed Issues preference to also accept spaces as a delimiter between issue IDs, in addition to commas and semicolons.

Changing the Editor theme, Editor font, Editor language to now prompts for restart the Editor.

Removed macOS x64 Editor and Player support.

Removed support for Mono-based Editor

The macOS character palette shortcut now only opens the palette while a text field is being edited.

Remove the obsolete HierarchyColor field in Subscene

Removed the Progressive CPU Lightmapper and the Lightmapper dropdown from the Lighting window; the lightmapper now follows the Default Light Baker setting in the Graphics settings, and scenes that used the Progressive CPU Lightmapper are automatically upgraded to the Progressive GPU Lightmapper.

Surface Cache Global Illumination debug views are now displayed as a resizable Rendering Debugger overlay and no longer replace the scene's global illumination.

Added an error banner in the main window if the project is using Built-in Render Pipeline

Changed AsyncGPUReadback to reject a readback whose destination NativeArray is still in use by a running job, and report the error through the callback instead of proceeding.

Deprecated the Baked Occlusion Culling authoring workflow in the Editor. New projects no longer expose its authoring UI, while existing projects retain the workflow and baked data and display a deprecation notice. Consider migrating to GPU Occlusion Culling where supported.

Disabled Built-in Render Pipeline rendering paths, render black instead.

Removed a warning displayed at build time in specific XR setup that is breaking build determinism for Content Directory builds.

Remove public keyword from topMostController variable as it is not part of public API

Removed support for x64 and Universal Simulator architectures.

Changed NativeList and UnsafeList to preserve only the first Length elements when capacity grows. Data written beyond Length through the raw pointer is no longer retained across a reallocation.

Removed the license type from the Unity Editor window title on Linux, so that it matches the window title on macOS and Windows.

Removed UnityWebRequest.enableProfilerBodyCapture. The Web Requests Profiler module now captures request and response bodies whenever the Profiler is recording, so there is no longer a setting to turn on. Remove any assignment to this property; no replacement is needed.

NGO (com.unity.netcode.gameobjects) package was updated in the editor manifest to newest major version (3.0.0).

The content of com.unity.collections has been moved to an engine module, and the package is just a shim with typeforwarders, so it no longer has any dependencies. If you were relying on it having them, you'll need to depend on them yourself explicitly (most notably, com.unity.test-framework).

PerformanceTestRunInfo.json and PerformanceTestRunSettings.json are no longer generated during player builds that do not include test assemblies, as they are only read by performance tests running inside the player. Stale files left behind by an aborted test build are removed before such builds instead of being included in them.

"ManifoldPoint.normalVelocity" is now only guaranteed to be measured when the shape is bouncy or hit events are enabled, and can read zero otherwise.