Release Notes Search

NVUnityPlugin.pdb is now available inside the Unity installation on disk and on Unity's symbol server.

Graphics: Allow shader permutation to persist during building, allowing non-shadowed stencil deferred lights to avoid expensive shadowing calculations.

Graphics: Improved GPU performance of stencil deferred point and spot light draws by specializing the per-light fragment shader per light type, letting point lights skip cone-angle math and spot lights skip a runtime shadow-map-face branch.

QuadViews: Allow LUT information to be reused within inner/outer views.

QuadViews: Defer the submission of render commands to the final inner quad view pass to improve XR CPU performance.

Changed: Added Render Shader User Value (RSUV) support to intermediate renderers.

Added: Added CompileSdkSpec Gradle DSL classes.

Added: Added support for SDK Platform 37.

Added: Added support the new CPU/GPU utilization Adaptive Performance metrics via CPU/GPU headroom methods on Android.

Added: Added the PowerMonitor energy consumption API to Adaptive Performance Android provider.

Added: Added the PowerMonitor energy consumption API to Adaptive Performance Android provider.

Added: Added ApplicationStartInfoProvider.GetHistoricalProcessStartReasons to retrieve ApplicationStartInfo records.

Added: Added PlayerSettings.Android.compileSdkVersion to set the compile API level independently of the target API level, including sub-integer (major.minor) precision.

Changed: Reduced public API surface of the Android Java player library (com.unity3d.player) by making internal classes and methods package-private. Affected classes - ApplicationExitInfoBase, ApplicationExitInfoProvider, AudioVolumeHandler, Camera2Wrapper, GoogleARCoreApi, HFPStatus, MultiWindowSupport, NativeLoader, NetworkConnectivity, OrientationLockListener, PermissionRequest, PlatformSupport, StaticSplashscreen, UnityGameManager, UnityGameState, UnityPermissions, VideoPlayer, TimeoutThread, UnityPlayer.kbCommand, IFrameReady, IPermissionRequestCallbacks, VideoPlayer.StateCallback. Affected methods - UnityPlayer.getNetworkProxySettings(java.lang.String), UnityPlayer.startOrientationListener(int), UnityPlayer.stopOrientationListener(), UnityPlayer.setMainSurfaceViewAspectRatio(float).

Deprecated: Removed deprecated TouchScreenKeyboard.Android.consumesOutsideTouches and closeKeyboardOnOutsideTap properties; Unity now always processes touches outside the on-screen keyboard.

Changed: Moved AnimationPlayableOutputExtensions and AnimationStreamSource out of experimental. Projects will be upgraded automatically with the new namespace.

Added: AssetImportContext.DependsOnArtifact overloads that take a UnityEngine.Object or a LazyLoadReference<T>, so a scripted importer can declare an artifact dependency directly from an object or lazy reference.

Added: Added a real-time counterpart to ControlContext.SendMessage for the Scriptable Audio Pipeline. This is a binary breaking change, but it's source compatible.

Added: Added seeking support to scriptable processors and audio clips used as generators.

Added: Scriptable processors: added GeneratorInstance.CreationParameters and RootOutputInstance.CreationParameters; deprecated ProcessorInstance.CreationParameters and its implicit conversions (to be removed in a following version).

Deprecated: Deprecated various Audio APIs.

Added: Allow for extra scripting defines when using BuildPlayer with BuildPlayerWithProfileOptions.

Changed: Added new abstractions for progressive asset loading.

Added: Added APIs to insert custom entries in the Graph and Blackboard right-click menus.

Added: Added more alloc-free APIs for TextElement.

Added: Added right click menu support for state machine.

Added: Added Span/ReadOnlySpan for applicable editor APIs.

Added: Added the MainToolbarCustomElement API to the customizable toolbar to enable the creation of custom VisualElements.

Added: Added the UnityEditor.EditorDialogEvents API, which raises dialogWillShow and dialogDismissed events when a native or custom modal dialog appears in the Editor. External tooling can use these events to detect that the Editor's main thread is blocked by a dialog instead of appearing hung.

Added: Added EditorUserBuildSettings.activeNamedBuildTarget and BuildSummary.namedBuildTarget.

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

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.

Deprecated: Deprecate Oculus XR package.

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

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

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

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 autoAnchorA and autoAnchorB properties to PhysicsJoint and PhysicsJointDefinition.

Added: Added autoDistance property to PhysicsDistanceJoint and PhysicsDistanceJointDefinition.

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

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: Added CoreCLR ScriptingImplementation enum value exposing CoreCLR player support.

Added: [Scripting] IL2CPP code coverage support.

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

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.