Release Notes Search

Added: GTK : Custom state machine conditions can now customize their row in the transition inspector.

Added: GTK : New API added to have icons for Conditions, logic groups, transition rules and transitions, shown on their row in the transition inspector.

Added: Introduced support for Unity Registry packages adding references to on-disk assets to a build profile.

Added: Introduced support for Unity Registry packages adding references to on-disk assets to a build profile.

Added: Project Auditor: Added migration areas to support adding migration rules.

Added: Project Auditor: Added Descriptor.IsSupported so analyzers can check if an issue is valid for the current platform and version.

Added: Project Auditor: Exposed various APIs to enable packages and user code to write rules.

Added: Project Auditor: exposed ShadersModule.OnAnalysisStarted.

Deprecated: Deprecate Oculus XR package.

Obsoleted: The EntityCommandBuffer PlaybackPolicy enum has been made obsolete with errors. To apply the same set of commands more than once, record them into a new EntityCommandBuffer for each playback.

Removed: Project Auditor: Removed FirstCustomCategory from IssueCategory enum, and moved it to IssueCategoryExtensions as a static field.

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

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

Added: Added the CompanionComponent<T> unmanaged wrapper and the EntityManager.GetCompanion<T> extension so that companion components can be read from systems without using the obsolete managed component API.

Added: ChunkEntityEnumerator.IsSparse and .NextEntityIndexBatch were added to support cases where code needs to branch on sparse chunks, and would prefer batched APIs for performance reasons.

Changed: IDebugOnAdded and IDebugOnRemoved callback signatures now require Entity parameter. Update callbacks from OnAdded(ref T component) to OnAdded(Entity entity, in T component).

Deprecated: Deprecated BlobAssetReference<T>.TryRead and BlobAssetReference<T>.Write. Use BlobAssetReferenceIO<T>.TryRead and BlobAssetReferenceIO<T>.Write instead.

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.

Deprecated: Marked the following functions as deprecated as part of the managed component deprecation: EntityQuery.ToComponentArray<T>(), EntityQuery.GetSingleton<T>(), TryGetSingleton<T>(), GetSingletonRW<T>(), and SetSingleton<T>() for managed (class) component types, and EntityQuery.GetTransformAccessArray().

Removed: Baking managed components and managed shared components is no longer supported. Baker.AddComponentObject, Baker.AddSharedComponentManaged, and Baker.SetSharedComponentManaged are now compile errors. Convert your data to unmanaged IComponentData / ISharedComponentData (use UnityObjectRef<T> to reference UnityEngine.Object instances) and bake it with the unmanaged AddComponent / AddSharedComponent APIs.

Removed: The managed-component APIs deprecated in 6.6 are now compile errors.

Removed: The EntityCommandBuffer/ParallelWriter APIs for managed IComponentData and managed ISharedComponentData are now compile errors.

Added: Added an API for creating, loading and unloading procedurally generated LightProbes objects.

Added: Added LODGroup.globalIlluminationLOD, Renderer.lodGroupMask and the Unity.Rendering.GlobalIlluminationLOD component.

Added: Let render pipelines opt out of the baked divide-by-PI convention.

Deprecated: Deprecated both TerrainExtensions.UpdateGIMaterials overloads. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated CombineInstance.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated DynamicGI.indirectScale, DynamicGI.isConverged, DynamicGI.materialUpdateTimeSlice, DynamicGI.synchronousMode, DynamicGI.updateThreshold, DynamicGI.SetEmissive, and DynamicGI.SetEnvironmentData. DynamicGI.UpdateEnvironment is not deprecated. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated LightingSettings.realtimeGI and LightingSettings.realtimeEnvironmentLighting. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated LightmapParameters.clusterResolution, LightmapParameters.irradianceBudget, LightmapParameters.irradianceQuality, LightmapParameters.isTransparent, LightmapParameters.modellingTolerance, LightmapParameters.stitchEdges, and LightmapParameters.systemTag. LightmapParameters.resolution is not deprecated, because it also sets the resolution the Progressive Lightmapper bakes terrain at. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated MeshRenderer.enlightenVertexStream. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated Renderer.realtimeLightmapIndex and Renderer.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated RendererExtensions.UpdateGIMaterials. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated Terrain.realtimeLightmapIndex and Terrain.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.

Deprecated: Deprecated UnityEditor.Lightmapping.realtimeGI. Enlighten realtime Global Illumination will be removed in a future release.

Added: Added a new API to access the root VisualElement of Nodes.

Added: Added a new API to access the root VisualElement of States.

Added: Added a new overload to Graph.AddVariableNode that allows variable nodes to be created with a specific mode. Added a Mode getter to IVariableNode to get the current VariableNodeMode of the variable node.

Added: Added an API to edit Group Conditions.

Added: Added an overload to Graph.UndoBeginRecordGraph taking a param array of Node objects. Passing nodes here will track changes to serialized fields on user defined nodes, ensuring they are tracked by the undo system and that the graph is dirtied when these fields are modified.

