New in Unity 2023.1

Release Notes

To find out more about the new features, changes, and improvements to this Unity version, refer to the 2023.1 Release Notes.

Upgrade Guide

If you are upgrading existing projects from 2022 LTS, read the Upgrade Guide to 2023.1 for information about how your project might be affected.

What’s new

Find out what’s changed in Unity 2023.1 since 2022LTS and view the documentation for the affected areas.

Adaptive Performance

• Added Lifecycle controls and a general Android provider.
• Added an Adaptive Performance Android Provider that extends the Adaptive Performance package to Android Devices.
• Added new IPerformanceModeStatus to retrieve performance mode and listen to performance mode changes.

Artist and Cinematic tools

Shader Graph

Variant Keyword Prefiltering introduces the early exclusion of “multi_compile” keywords, based on Prefiltering Attributes driven by Render Pipeline settings. This greatly reduces the amount of variants being enumerated for potential stripping and compilation. The result is a significant reduction in shader processing time.

Asset Store

Added Verified Solutions program, a library of third-party assets and solutions that Unity curates.

Asset bundles

Added capability to Asset Bundles that target Windows, OSX, and Linux platforms and the Dedicated Server subtarget so that they’re now built with the same Dedicated Server optimizations that built Dedicated Server Players receive (removing texture data and non-collision mesh data).

Asset pipeline

Implemented accessor for saving data to .meta files.

Authoring Tools

2D

• Added API to allow Sprite to get and set references to ScriptableObjects.
• Added Brush Picks to the Tile Palette window.
• Added options to create WhiteBox Tile Palettes.
• Added preference option to Tile Palette Preferences for users to choose where they would want to position their mouse cursor when painting on Tilemaps with Z Position.
• Added Sample for Custom Geometry Generation and Vertex Colors.
• Added Sprite/SpriteShape/TilemapRenderer as mask sources for SpriteMask.
• Added SRP Batching for 2D Renderers and Particle Renderer to support URP.
• Added support for camera frustum culling to Inverse Kinematics Manager 2D.
• Enabled opening Sprite Editor Window from SpriteRenderer inspector to edit the Sprite that is assigned to the SpriteRenderer.
• Enabled ScriptablePacker to add custom packing algorithm for SpriteAtlas.

2D Physics

• Added a Rigidbody2D.Slide method which allows a Rigidbody2D to be moved with a specific velocity over a specific integration time and perform various slide, gravity, slip, direction-change, and surface-anchoring behaviors automatically. This can be used on all body types including Static. This method can simply calculate a new position, change the Rigidbody2D position immediately (supports interpolation), or defer the movement by automatically calling Rigidbody2D.MovePosition(). This feature will make Character Controllers easier to create.
• Added the ability to use sub-stepping simulation when Simulation Mode is Update.
• Enabled CompositeCollider2D to allow each Collider2D to select one of four composite operations: Merge (OR), Intersect (AND), Difference (NOT), and Flip (XOR), and a composite order for controlling the order that each Collider2D will be composited.

Terrain

• Migrated Terrain Tools to the Overlays toolbar framework to ensure that users have consistent and predictable Editor Scene authoring workflows.
• Added Quality Settings to control various Terrain settings at different quality levels.

Core

Merged the APV window with the Lighting window.

Editor and Workflow

• Improved and standardized right-click context menus across items and workflows. Improvements include more consistent interactions, sorting optimizations, and an optional search field.
• Added a new launch screen for the Linux Editor.
• Added async test support with documentation and support for SetUp and TearDown to the test-framework.
• Added Editor analytics event tracking for Refresh access and New link button clicks.
• Added the Enable PlayMode Tooltips** **toggle to the preferences window. This toggle enables tooltips in the Editor while it’s in Play mode.
• Added the Helper Bar, which displays useful keyboard shortcuts, to the status bar. Enable the Helper Bar from the General tab of the Preferences window.
• Added the option for Scene View preferences to only refresh the Scene view when the Editor is in focus.
• Added an optional priority argument to Shortcut and ClutchShortcut attributes.
• Added a rebindable shortcut possibility for the Game view Stats button to the Shortcuts manager.
• Added Stage, Scope, and Dynamic information to keywords for the Frame Debugger.
• Added the possibility of running tests in a specified order from a test list.
• Added the focusedWindowChanged callback to the EditorWindow class.
• Changed to title bars on Windows for Editor. Improves upon the existing title bar feature by adding to it.
• Displayed OneTimeSetup and OneTimeTearDown durations in the XML result under outputs.
• Enabled adding a shortcut to enable or disable a capture for the Frame Debugger.
• Enabled connection to Perforce servers using accounts with MFA.
• Enabled copying a foldout or an entire event for the Frame Debugger.
• Enabled seeing the Original and Used shaders in an event for the Frame Debugger. This is useful for events that use USEPASS or fall back to an assigned fallback shader.
• Enabled setting the minimum and maximum values for the Levels slider for the Frame Debugger.
• Enabled shortcut binding to mouse wheel turns for Shortcut Manager.
• Enabled viewing the individual meshes in a SRP Batch inside the Mesh Preview for the Frame Debugger.
• Split the texture format for the Frame Debugger into Color Format and DepthStencil Format.
• Changed to title bars on Windows for the Editor.

