Release Notes Search

Light 2D now exposes an optional custom shadow Material, letting the shadows a light casts be drawn by an authored shadow shader instead of URP's built-in one. Requires the Enhanced 2D shadow geometry version.

New Light2D ShaderGraph target for authoring custom 2D light shaders, with Color, Shadow Color and Volumetric Color fragment ports. Create one from Assets > Create > Shader Graph > URP > Light 2D Shader Graph.

New Profiler module for Physics Core 2D.

New Shadow Caster 2D ShaderGraph target for authoring custom 2D shadow shaders, with Position, Shadow Displacement, Side Softness and Back Softness vertex ports and an Alpha fragment port. Create one from Assets > Create > Shader Graph > URP > Shadow2D Shader Graph.

Added an ImporterGlobalSettings singleton type that can be used to host global importer settings and is correctly synched on import workers.

Added Scriptable Effects to Scriptable Audio Pipeline (SAP).

Removed the feature flag related to the Enhanced Audio Foundation. The Audio Foundation property will now always be visible in the project's global audio settings in the Editor. We still default to Classic mode, but Enhanced mode is now an option.

Unity now provides a built-in Ambisonic Decoder Plugin for Quad+ setups. You use this decoder directly to decode first, second or third order Ambisonic clips into Quad, 5.0, 5.1, 7.1 or 7.1.4 output layouts. You can find more information about this in the Unity Manual.

Added beta sweepstakes opt in to bug reporter.

Added button to change bug reporter theme.

Added ability to edit the text of some controls such as buttons, labels directly in the viewport using the new menu action Edit or double-clicking on the element.

Added Current & Runtime Targets and Severity Breakdown to "Move to CoreCLR" section in Project Auditor.

Added Jobs Profiler that can be selected as experimental timeline view in the Profiler Window.

Added Migration Wizard to the Universal Render Pipeline.

Implement Advanced Text (ATG) in TextMeshPro as an experimental opt-in.

Swift Project Type is no longer experimental.

UI Toolkit: Added a Track Screen Space Position toggle to the Panel Renderer component. This lets you make a screen space UI element, such as a health bar, follow a target in the 3D world without scripting.

Unity Render Service (URS) is now available in the Build Settings window.

URP Upscaler Priority List.

Added Mouse.isSupported, which reports whether the current platform can deliver mouse input, rather than whether a mouse is currently connected.

Added Pen.isSupported and Touchscreen.isPressureSupported, which report whether the current platform can deliver pen input and whether its touch input carries a real pressure value, rather than whether such a device is currently connected.

Added a new Single World Host mode for client-hosted servers, instead of using binary client and server worlds. This the new default for netcode host world creation. This new mode removes the overhead of having to run two worlds in the same process by running both client and server systems in the same world. With this, no more useless serialization/deserialization, useless rollback and replay, useless worlds doing the same thing. See the documentation for pros and cons. For existing projects transitioning to this new mode, please see the documentation for migration advice, as this is not a seamless transition. For those not wishing to use this new mode, you can change this back in your NetcodeConfig project settings using the HostWorldModeSelection setting.

Added a *Web Requests module to the Profiler* window, which reports the UnityWebRequest activity of the application you are profiling:

The chart tracks the requests in flight, and the bytes sent and received in each frame.

The request list shows each request's status, method, target domain, request source, content type, size and duration, and filters on any of them. A summary strip totals the requests, bytes transferred and errors of the recording, and its p95 latency.

general information, request and response headers, query string parameters, and a per-phase timing breakdown of DNS lookup, connection, TLS handshake, waiting and transfer.

Added localization package upgrade path.

Added build target support for QNX 7.1 with io-sock.

Added --qnx-network-stack option to allow selection of new io-sock QNX7.1 variants.

Introduced a new fast build mode in the Shader Build Settings, automatically converting keywords to dynamic branching and making builds much faster for iteration purposes.

You can now open and edit a standalone StyleSheet or Theme StyleSheet asset in the UI Builder without a UXML owner.

Added a light falloff mode that matches the Built-in Render Pipeline.

Added exposure support to URP's version of SRP lens flare.

Added: URP Tonemapping now offers an AgX mode in addition to Neutral and ACES. AgX is a modern display transform that desaturates highlights as it compresses them, avoiding the hue shifts and clipping that can appear in over-exposed regions with ACES. It exposes two controls, Contrast and Mid Gray, and works in both SDR and HDR grading modes.

Modern Screen Space Ambient Occlusion in URP is now public. Existing SSAO Renderer Feature settings are no longer applied. To get the same SSAO results as before, follow the help box in the SSAO Renderer Feature inspector and copy the parameters (shown as inactive) into a Screen Space Ambient Occlusion Volume Override.

