Release Notes Search

Added: Added AnimatableFloatChannels, AnimatableIntChannels and AnimatableObjectChannels.

Added: Added BuildAnalysisUtility.OpenWindow, which opens the Build Analysis window with a specific build selected.

Added: Added BuildHistory.TryGetParentBuild and BuildHistory.GetChildBuilds to find the build a build ran inside and the builds it ran, recorded in the new BuildReportSummary.ParentBuildSessionGUID.

Added: Added BuildSummary.projectGuid and BuildSummary.projectName, and BuildReportSummary.ProjectGUID and BuildReportSummary.ProjectName, which record the project that made a build.

Changed: BuildPipeline.BuildContentDirectory now throws an ArgumentException if the requested compression type is not supported on the target platform.

Deprecated: Deprecated ManagedStrippingLevel.Low. Passing it to PlayerSettings.SetManagedStrippingLevel now throws a NotSupportedException; use ManagedStrippingLevel.Minimal instead.

Added: Added ability to reflect information on structs, as one can with functions, from .hlsl assets.

Added: Added AnalysisResult.Skipped, which Project Auditor reports for a module that could not run in the current context.

Added: Added API to get the event that triggered the shortcut in the ShortcutArguments.

Added: Added HierarchyViewColumnDescriptor.MinWidth to set the minimum width of a custom Hierarchy column.

Added: Added SourceTemplateAttribute.Target and the SourceTemplateTargetExpression enum to the built-in JetBrains.Annotations, so source templates can use Target = SourceTemplateTargetExpression.Outer.

Added: Added the BuildProfilePlayerSettings component, so that you can create, get, and remove a build profile's own player settings with BuildProfile.CreateComponent, GetComponent, and RemoveComponent.

Added: Expose BuildProfileGraphicsSettings and BuildProfileQualitySettings as public build profile components.

Added: Project Auditor: Added Descriptor.HasAnyAreas and ReportItem.HasAnyAreas to filter issues by area, and made SerializableEnumExtensions public so IssueCategory arrays can be assigned to AnalysisParams.Categories.

Obsoleted: Output an error instead of a warning when ARCoreUpdate and ARCoreEnabled APIs are used.

Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.

Changed: EngineDiagnosticsSettings.enabled now reads and writes the Diagnostic Data Collection setting of the active build profile, or of the active platform profile if no build profile is active, and doesn't change other build profiles. To disable Diagnostic Data Collection for all users and CI, set it to Disabled in a build profile asset, commit the asset, and build with that profile by using -activeBuildProfile or BuildPipeline.BuildPlayer with BuildPlayerWithProfileOptions.

Added: Added an implicit conversion from EntityId to Entity.

Added: Added GlobalEntityManager, which reads and changes an entity in whichever world owns it, and instantiates an entity from any world into a given world.

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: Marked HierarchySearchProvider as obsolete with an error. To find entities by component, use the t: filter in the 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 StateMachine.OnDefineSubgraphStateOptions to define the options of subgraph states that reference a state machine.

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.

Deprecated: Deprecated Unsupported.useScriptableRenderPipeline because the Built-In Render Pipeline is obsolete

Added: Enabled Upscaling Framework by default.

Added: Added iPhone 18 Pro, iPhone 18 Pro Max and iPhone Duo device generation enums and screen cutouts.

Changed: PBXProject build property setters (SetBuildProperty, AddBuildProperty, UpdateBuildProperty and their ForConfig variants) now throw ArgumentNullException when given a null value.

Changed: SDKROOT, SUPPORTED_PLATFORMS, TARGETED_DEVICE_FAMILY, *_DEPLOYMENT_TARGET and ARCHS are no longer defined in the trampoline Xcode templates - the player build is now their only source. In the Swift trampoline these settings are written at project level only, so the targets inherit them.

Changed: Trampoline DisplayConnection is now created with initWithScene: and exposes a scene property; DisplayManager is keyed and subscripted by UIWindowScene instead of UIScreen. (PLAT-22932)

Added: Added MemoryLabel.Create

Added: Added Unity.Mathematics math.select overloads for bool, bool2, bool3, and bool4 values, with either a single bool or a per-component bool vector as the selection mask.

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 "PhysicsDrawOverride" in "Unity.U2D.Physics.Editor", with "enabled", "settings", "defaultSettings", "changed", the "PhysicsDrawOverride.Settings" struct and the "PhysicsDrawOverride.OverrideOptions" flags, so editor tooling can read and write the Editor draw override.

Added: Added "PhysicsHingeJoint.currentSpeed", the speed body B is currently turning relative to body A.

