Improved shader performance by removing a dynamic branch in URP shaders that was used to test whether a surface is opaque or transparent.
URPImprovement
URP specific shader macro 'FIRST_BIT_LOW' is obsolete, intrinsic 'firstbitlow' now functions correctly on all supported platforms.
URPImprovement
Reduced the number of shader variants produced by VFX Graph outputs in builds.
VFX GraphImprovement
Lifted restriction of integer vertex attributes which was inherited from WebGL 1 and GLES 2 and isn't relevant anymore for WebGL 2 and GLES 3+.
WebGLImprovement
Improved performance of issuing async reads with DirectStorage
WindowsImprovement
Improved performance on loading archive files with DirectStorage enabled.
WindowsImprovement
Added support for transparent and UI elements for SpaceWarp (UGUI & TMP).
XRImprovement
Added XRLayoutType enum and derived properties to XRPass for explicit XR rendering layout identification, replacing fragile multi-condition checks across URP and HDRP.
XRImprovement
Implemented four shader micro-optimizations to improve GPU performance on Meta Quest headsets. As a side effect, DistanceAttenuation function now takes three arguments on the Meta Quest platform.
XRImprovement
Improved GPU performance on Meta Quest devices when a render batch is not affected by spotlights.
XRImprovement
Updated the default settings for the Meta Quest Build Profile's custom Quality Setting.
XRImprovement
Added: Added overloads for RenderSpriteInstanced to support List, NativeArray, and ReadOnlySpan.
2DAPI change
Added: Added CpuUtilization and GpuUtilization APIs for CPU and GPU utilization.
Adaptive PerformanceAPI change
Added: Added new structs in the Unity.AI.Navigation.LowLevel namespace with methods that you can call in jobs. To help you debug race conditions, the added queries can throw safety exceptions when ENABLE_UNITY_COLLECTIONS_CHECKS is defined. The new structs are: NavWorld, NavNode, NavLocation and NavQueryBuffer. Two new enums, NavQueryStatus and NavNodeType, help in various operations.
AIAPI change
Added: Added PlayerSettings.Android.gamepadSupportLevel, the UI was already present, only API was missing.
AndroidAPI change
Added: Added support for SDK Platform 37.
AndroidAPI change
Changed: AndroidGamepadSupportLevel.SupportsDPad was renamed to AndroidGamepadSupportLevel.None.
AndroidAPI change
Obsoleted: GenericBinding.scriptInstanceID is deprecated. Use scriptEntityId instead.
AnimationBreaking
Obsoleted: GenericBindingUtility.BindProperties(GameObject, NativeArray<GenericBinding>, out NativeArray<BoundProperty>, out NativeArray<BoundProperty>, Allocator) is deprecated. Use the overload which includes out instanceIDProperties instead.
AnimationBreaking
Deprecated: The X86_64 and Universal options for the tvOS Simulator Architecture setting are now marked as deprecated.
Apple TVBreakingtvOS
Changed: Deprecated AssetImportContext.GetArtifactFilePath in favour of AssetImportContext.GetArtifactData.
Asset PipelineBreaking
Deprecated: Removed the AssetdatabaseExperimental.ActiveOnDemandMode API. The OnDemand feature was experimental and could cause a deadlock when used.
Asset PipelineBreaking
Added: Added GeneratorInstance.Result.isFinished and Finished() to determine whether a nested generator finished producing samples.
AudioAPI change
Added: Added UnityWebRequestMultimedia.GetAudioClip(string uri, AudioType audioType, bool ambisonic) overload and corresponding DownloadHandlerAudioClip constructors for loading ambisonic audio from StreamingAssets or other runtime sources.
AudioAPI change
Removed: Removed a number of obsolete audio APIs.
AudioBreaking
Added: Added the method BuildReport.LoadReport() to support loading BuildReports files from past builds, regardless of their location inside or outside of the active Unity project.
Build PipelineAPI change
Changed: Made BuildContentDirectoryParameters.targetPlatform and BuildContentDirectoryParameters.subtarget internal.
Build PipelineAPI change
Removed: Removed obsolete APIs.
Build PipelineBreaking
Removed: Removed the obsolete LoadableObjectIdEditorUtility.ObjectToLoadableObjectId API. Use LoadableObjectIdEditorUtility.CreateLoadableObjectId instead.
Build PipelineBreaking
Obsoleted: EntityId implicit conversion from int is deprecated. EntityId will not be representable by an int in the future. This will be removed in a future version.
CoreBreaking
Obsoleted: EntityId implicit conversion to int is deprecated. EntityId will not be representable by an int in the future. This will be removed in a future version.
CoreBreaking
Obsoleted: EntityId.Equals(int other) is deprecated. EntityId will not be representable by an int in the future. This will be removed in a future version.
CoreBreaking
Obsoleted: GameObject.GetScene(int instanceID) is obsolete. Use GameObject.GetScene(EntityId entityId) instead.
CoreBreaking
Obsoleted: GameObject.InstantiateGameObjects(int sourceInstanceID, int count, NativeArray<int>, NativeArray<int>, Scene) is obsolete. Use GameObject.InstantiateGameObjects(EntityId, int, NativeArray<EntityId>, NativeArray<EntityId>, Scene) instead.
CoreBreaking
Obsoleted: GameObject.SetGameObjectsActive(NativeArray<int> instanceIDs, bool active) is obsolete. Use GameObject.SetGameObjectsActive(NativeArray<EntityId>, bool) instead.
CoreBreaking
Obsoleted: GameObject.SetGameObjectsActive(ReadOnlySpan<int> instanceIDs, bool active) is obsolete. Use GameObject.SetGameObjectsActive(ReadOnlySpan<EntityId>, bool) instead.
CoreBreaking
Obsoleted: InstanceID struct is obsolete. Use EntityId instead.
CoreBreaking
Obsoleted: LazyLoadReference<T> implicit conversion from int instanceID is deprecated. Use LazyLoadReference(EntityId entityId) instead. This will be removed in a future version.
CoreBreaking
Obsoleted: LazyLoadReference<T>(int instanceID) constructor is deprecated. Use LazyLoadReference(EntityId entityId) instead. This will be removed in a future version.
CoreBreaking
Obsoleted: LazyLoadReference<T>.instanceID is deprecated. Use entityId instead. This will be removed in a future version.
CoreBreaking
Obsoleted: Object.GetInstanceID is deprecated. Use GetEntityId instead. This will be removed in a future version.
CoreBreaking
Obsoleted: Resources.InstanceIDIsValid(int instanceId) is obsolete. Use EntityIdIsValid instead.
CoreBreaking
Obsoleted: Resources.InstanceIDsToValidArray(NativeArray<int>, NativeArray<bool>) is obsolete. Use EntityIdsToValidArray instead.
CoreBreaking
Obsoleted: Resources.InstanceIDToObject(int instanceID) is obsolete. Use EntityIdToObject instead.
CoreBreaking
Obsoleted: Resources.InstanceIDToObjectList(NativeArray<int>, List<Object>) is obsolete. Use EntityIdsToObjectList instead.
CoreBreaking
Removed: InstanceID implicit conversion to and from EntityId is removed. Use EntityId directly instead of InstanceID.
CoreBreaking
Added: Added new API ObjectNames.GetUniqueObjectName - Returns a unique version of name relative to a list of existing Unity objects, automatically appending a numeric suffix if needed (e.g. "Rock (1)"). Similar to GetUniqueName, but accepts live UnityEngine.Object references directly, which bypasses string marshalling allocations, as well as array allocations.
EditorAPI change
Added: Added PlayerSettings.GetRayTracingFeaturesSupportForPlatform Editor-only API for retrieving the implementation status for various ray tracing feature on specified platforms.
EditorAPI change
Added: Added public api for hosting Editor Tools in custom windows.
EditorAPI changeWindows
Added: Added support for storing ULongs in SessionState. This adds the following APIs: EraseEntity, EraseEntityIdArray, GetEntityId, GetEntityIdArray, SetEntityId, and SetEntityId.
EditorAPI change
Added: Added the GetWire method to the Graph class. This method returns a Wire, a runtime-friendly representation of a single logical connection between an output port and an input port in a graph.
EditorAPI change
Added: Added BuildProfile.CreateBuildProfile API for creating build profiles for specified platforms and automatically installs required platform packages if not already installed.
EditorAPI change
Added: Animation: Added AnimationEventInfo ref struct as a non-allocating alternative parameter for animation event callbacks. This new stack-allocated struct eliminates garbage collection overhead when handling animation events, providing significant performance benefits for animation-heavy scenes. AnimationEventInfo provides read-only access to all animation event parameters and state information from both Animator and legacy Animation components. Existing AnimationEvent callbacks remain fully backwards compatible.
EditorAPI change
Added: GTK : Added an API to access the GUID of different graph elements.
EditorAPI change
Added: GTK : Added API to add custom actions to the GTK main toolbar with the GraphToolbarElement attribute.
EditorAPI change
Added: GTK : Added port.WithCapacity API to change port capacity.
EditorAPI change
Added: Project Auditor: add migration areas so we can add migration rules.
EditorAPI change
Added: Project Auditor: Added Descriptor.IsSupported, so analyzers can check if an issue is valid for the current platform/version.
EditorAPI change
Added: Project Auditor: expose various APIs to enable packages and user code to write rules.
EditorAPI change
Added: [Android] Added "Profileable Shell" setting for Release builds in Android build settings for Unity 6.6.
EditorAPI changeAndroid
Added: [Android] Added internal analytics for new "Profileable Shell" setting for Release builds in Android build settings for Unity 6.6.
EditorAPI changeAndroid
Added: [Android] Added manifest entry for new "Profileable Shell" setting for Release builds in Android build settings for Unity 6.6.
EditorAPI changeAndroid
Added: [Android] Added UI text and tooltip for new "Profileable Shell" setting for Release builds in Android build settings for Unity 6.6.
EditorAPI changeAndroid
Changed: Add signature using an organization ID to exported asset package.
EditorAPI change
Changed: Added a Built-In category to the Material Editor shader selector when a Scriptable Render Pipeline is in use.
EditorAPI change
Changed: Deprecated the shader compiler pragma argument #pragma enable_d3d11_debug_symbols and replaced it with #pragma enable_debug_symbols.
EditorBreaking
Changed: GTK: Hash128 unique identifier properties in the GTK public API have been renamed from Guid to ID (e.g. INode.Guid to INode.ID). This is a breaking change for any code using the previous GTK public API.
EditorBreaking
Changed: SceneViewCameraWindows.additionalSettingsGui have been deprecated as it was using ImGUI. It is replaced by SceneViewCameraWindows.createAdditionalSettingsGUI and SceneViewCameraWindows.bindAdditionalSettings using UITK. The new version is per SceneView and support copy-paste and reset of settings.
EditorBreaking
Deprecated: Deprecate BuildSummary.multiProcessEnabled, Multi-process AssetBundle building was removed in Unity 6.4. Users should use BuildPipeline.BuildContentDirectory for multi-process building.
EditorBreaking
Deprecated: It is no longer possible to enable word wrapping in YAML files.
EditorBreaking
Obsoleted: ArrayEntries.instanceId has been made obsolete. Use ArrayEntries.entityId instead.
EditorBreaking
Obsoleted: AssetDatabase.CanOpenAssetInEditor(int instanceID) is deprecated. Use CanOpenAssetInEditor(EntityId) instead. Editor: AssetDatabase.Contains(int instanceID) is deprecated. Use Contains(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.GetAssetPath(int instanceID) is deprecated. Use GetAssetPath(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.InstanceIDsToGUIDs(NativeArray<int>, NativeArray<GUID>) is deprecated. Use EntityIDsToGUIDs() instead.
EditorBreaking
Obsoleted: AssetDatabase.IsForeignAsset(int instanceID) is deprecated. Use IsForeignAsset(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.IsMainAsset(int instanceID) is deprecated. Use IsMainAsset(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.IsNativeAsset(int instanceID) is deprecated. Use IsNativeAsset(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.IsSubAsset(int instanceID) is deprecated. Use IsSubAsset(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.OpenAsset(int instanceID) is deprecated. Use OpenAsset(EntityId) instead.
EditorBreaking
Obsoleted: AssetDatabase.OpenAsset(int instanceID, int lineNumber) is deprecated. Use OpenAsset(EntityId, int) instead.
EditorBreaking
Obsoleted: AssetDatabase.OpenAsset(int instanceID, int lineNumber, int columnNumber) is deprecated. Use OpenAsset(EntityId, int, int) instead.
EditorBreaking
Obsoleted: AssetDatabase.TryGetGUIDAndLocalFileIdentifier(int instanceID, out string, out long) is deprecated. Use TryGetGUIDAndLocalFileIdentifier(EntityId, out string, out long) instead.
EditorBreaking
Obsoleted: AssetPreview.IsLoadingAssetPreview(int instanceID) is deprecated. Use IsLoadingAssetPreview(EntityId entityId) instead.
EditorBreaking
Obsoleted: Beginning of Forbidden API deprecation: specific AppDomain methods/events.
EditorBreaking
Obsoleted: Changed guid, int instanceId, Scene scene) is deprecated. Use ChangeAssetObjectPropertiesEventArgs(GUID guid, EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene scene) is deprecated. Use ChangeChildrenOrderEventArgs(EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene scene) is deprecated. Use ChangeGameObjectOrComponentPropertiesEventArgs(EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene scene) is deprecated. Use ChangeGameObjectStructureEventArgs(EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene scene) is deprecated. Use ChangeGameObjectStructureHierarchyEventArgs(EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene scene) is deprecated. Use ChangeRootOrderEventArgs(EntityId entityId, Scene scene) instead.
EditorBreaking
Obsoleted: Changed instanceId, Scene, int previousParentInstanceId, Scene, int newParentInstanceId) is deprecated. Use ChangeGameObjectParentEventArgs(EntityId entityId, Scene, EntityId previousParentEntityId, Scene, EntityId newParentEntityId) instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use entityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use newParentEntityId instead.
EditorBreaking
Obsoleted: Changed is deprecated. Use previousParentEntityId instead.