UI Toolkit for Editor UI

• Added a Text preview to the UI Builder Inspector.
• Added an anchor widget to the Position properties in the UI Builder Inspector pane.
• Added basic analytics in UI Builder.
• Added space-evenly to Justify Content property.
• Added support for Bitmap Text.
• Added Vertex Buffer size configuration.
• Updated tooltips.

IMGUI

Removed dependency on Legacy Text stack for IMGUI so that IMGUI now renders and calculates its metrics using TextCore. Some members from TextEditor have been deprecated to accommodate for the new TextUtilities used by both IMGUI and UITK. Their meanings are the same but their names have changed (from field to property):

• TextEditor.multiline is now TextEditor.isMultiline.
• TextEditor.hasHorizontalCursorPos is nowTextEditor.hasHorizontalCursor.
• TextEditor.revealCursor is now TextEditor.showCursor.

TextMeshPro

Added support for Color Glyphs and extracting OpenType font features.

Enterprise deployment

• Added support on Windows for Automatic proxy configuration. With this feature, you can use Unity applications seamlessly in a web proxy environment, with minimal configuration.
• If you use Unity on a Windows computer that lacks elevated privileges, you can enable the installation of Unity Editors by standard users.

图形

• Added Screen Space Lens Flares that you can generate from all lights visible on the screen (direct, indirect, emissive surfaces, specular highlights) in just a few clicks with a single post-processing volume. These lens flares are compatible with both HDRP and URP. This feature complements the Lens Flare (SRP) component, which gives you more advanced artistic control over lens flares from lights, but can only be used on predefined light sources (directional, point and spot lights), and can only be manually associated with each one.
• Dynamic shader variant loading provides additional user control over shader loading behavior and memory usage. This optimization enables the streaming of shader data chunks into memory, and eviction of shader data that is no longer needed at runtime, based on a user controlled memory budget. This allows to significantly reduce shader memory usage on platforms with limited memory budgets.
• Added asynchronous compilation of pipeline state objects for shader warmup.
• Added DirectX Raytracing (DXR) 1.1 support in compute shaders. Added the following APIs: SystemInfo.supportsInlineRayTracing, SystemInfo.supportsRayTracingShaders, ComputeShader.SetRayTracingAccelerationStructure, and CommandBuffer.SetRayTracingAccelerationStructure(ComputeShader, …).
• Added #pragma require inlineraytracing to compute shaders.
• Added new RayTracingAccelerationStructure.AddInstance signature that allows adding mesh instances to the acceleration structure for GPU ray tracing. This is the equivalent of Graphics.RenderMesh from the rasterization pipeline.
• Added foveated rendering support for D3D12/Vulkan.
• Added foveated rendering support for Metal.
• Added support for loading EXR data through ImageConversion.LoadImage().
• Added support for VK_EXT_debug_utils on Vulkan platforms.
• Added mipmap limit groups, for more fine-grained configurability over the single value that applies to all mipmapped Texture2D assets.
• Added the ability in the Texture2D importer and constructor to add the texture to a project-defined mipmap limit group for more fine-grained control of how texture quality is affected per quality level.
• Added the ability in the Texture2D importer and constructor to exclude the texture from mipmap limits, ensuring that all mipmap levels can be uploaded regardless of the quality settings.
• Added a runtime-modifiable Texture2D property to toggle excluding readable textures from mipmap limits.
• Added the ability to compute the thickness of an Object.
• Enabled Ray Tracing Support in Terrain settings by default for new Terrains.
• Implemented ScriptableRenderContext.CullShadowCasters API to kick theBatchRendererGroup culling jobs earlier in URP and HDRP.
• Added standardized shader variant keyword for native 16-bit shader types.
• Added standardized shader variant keywords for wave operations.
• Added debug view to visualize probe sampling.

Lighting

• Introduced the new LightBaker v1.0 backend for manual lighting bakes, which makes baking more predictable and stable. Manual bakes no longer restart if you change the scene during baking; therefore, the Editor is more responsive during baking. If you bake with the GPU backend, you can use a Baking Profile to select the tradeoff between performance and GPU memory usage.

Universal Render Pipeline (URP)

For a complete description of new features and improvements in URP, refer to What’s new in URP.

New features in URP