Internal cleanup of NdkLooper (RAII pipe fds, dropped goto, NULL/0 normalized to nullptr).

The NativeFormatImporter now run out-of-process when "parallel import" (in ProjectSettings/Editor) is ON.

The VisualEffectImporter now run out-of-process when "parallel import" (in ProjectSettings/Editor) is ON.

Added profiler markers to Scriptable Audio Pipeline Generators created from Audio Clips, and improved heuristics of the decode-ahead system to avoid slower in-place decoding.

Improved Content Directory build dependencies for LOD stripping in assets and scenes to avoid re-build them when the LOD stripping level is changed without impacting them.

Updated the bundled 7-Zip to version 26.03.

DataStreamReader and DataStreamWriter no longer use a scratch field, allowing fixed-bit-sized packed writes to earlier positions in the buffer (via a copy of the writer) without data corruption.

Cherry-picked an upstream JIT fix that corrects an inverted Tier0 box-sharing guard, so Enum.HasFlag calls compiled at Tier0 get an exact-typed box and elide the allocation entirely instead of boxing both operands on every call (upstream dotnet/runtime #130590).

Documented how a custom key comparer on a serialized Dictionary field is preserved, and the cases where it isn't.

Added higher resolution localization editor icons.

Added tooltip for Operation Mode, Idle Time Threshold, and Save Target fields in adaptive performance. (UUM-150015) First seen in 6000.7.0a5.

Added various general usability issues with the Build Analysis Window.

Improved hierarchy icons for missing prefab/script references.

Improved the main toolbar element selection by creating a search provider and the associated window.

Moved info.plist file to MainApp directory of iOS/tvOS Swift project Type. Moved storyboard file to MainApp directory for tvOS Swift project Type.

The Platform Browser now shows the licenses that apply to the packages selected for a new build profile.

Added the "Warm-up Sample Multiplier" setting to Surface Cache, which allows users to boost sample count for the first frame of a patch's existence to reduce noise.

Added XR support to Surface Cache GI.

State transitions can now be started by holding Shift and clicking anywhere on a state, and the area around a state's edge where a transition can be started remains usable when zoomed out.

Search filters have fallback behavior when indexing isn't complete or available.

Debug.ClearDeveloperConsole now also clears errors that have not been displayed yet, so the developer console no longer reopens later showing already cleared errors.

Removed InputSystem gizmo / icons from scene view window.

Improved Physics Core 2D contact solver performance.

Updated PhysicsCoreSettings2D asset icon.

PhysicsFixedJoint now uses a separate solving path when both the linear and angular frequencies are set to zero indicating full stiffness. This has always been a special set of values but now is much stiffer removing visible "ringing" artifacts when the bodies are relatively far apart and changing in both position and rotation.

Surface assembly references from the MSBuild compilation pipeline.

Improved main scene editing Overrides menu.

Added contact hardening (distant-dependent reflections) to Screen Space Reflections for URP. This is controlled by 2 new settings: Contact Hardening Scale and Contact Distance Bias.

Improved GPU performance when QuadViews are enabled in Deferred rendering (when not using SpaceWarp) via reducing the amount of redundant geometry rendering in the focus-inner region during the low-resolution periphery pass.

Added: Added EnergyUsage API to enable power monitor (CPU, GPU, TPU, display, memory) energy consumption reading.

Added: Added a new AssetPostprocessor.OnProcessScene callback used when loading scenes in playmode or during a build as a deterministic replacement to IProcessSceneWithReport.OnProcessScene.

Added: GameObjectUtility.AllStaticEditorFlagsSet returns true only if all of the requested StaticEditorFlags are set.

Added: GameObjectUtility.AnyStaticEditorFlagsSet returns true if any of the requested StaticEditorFlags are set.

Deprecated: GameObjectUtility.AreStaticEditorFlagsSet use AnyStaticEditorFlagsSet for the previous behavior, or AllStaticEditorFlagsSet to require all flags. Existing code is automatically upgraded to AnyStaticEditorFlagsSet by the API Updater (no behavior change).

Added: Added a new public API to ease discoverability of available Main Toolbar elements.

Added: Added a new RequiresInsights attribute. Packages and user code can use it to declare a dependency on the Insights module, which ensures the module is included in the build.

Added: Added public text API to generate text using ATG.

Added: Added CompassSensor, exposing magnetic heading, true heading, raw geomagnetic vector, and heading accuracy as the parity equivalent of UnityEngine.Input.compass.

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: exposed ShadersModule.OnAnalysisStarted.

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

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

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

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

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

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

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

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

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.

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