Release Notes Search

Fixed an issue where URP scenes rendered black on Meta Quest 2 with Vulkan and MSAA, for example scenes with decals and no transparent objects.

Fixed SubsystemWithProvider.Start not throwing an ArgumentNullException when called after the subsystem was destroyed, which restarted the destroyed provider.

Rendering no longer stops on Quest 2 with OpenGL ES3 when a scene changes the MSAA level. (UUM-153015) First seen in 6000.7.0a1.

3.4.0 to 3.4.2

1.6.0 to 1.6.1

1.18.0-pre.2 to 1.19.0-pre.2

2.4.0 to 2.4.1

2.0.0 to 3.1.0

1.0.0-pre.2 to 1.0.0

Added EntityIDTile/Base which can be used with Tilemap jobs and Burst.

Light 2D now exposes an optional custom Material, letting a light be drawn by an authored shader instead of URP's built-in one. Available on every light type except Global.

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.

Light2D now exposes an optional custom Material, and Light2D meshes (Freeform, Point/Spot) now carry position-derived UVs so custom light shaders can sample textures across the light's extents.

New Light2D ShaderGraph SubTarget for authoring custom light shaders.

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.

New Shadow2D ShaderGraph SubTarget for authoring custom 2D shadow shaders, with Position and Shadow Distance vertex ports and an Alpha fragment port.

Shadow geometry generation is now pluggable, and a new soft shadow generator produces finite-length shadows with a soft penumbra.

ShadowCaster2D now exposes an optional custom Material, letting a shadow caster be drawn by an authored shadow shader instead of URP's built-in one.

Added a *Generate Accessibility Hierarchy toggle to the UI Document and Panel Renderer Inspectors, and the matching UIDocument.generateAccessibilityHierarchy and PanelRenderer.generateAccessibilityHierarchy properties, to opt individual components out of the generated hierarchy. The toggle is visible and takes effect only while the Generate Accessibility Hierarchies for Runtime Panels setting in Project Settings > UI Toolkit* is enabled.

Added experimental screen reader support for runtime UI Toolkit panels on Android, iOS, macOS, and Windows. The new *Generate Accessibility Hierarchies for Runtime Panels setting in Project Settings > UI Toolkit* makes UI Toolkit automatically generate and maintain accessibility hierarchies for the participating runtime panels of the application's main window, so screen readers (Narrator, VoiceOver, TalkBack) can read and operate UI Toolkit content in player builds. In this first version, only buttons, labels, and toggles (including controls derived from them) are exposed as operable controls; other elements are announced by their text when one can be derived, but don't yet expose control-specific roles or interactions. This feature is experimental and not ready for production use.

Added CPU and GPU utilization indexer integration for adaptive performance.

Added edge-to-edge rendering support with new APIs to control inset overlapping, system bars appearance, and background transparency, enabling full control over how status bar and navigation bar interact with the game view, requires Android 11+.

Added support for adaptive TV banners and monochrome icons for Android adaptive icons.

Added Vector Drawable Support for Icons.

Input System rumble support for tvOS.

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.

Make MSBuild script compilation pipeline selectable in project settings.

Added a copy and paste function for the adaptive performance component in build profiles. Copy and paste is viable if the source is fully copyable to the target.

Added a new instability detection feature to the consistency checker, for when multiple cached import results match the current context/environment. This indicates missing or inconsistent dependencies on the related importer.

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 Battery Mode for Adaptive Performance.

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

Added editing actions (cut, copy, paste, ...) to the ui Viewport context menu.

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

Added Migration Wizard to the Universal Render Pipeline.

Added support for Build Destination Override in Build Profiles.

Added support for multiple instances of the *UI Builder* window.

Added the ability for menu items to be pinned to the customizable main toolbar via the toolbar contextual menu. These elements persist across sessions and are compatible with presets.

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

Previews for items will show when performing a Drag and Drop on macOS.