• Added temporal anti-aliasing (TAA) support which is available from Camera Anti-aliasing settings. Incompatible with MSAA, Dynamic Resolution, or Camera stacking. Supports fixed resolution only, so no temporal upsampling is supported.
• Added support for High Dynamic Range (HDR) output.
• Added Detailed Stats to URP Rendering Debugger.
• Ported all URP passes to use the RasterCommandBuffer API.
• Added AO Method dropdown for SSAO to select Interleaved Gradient Noise or Blue Noise.
• Added Blur Quality dropdown for SSAO to select High (Bilateral), Medium (Gaussian), or Low (Single-Pass Kawase).
• Added clustered reflection probe support to the URP Forward+ rendering path. This enables the use of more than two reflection probes per object, allows Unity to skip per-object culling of lights and reflection probes, and enables Entities Graphics and procedural draws to make use of reflection probes.
• Added Custom Post Processing (zero code path) feature in URP.
• Added Decal support to Render Graph.
• Added falloff field for SSAO to control the distance from the camera that the AO should affect.
• Added RenderGraph support to URP postFX.
• Added shadow interoperability with Sprite, Colliders, SpriteShape, and 2D Animation.
• Added soft shadow rendering. Shadow softness can be set on shadow casting Light2Ds.
• Added a limited version of Probe Volumes, with no interpolation of lighting data sets, and limited performance on lower end hardware.

Improvements in URP

• Improved FXAA quality. The changes result in an improved edge AA (removing odd edge artifacting seen before) while better retaining texture quality. The performance requirements are expected to be unchanged. Output quality should now be similar to the low and medium SMAA presets while still having better performance.

High Definition Render Pipeline (HDRP)

For a complete description of new features and improvements in URP, refer to What’s new in HDRP.

New Features in HDRP

• Light Layers and Decal Layers are now managed in similar ways in both HDRP and URP. In HDRP they will now share the first 16 Rendering Layers, instead of using 8 separate bits each. Additionally, an option was added in the HDRP Asset to allow access to a full screen buffer containing the Rendering Layers Masks of rendered Objects. That buffer can be sampled from the ShaderGraph through the HD Sample Buffer node, and be used to implement custom effects, like outlining objects on a specific rendering layer.
• All Ray Tracing HDRP features (raytraced shadows, reflections, AO, global illumination, path tracing, recursive rendering,…) are officially out of experimental in Unity 2023.1.0.
• Added a foam system to the HDRP Water System.
• Probe Volumes are out of experimental. Revamped the control interface to provide a better experience when you place Probe Volumes, light dynamic objects and some static objects, stream data from GPU memory, interpolate lighting data sets, and work with volumetric fog and particles.
• Added a third level of noise for volumetric clouds.
• Added Generic Rendering Layer mode support.
• Added High Quality Line Rendering which unlocks improved performance and image quality for line topology.
• Added improvements to the SSS lighting model.
• Added Ray Tracing Terrain support for HDRP.
• Added raytraced shadows for Pyramid and Box shaped Spot Lights.
• Added the Ray Tracing Light Cluster to Path Tracer.
• Added volumetric material support for local volumetric fog volumes.
• Exposed Material Type in materials using the Lit Shader Graph.
• Improved stripping of unused features.
• Specular color on HDRP/Lit and HDRP/StackLit below 2% can be used to suppress specular lighting completely when “Specular Fade” is enabled.

Improvements in HDRP

• Improved the water rendering system in the following ways:
  • Added functionality to Water Mask so it dynamically removes water from inside a boat or in a cave in the middle of an island.
  • Modified the water deformer to dynamically deform water locally. For example, to deform water around a moving ship, deform waves near shores, or deform water in a vortex.
  • Added flow maps to create local currents, to manage surface waves that follow currents, and the water query API to allow objects to drift.
  • Added a water line to manage the transition for cameras that are half underwater.
  • Improved visual quality of water.
  • Improved the UX of the water system.
• Added an extra optional pass to compute thickness of transparent objects at runtime to get more accurate refraction and transparency rendering.
• Improved visual quality when using temporal anti-aliasing (TAA) with two new options to perform sharpening. The first option is a post-process pass that offers higher quality sharpening, control over the amount of sharpening, and an option to reduce possible ringing artifacts. The second option is to run Contrast Adaptive Sharpening from AMD FidelityFX.
• Specular light can now be completely faded when using a specular color workflow using the HDRP/Lit and HDRP/StackLit shaders by toggling a new option that can be found in the HDRP Global Settings under Miscellaneous/Specular Fade.

Multiplayer tools

Added Multiplayer Play Mode as an experimental feature. Multiplayer Play Mode is a workflow improvement feature from our multiplayer toolset that aims to deliver a user experience that is “single-player like”, but with a focus on the development cycle of multiplayer games.

Networking

Added new Dedicated Server Standalone player options to assembly definition exclude and include platform lists.