Added: Added public API for customizing state accent visuals in editor and runtime.

Added: Added public API for customizing state transition visuals in editor and runtime.

Added: Added state options. Implemented by overriding State.OnDefineOptions on a State, and accessed through IStateOption. State options appear in the Inspector when the state is selected.

Added: Added StateMachine.OnStateMachineChanged() public API.

Added: Added the following properties on Graph: SupportedTypes, AvailableVariableTypes and AvailableConstantTypes. Added the following methods on Graph: BuildAvailableVariableTypes and BuildAvailableConstantTypes. Graph devs can now customize which variable types their end users have access to in the blackboard and constant types in the graph item library. Types added using BuildAvailableConstantTypes and BuildAvailableConstantTypes are implicitly added to SupportedTypes.

Added: Added the DataTypeStyleMapper.Register(System.Type dataType, UnityEngine.Color color) overload to allow changing the color of a data type while showing a default icon.

Added: Added IInputPortBuilder.WithDataTypes and IOutputPortBuilder.WithDataTypes APIs to define a port as Polymorphic (a port that accepts multiple data types).

Added: Added IPort.TrySetDataType API to programmatically change the data type of a polymorphic port.

Added: Added Node.OnPortDataTypeChanged callback that is triggered when a user changes the data type of a polymorphic port.

Added: Extend ITransition to add abilities to manage ITransitionRules.

Added: Extend the StateMachine class to add the ability to manage transitions between states.

Added: The Graph Toolkit state machine authoring API is now public, letting you define custom state-machine graph assets (with custom states, transitions, conditions, and variables) from editor scripts.

Added: The GraphLogger has several new properties. Each provides a List of Nodes, Ports or Variables that have been added, removed or changed (removed items simply have their guid).

Added: Added Default Mesh Buffer Target to project graphics settings.

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

Changed: Deprecated RayTracingAABBsInstanceConfig.dynamicGeometry and replaced with RayTracingAABBsInstanceConfig.rayTracingMode. AABB ray tracing instances are now compatible with RayTracingAccelerationStructure.UpdateInstanceGeometry method.

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: Enable Upscaling Framework by default.

Deprecated: Input.backButtonLeavesApp is deprecated and will be removed in a future release. Use Application.backButtonLeavesApp instead.

Added: Added a new DeviceOrientationSensor device that provides feature parity with UnityEngine.Input.deviceOrientation.

Added: Added internal plumbing for the Input System package to be able to extract Device Orientation similar to Input Manager.

Added: Introducing user module version for UnityAPI module for Swift project type.

Removed: Removed the GameCenter implementation.

Removed: The deprecated iPhoneInput class has been removed. Use Input instead.

Added: Added MemoryLabel.Create.

Added: The former com.unity.collections has been moved into an engine module, namely ManagedKernelModule. It is now available irrespective of whether the package is used, and the package is reduced to a set of typeforwarders. As part of this move, the scripting define UNITY_DOTS_DEBUG no longer controls extra checks in players in Native and Unsafe collections (although it still does control many extra checks in Entities); now you need to use the Checked (or Debug) managed code variant to include those checks in player builds.

Added: Added support for replicating non-uniform (3D) scale via the Unity.Transforms.PostTransformMatrix component, using the new built-in PostTransformMatrix3DScaleVariant. Rather than sending the full float4x4 matrix, only the per-axis scale is extracted and replicated (as three quantized floats by default). Existing ghost prefabs will have the DontSerializeVariant set by default for PostTransformMatrix to not break existing behavior. Use the new SubType = GhostFieldSubType.PostTransformMatrixScale to create your own Variants.

Removed: The obsolete managed GhostPresentationGameObjectPrefab component is now a hard error ([Obsolete(..., true)]) and no longer functional. Use the unmanaged UnmanagedGhostPresentationGameObjectPrefab instead, which references the prefabs through UnityObjectRef<GameObject>.

Added: Added PhysicsSceneLoadScope which can be used to control which physics scene is used when loading a unity scene asset. This effectively allows grouping multiple unity scenes under a specific physics scene.

Added: Added "ChainSegment.UpdateSegments()" to update the segments. This compliments the existing "ChainSegment.CreateSegments()".

Added: Added "Get()" extension method to all Physics "object" types to allow users to work around not being able to use a setter property on a returned object without first assigned to a local variable. Added to PhysicWorld, PhysicsBody, PhysicsShape, PhysicsChain, PhysicsJoint and all concrete PhysicsJoints.

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 "PhysicsUserData.vector3IntValue" property of type Vector3Int. This will allow per-shape tilemap position references.

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

Added: Added a "massOverride" property to PhysicsBody and PhysicsBodyDefinition that selects which of the mass, rotational inertia and center of mass use authored values instead of being calculated from the attached shapes.

Added: Added a "PhysicsEvents.WorldTransformPlaneChange" event which is called when a PhysicsWorld transform plane is changed.

Added: Added a batch overload of "SetOwnerUserData()" to PhysicsShape, PhysicsBody, and PhysicsJoint.

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.

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.