Release Notes Search

Added: Added a selectedDrawing property to PhysicsBody, PhysicsShape and PhysicsJoint, batch SetSelectedDrawing methods, and PhysicsWorld.ClearDrawSelected, so individual objects can be drawn persistently when the world is drawn.

Added: Added a static PhysicsWorld.DrawShapes method that draws a span of shapes into their worlds.

Added: Added an autoAxis option to the slider and wheel joint definitions that derives the joint axis from the joint anchors when the joint is created.

Added: Added an extension method to "NativeArray<T>" of "Filter()", providing a lazy, allocation-free, Burst-compatible filtered view over physics result arrays (object creation, queries, events, and other operations). We've added a "IPhysicsResultFilter<T>" and "PhysicsResultEnumerable<T, TFilter>" to allow custom filter methods to be used.

Added: Added an owner key overload to PhysicsShape "DestroyBatch()", PhysicsBody "DestroyBatch()", and PhysicsJoint "DestroyBatch()", plus their PhysicsWorld "DestroyShapeBatch()"/"DestroyBodyBatch()"/"DestroyJointBatch()" equivalents.

Added: Added an owner overload to PhysicsShape "CreateShapeBatch()" and PhysicsBody "CreateBatch()", plus the PhysicsWorld "CreateBodyBatch()" equivalent.

Added: Added batch setters for user data, owner user data, contact filter and surface material on PhysicsShape, PhysicsBody and PhysicsJoint.

Added: Added the PhysicsCallbacks.IPreContactCallback and PhysicsCallbacks.IPreContinuousCallback interfaces for physics shapes, replacing PhysicsCallbacks.IPreSolveCallback which is now deprecated. IPreContactCallback reports a contact before it is solved and gives you the full contact manifold to modify or cancel. IPreContinuousCallback reports a fast moving shape that is about to be stopped short of another shape, and lets you decide whether to stop it. IPreSolveCallback previously reported both of these situations through a single callback. The per shape option that enables them is now called Pre Contact Callbacks.

Added: Added autoAnchorA and autoAnchorB properties to PhysicsJoint and PhysicsJointDefinition.

Added: Added autoDistance property to PhysicsDistanceJoint and PhysicsDistanceJointDefinition.

Added: Added PhysicsWorld.drawAtTransform and PhysicsWorldDefinition.drawAtTransform to draw bodies, shapes, and joints at their assigned Transform's pose instead of their simulated physics pose.

Added: Added PhysicsWorld.ExplosionDefinition.useTriggers to control whether an explosion applies an impulse to trigger shapes.

Added: Added PhysicsWorld.minEdgeLength, PhysicsWorld.minPolygonEdgeLength, and PhysicsWorld.minPolygonCollinearDistance to expose geometry validity thresholds, and an areEdgesValid property to SegmentGeometry, CapsuleGeometry, ChainSegmentGeometry, and PolygonGeometry to check a geometry's edges against them.

Added: Added PhysicsWorld.stateHash, which returns a hash of the current state of the world. Use it to compare the state of two worlds, for example when checking that a simulation is deterministic. The value is recalculated over the whole world each time you read it, so avoid reading it every frame.

Added: Added PhysicsWorld SetName() and GetName() methods to allow assigning of a 64 character name to help with world identity during debugging.

Added: Added pointA and pointB to the physics contact manifold point, which give the contact point on each shape in world space. The existing point property is now deprecated because the two new properties replace it.

Added: Added: "PhysicsMath.TryGetRelativeMatrix2D()" and "PhysicsMath.TryGetPlaneMatrix2D()", which compute a 2D relative transform without ever returning a NaN result for a degenerate or flattened scale. These are often required when authoring components and help calculate relative transformation between two in a Transform hierarchy.

Added: Added: PhysicsBody, PhysicsShape and PhysicsJoint now each have a "drawTarget" property, selecting which Unity editor views (Scene view, Game view or both) the object is drawn into when the world is drawn.

Deprecated: Deprecated the PhysicsCallbacks.IPreSolveCallback interface. It reported both an existing contact and a predicted stop for a fast moving shape through a single callback, so it is replaced by PhysicsCallbacks.IPreContactCallback and PhysicsCallbacks.IPreContinuousCallback, one for each situation. The deprecated interface keeps working and still reports both, and a shape only uses it where the matching new interface is not implemented, so you can move over one at a time.

Deprecated: Deprecated PhysicsWorld.WorldProfile.applyBounciness; bounciness is no longer a separate solver stage so it always reads as zero.

Obsoleted: Removed PhysicsWorld and PhysicsWorldDefinition autoContactCallbacks and autoTriggerCallbacks properties as they are no longer required or used. The contact and trigger events are effectively free now and production of such events is still controlled on a per-shape basis so no behaviour has been lost.

Obsoleted: Obsoleted Playable APIs Playable.SetDelay, Playable.GetDelay, as well as Playable.SetPlayState. The delay functionality can be implemented manually via ScriptPlayables, either by inserting a new playable in the chain which implements the delay, or by modifying the parent playable to handle the delay.

Changed: Added an optional Display Name property to ProfilerCounterDescriptor for improved readability.

Added: Implemented visibility, focus and resizability APIs for Windowing.

Added: Implemented window focus, visibility, and destruction event system APIs in Windowing.

Added: Added CoreCLR ScriptingImplementation enum value exposing CoreCLR player support.

Added: Added the IVariantSelector interface, which you can implement to define custom variants for the localization system.

Added: New public API, Detach(node) and DetachChildren(node) on Hierarchy and HierarchyCommandList. A detached node keeps its data map entry but is unreachable from Root.

Added: New public API, IHierarchyNodeTypeHandlerViewModelState, and GetOrCreateHandlerState<T>, TryGetHandlerState<T> and DestroyHandlerState on HierarchyViewModel, for node type handler state that belongs to a single view model. HierarchyNodeTypeHandlerBase.SearchBegin, SearchMatch and SearchEnd gained overloads taking the HierarchyViewModel running the search.

Added: [Scripting] IL2CPP code coverage support.

Deprecated: Deprecated PlayerSettings.gpuSkinning. Use PlayerSettings.meshDeformation instead.

Deprecated: HierarchyNodeTypeHandlerBase.SearchBegin(HierarchySearchQueryDescriptor), SearchMatch(in HierarchyNode) and SearchEnd() are obsolete. Use the overloads that take a HierarchyViewModel, since handlers are shared by every view model on a hierarchy.

Removed: Deprecated Hierarchy.GetAllNodeTypeHandlersBase has been removed.

Removed: Deprecated Hierarchy.GetAllNodeTypeHandlersBaseCount has been removed.

Removed: Deprecated Hierarchy.RegisterNodeTypeHandler has been removed.

Removed: Deprecated Hierarchy.SortChildren(HierarchyNode, bool) has been removed.

Removed: Deprecated Hierarchy.UnregisterNodeTypeHandler has been removed.

Removed: Deprecated HierarchyCommandList.SortChildren(HierarchyNode, bool) has been removed.

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

Removed: Removed the deprecated HierarchyViewModel.HierarchyFlattned.

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.