Package Manager

• Added functionality to track assets imported from an Asset Store package:
  • Added an Imported Assets tab in the package details view (My Assets) to visualize imported assets.
  • Added a Remove button and window for Asset Store packages, to selectively remove imported assets.
• Enhanced the user experience for deprecated packages. The Unity Editor notifies users at startup if their project has any deprecated packages. Updated the Package Manager window to identify two types of package deprecation:
  • Packages that reach their end of life and are no longer supported in the given Editor.
  • A specific version of a package marked as deprecated.
• Added Web3 as a category in the Filters menu when viewing My Assets.
• Changed the default sorting in the My Assets view to Purchased date, to match the default sort method in Asset Store.
• Changed the install menu items to start with Install instead of Add.

VFX Graph

• Added a new output to modify the volumetric fog of HDRP.
• Added VFX integration in Ray Tracing.
• Fixed the six-way lighting and lightmap remapping options.
• Optimized CPU and GPU VFX runtime in VFX Instancing.

Platform Graphics

• Introduced a new graphics jobs threading mode called Split Graphics Jobs that is proven to reduce unnecessary begin and end of frame synchronization between the main and native graphics job threads. The Unity Testing team observed significant performance improvements when targeting DX12 using Split Graphics Jobs over DX11.

Android

• Added support for texture compression targeting which compresses textures multiple times using different formats. This helps to serve optimized APKs for different Android devices. For more information, refer to Texture compression targeting.
• Added the Android Project Configuration Manager which is a flexible and robust way to configure Android Gradle settings. This replaces the old method of using templates. For more information, refer to Android Project Configuration Manager.
• Added support for GameActivity, which is an application model available for Android projects powered by Android’s Game Development Kit. It provides more control over the essential parts of an application, gives more freedom and flexibility in the core code, and minimizes the amount of JNI that an application needs to use. It also improves how games work with Jetpack components, enables you to overlay native elements, and helps you more easily take advantage of new platform features. For more information, refer to The GameActivity application entry point.
• Added support for build and run on Chrome OS devices. You can now enter a device’s IP directly into Unity to fast deploy to that device. For more information, refer to Build for Chrome OS.
• Extended Unity’s Memory API to take advantage of Google Memory Advice library. This provides you with fine-grained information on memory usage which you can use to adjust your application accordingly.
• Exposed Android’s reportFullyDrawn API so you can get more accurate information on your application’s startup time, one of the major metrics of user experience. This gives you a better understanding of your application’s cold and warm start rates across devices which you can use to further optimize the application.
• Added build_fingerprint information to Android builds.

WebGL

• Extended the diagnostics overlay in web builds with more metrics and graphs.
• Improved console error message logs when Content-Encoding: gzip is not properly set on server, or when a web browser has a bug that prevents it from being able to decompress gzip content.

Windows

Enabled Windows ARM64 Player compilation. For more information, visit the System Requirements page.

Programmer tools

Kernel

Added functionality to control player connection listen port.

Version Control

• Added a new Branch Name column in the Changesets view.
• Added changelist related options to pending changes context menu.
• Added option to enable changelists and display them in pending changes tab.

Scripting

Added an option to display C# source code line numbers in call stacks in player builds.

Profiler

• Added metadata support for RenderTextures in Memory Profiler.
• Improved graphics memory tracking in Memory Profiler.

Ray tracing API

The Ray Tracing API is officially out of experimental status in Unity 2023.1. This change is introduced after recent improvements to the Ray Tracing API, ranging from stability and performance to additional compatibility with the engine’s existing feature set.

SpeedTree

HDRP/Nature/SpeedTree8.shadergraph now uses its Subsurface Map for the Transmission Mask node to remove the unintended light transmission from tree barks and twigs. This also fixes the overly bright billboard lighting which didn’t quite match the 3D geometry’s lighting.

UTP

Experimental Feature Release

The Unity Transport Protocol (or UTP) is a lower-level networking infrastructure that handles the transport of data across the network and across connected platforms and devices. In the most recent release we are enabling Web and TCP connections to improve the reach of our netcode solutions (like Netcode for Gameobjects and Netcode for Entities).

Video

• Enabled VideoPlayer time update mode for PS4 and PS5.
• WebGL VideoPlayer now has a configurable time update mode, to support game time, unscaled game time and audio dsp time.

Visual Scripting

• Added a confirmation dialog when you reset assemblies and types in Project settings.
• Added a confirmation dialog when you reset Project settings and Editor preferences.
• Added Sticky Notes for ScriptGraph and StateGraph.
• Added support for parameter renaming in code used by API nodes.
• Added support for nodes to have a button which triggers a custom action in their Inspector description.
• Added support for nodes whose type cannot be found to now be temporarily converted to placeholder nodes until either their original type is defined again or the user replaces them.