Added: Added "PhysicsQuery.CircleAndCapsule", "PhysicsQuery.CircleAndSegment", "PhysicsQuery.CircleAndPolygon", "PhysicsQuery.CapsuleAndSegment", "PhysicsQuery.CapsuleAndPolygon" and "PhysicsQuery.PolygonAndSegment" so every pair of geometries can be queried in either order.

Added: Added "PhysicsShape.ContactFilterModeOverride", "PhysicsShape.ContactFilterGroupModeOverride", and the "contactFilterModeOverride" and "contactFilterGroupModeOverride" properties on "PhysicsWorld" and "PhysicsWorldDefinition", so each world can choose its own contact filter modes.

Added: Added "PhysicsShape.SetBatchDefinition" to set the same definition on a batch of shapes.

Added: Added "PhysicsShape.SetCallbackTarget", "PhysicsBody.SetCallbackTarget" and "PhysicsJoint.SetCallbackTarget" to set the same callback target on a batch of objects.

Added: Added "PhysicsShape.SetPhysicsGroup" to set the same physics group on a batch of shapes.

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

Added: Added "PhysicsWorld.callbackTargetCount" to get the number of distinct callback targets in a world.

Added: Added "PhysicsWorld.disableDrawOverride" so a world always draws with its own draw settings while the Editor draw override is enabled.

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

Changed: Changed "PhysicsWorld.bounceIterations" and "PhysicsWorldDefinition.bounceIterations" to have a minimum of one, given by the new "PhysicsConstants.MinBounceIterations".

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 "PhysicsShape.ContactFilterGroupMode.Filtering" in favor of "PhysicsShape.ContactFilterGroupMode.Isolate".

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

Deprecated: Deprecated the "useScale" parameter of "PhysicsMath.GetRelativeMatrix2D", which had no effect; use the overload without it, or "PhysicsMath.GetRelativePose2D" to build a matrix with the scale you need.

Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.

Changed: EditorSettings.forceAssetUnloadAndGCOnSceneLoad has been renamed to EditorSettings.unloadUnusedAssetsOnSceneLoad and no longer forces a managed garbage collection.

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.

Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmup.WarmupShader method is now deprecated.

Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmup.WarmupShaderFromCollection method is now deprecated.

Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmupSetup struct is now deprecated.

Deprecated: UnityEngine.Shader.WarmupAllShaders method is now deprecated.

Deprecated: UnityEngine.ShaderVariantCollection.isWarmedUp property is now deprecated.

Deprecated: UnityEngine.ShaderVariantCollection.warmedUpVariantCount property is now deprecated.

Deprecated: UnityEngine.ShaderVariantCollection.WarmUp method is now deprecated.

Deprecated: UnityEngine.ShaderVariantCollection.WarmUpProgressively method is now deprecated.

Added: Enabled Upscaling Framework by default.

Added: Added TerrainData.maxHeightmapResolution, minAlphamapResolution, maxAlphamapResolution, minBaseMapResolution, maxBaseMapResolution, minDetailResolutionPerPatch and maxDetailResolutionPerPatch, the limits that the resolution setters clamp values to.

Added: Added TerrainRegion and TerrainEditUtility to sculpt heights and paint terrain layers by height and slope inside a rectangle, disc or path from scripts, and to read the heightmap samples and alphamap texels such an area covers. They are designed for authoring.

Removed: Removed the TestRunProfiler API from UnityEditor.TestTools.TestRunner.Api, which was added in an earlier 6000.7 pre-release.

Changed: Selectable.s_Selectables changed from a Selectable array to List<Selectable>.

Obsoleted: Selectable.s_SelectableCount is now obsolete. Use Selectable.allSelectableCount instead.

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

Added: Added ScrollView.touchScrollDirection to make the content move opposite to the pointer when dragged with touch or a tracked device.

Added: Added the BoxShadow and StyleBoxShadow types, and the IStyle.boxShadow and IResolvedStyle.boxShadow properties.

Added: Added the PlayerLoop.PreUpdate.UIElementsPreparePanelRenderers player loop system, which attaches PanelRenderer content to its panel before Update.

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.

Added: Enabled Upscaling Framework by default.

Deprecated: Deprecated UnityEditor.WebGLLinkerTarget and WebGLWasmArithmeticExceptions enums.

Obsoleted: Marked PlayerSettings.WebGL.memorySize as obsolete.

Added: Added GameWindow API support for Windows.

Fully enforce Sprite Frame editing capability. Overriding locks field are now removed.