Project Auditor: Add a package version database, so users know about package upgrades during Editor upgrades.

Project Auditor: Added the Target Framework column to the Precompiled Assemblies table.

Project Auditor: initial migration pages for help moving to URP and CoreCLR.

Project Auditor: suppress issues based on their ID. Similar to how IDE's allow suppression of compiler warnings.

Swift Project Type is no longer experimental.

The Editor can now build experimental CoreCLR Player builds for Windows, macOS, and Linux.

The Hierarchy window now displays the number of matching items inside the search bar when searching.

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.

Added configurable memory budgets for Entities archetype and query allocators in Project Settings > Memory, with per-platform settings support.

Added id= search filter to find entities by their index (e.g., id=27869) or full ID with version (e.g., id=27869:3).

Entities Memory profiler now shows allocator budget usage per world to identify when allocators approach their 16 MB limits.

Pressing F (Frame Selected) in the Scene View now frames the camera on selected entities.

Now supports setting the VariableNodeMode of a variable node. A variable node can operate in one of two modes: Get and Set. When a variable node is in Set mode, a new Value input is added to the node, making it possible to set the variable's value directly in the graph. It is possible to set the mode of a variable node through its inspector using the Allow to set value in graph checkbox.

URP Upscaler Priority List.

Added support for image build settings to distribute reference images through embedded packages.

Added a string-argument overload to [StubBodyIfTypeNotUsed] so that the target type can be named across an assembly boundary that the caller does not reference.

Added experimental support for IL2CPP targeting .NET on iOS. In this mode, the iOS player executes against a .NET 10 base class library (BCL). This is enabled on iOS by selecting the .NET Standard 2.1 - .NET Preview (Experimental) option in the ApiCompatibilityLevel Player setting. Note: C# code is still compiled as C# 9 and against the .NET Standard 2.1 API surface.

Added InputSettings.locationAccuracy and InputSettings.locationDistanceThreshold project defaults for location updates.

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 full-screen video support for the Swift trampoline.

Added support for Universal Links in the Swift trampoline. Links associated with the app through Associated Domains (apple-app-site-association) now set Application.absoluteURL, invoke Application.deepLinkActivated, and notify native plugins.

Input System rumble support for iOS.

Split the UnityFramework target and created public API module UnityFrameworkAPI.

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 a new upmSign command-line parameter to sign source Git packages.

Added a security confirmation prompt based on the security level selected in Project Settings.

Added a Security setting in Project Settings > Package Manager to control which package sources and signature levels are trusted in the project.

Added a packageSecurityPolicy CLI argument to set the security policy level when creating a project from the command line.

Added log warnings for installing Limited Trust packages when a project's package security level is Trusted packages only.

Added security warnings and messages to the package list and details, based on the security level selected in Project Settings.

Show the popup at project open when installed packages have signature or security compliance issues that don't meet the security level selected in Project Settings, and update its message.

Added an information panel to the Profiler's 'Screenshots' module. You can toggle the panel from the module toolbar. It shows: The selected frame number, and the resolution and source frame of the displayed screenshot. A notice when the displayed screenshot is older than the selected frame. The CPU and GPU frame times, highlighted when they exceed the target frame time.

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.

Added Smart Strings, a built-in module based on SmartFormat for formatting dynamic strings with named placeholders, pluralization, and conditional logic.

Unity Player and Editor binaries now export a C symbol named UnityScriptingBackend. Its value indicates the scripting backend the binary was built with, such as IL2CPP, CoreCLR, or Mono, so external tooling can identify the backend by inspecting the binary without running it.

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.

Added the localization module, an improved version of the Localization package. Migration support is available. For more information, refer to the documentation.

Added background gradients support for the background-image style.

Added gap property.

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 AgX as a Tonemapping mode in the Tonemapping volume override.

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

Added fixed exposure to URP. The setting can be accessed though the volume system.

Added on-tile support to the URP deferred renderer.