Unity 2022.3.8

Select the runtime platforms of your choice from the list below (the desktop runtime is included as standard) or, to install the full complement of runtime platforms, use the download assistant installer above.
New to Unity? Get started

Known Issues in 2022.3.8f1

  • Addressable Assets: The released assets are not unloaded when Resources.UnloadUnusedAssets is called (UUM-37775)

  • Asset Importers: OnImportAsset leaks 5GB of memory (UUM-43067)

  • Culling: [Mobile] Player freezes on "UnityClassic::Baselib_SystemFutex_Wait" or silently crashes (UUM-41806)

  • Graphics Device Features: Severe performance degradation in Play Mode when using multiple Cameras with “Direct3D12”, “OpenGLCore”, and “OpenGLES3” Graphics APIs in URP & HDRP (UUM-42795)

  • HD RP: ArgumentException errors are thrown when selecting a Lens Flare (SRP) asset (UUM-44061)

  • Input: The device selection menu does not respond to mouse clicks when trying to add a device in a Control Scheme (UUM-40635)

  • OpenGL: [Linux][URP][OpenGL] Scene View has a red texture overlay when the project is using URP and OpenGLCore Graphics API (UUM-44222)

  • Serialization: Crash and or slow update when List items are reordered in the Inspector Window (UUM-46703)

  • Serialization: Crash on SerializedProperty_CUSTOM_GetStringValueInternal when renaming a ScriptableObject Asset (UUM-41704)

  • UI Toolkit Framework: "ArgumentNullException" error in the Console when selecting certain ScriptableObjects and entering Play Mode (UUM-39898)

  • Universal RP: Rendering stops and an “ArgumentNullException” error appears when disabling Camera’s “Dynamic Resolution” setting (UUM-44988)

  • Universal RP: [URP][XR] Performance degradation when comparing Android Quest 2 builds across 2020.3 and 2023.x (UUM-33025)

2022.3.8f1 Release Notes


  • Animation: Improved performance of AnimatorOverrideController.ApplyOverrides(). (UUM-39762)

  • Burst: Added ability to support hashing against different target frameworks.

  • Burst: Added support for default interface methods.

  • Burst: Added support for string interpolation in exception messages.

  • Burst: Added support for Math.Clamp (this API is available when Api Compatibility Level is set to .NET Standard 2.1).

  • Documentation: Added initial User Manual docs for visionOS.

  • Editor: The audio mute button in the game view toolbar uses less time per frame. (UUM-36729)

API Changes

  • Build Pipeline: Added: Added "Dedicated Server optimizations" option that strips all shaders from Dedicated Server builds.

  • Build Pipeline: Added: New signature for BuildPipeline.BuildAssetBundles.

  • SRP Core: Added: Added callbacks when RenderPipeline is created or disposed. (UUM-20646)


  • Burst: Direct call is now correctly disabled for methods that are decorated with both [BurstCompile] and [UnmanagedCallersOnly] attributes (such methods shouldn't be called directly from managed code).


  • Animation: Fixed AnimationWindowCurve evaluation error after step. (UUM-30927)

  • Animation: Fixed AnimationWindowCurve evaluation error after step. (UUM-31316)

  • Animation: Fixed memory leak in asset import process. (UUM-33327)

  • Animation: Internal - Fix leak when opening a scene containing a subscene containing animator objects. (UUM-40709)

  • Apple TV: Fixed native test PluginInterfaceProfilerCallbacks.FileOperation_CallsCallback. (UUM-763)

  • Asset Bundles: Fixed an issue where shaders in asset bundles built with older Unity versions could treat material keywords as invalid when using SubShaders.

  • Audio: Fixed Audio Reverb Zone's not being affected by the global volume setting when the Spatial Blend of the Audio Source is lower than 1. (UUM-18191)

  • Build Pipeline: Fixed AssetBundle incremental build needs to detect script namespace/assembly change. (UUM-35766)

  • Build Pipeline: Fixed incorrect AssetBundle dependencies are generated. (UUM-43175)

  • Build Pipeline: Fixed lost sprite references in bundles when moving the assets. (UUM-16394)

  • Build System: Clang fails when header file mtimes are updated and a precompiled header isn't regenerated. (UUM-44429)

  • Burst: Fixed a compile-time performance regression in 1.8.7 that could result in slower Burst compilation and increased memory usage during compilation.

  • Burst: Fixed a possible source of invalid alignment, avx2 storing to stack was given a slot with the wrong alignment.

  • Burst: Fixed burst not being able to find external function leading to crashing the Editor.

  • Burst: Fixed Burst sometimes returning wrong value for static readonly fields or static constructors.

  • Burst: Fixed compiler crash when compiling different assemblies that define methods or types with the exact same name and namespace.

  • Burst: Fixed error when trying to use direct call to a nested protected class.

  • Burst: Fixed that converting a negated unsigned type to a float would produce a mismatching value in Burst versus .Net/Mono.

  • Burst: Fixed that jobs wouldn't be Burst compiled for player builds with high stripping.

  • Burst: Fixed that the Burst Inspector handled negation of unsigned types differently than .Net for static readonly fields or static constructors.

  • Burst: Fixed using Armv9 target in the Burst Inspector not formatting the assembly.

  • Burst: Fixed wrong alignment for v128 when doing an indirect access.

  • Burst: Fixed System.NotImplementedException: Unimplemented Instruction Extension Tail_ error when the code contained tail-calls.

  • Burst: Fixed uint to float conversion edge-case.

  • Burst: Prevented Burst emitting errors even when Burst was disabled via the --burst-disable-compilation command line option.

  • Burst: Under some conditions (if the error in compilation occurred in a location that didn't have valid debug information), building a player might not generate any files, and not display any errors.

  • Core: Fixed an issue where object creation was recorded on a non-main thread, causing a nullptr in the ObjectDispatcher.

  • Core: ForEach jobs no longer allocate internal data using the TempJob allocator, eliminating one source of 'possible leak' warnings for long-running jobs. (UUM-45532)

  • Documentation: Added missing link in physics (physX) documentation. There was an hyper-link missing referring to CompoundColliders.

  • DX12: Fixed sub meshes not being visible sometimes in ray tracing effects on AMD GPUs. (UUM-44073)

  • Editor: Calculate Mask value fix for last layer selection in RenderingLayerMask. (UUM-29344)

  • Editor: Clicking a foldout with Alt held will now set all child foldouts to the same expanded state when they are bound to SerializedProperty.isExpanded. (UUM-36151)

  • Editor: Ensured ExecuteInEditMode warning when entering playmode will fit in a dialog box. (UUM-44500)

  • Editor: Fixed a bug where 2D collider gizmos were not rendered when selecting the parent. (UUM-41829)

  • Editor: Fixed ASAN errors sometimes happening in Editor UI tests. (UUM-27445)

  • Editor: Fixed case where variant Inspector context was not disabled as intended. (UUM-44331)

  • Editor: Fixed occasional Editor crash in batch mode. (UUM-22301)

  • Editor: Fixed preset glob search with multiple character ranges. (UUM-26398)

  • Editor: Fixed rare deadlock that can occur when building DOTS based projects. (UUM-46148)

  • Editor: Fixed shutdown crash caused by nullptr dereference inside WorkerManagerASIO. (UUM-43024)

  • Editor: Fixed Sprite previews when go out from Play Mode and URP in use. (UUM-41498)

  • Editor: Fixed the error message when binding a shortcut with an invalid key. (UUM-43122)

  • Editor: Fixed Unity crash when trying to reopen project with Package Manager resolution error. (UUM-43054)

  • Editor: Prevent blendshape normals calculation when mesh normal is set to Calculate and blendshape normals is set to None. (UUM-36071)

  • Editor: Prevent C4D native importer warnings if a project has its own C4D ScriptedImporter. (UUM-36242)

  • Editor: Updated UI/Docs for previewing audio clip in inspector. (UUM-16395)

  • GI: Detecting invalid data in lighting data assets in order to avoid a crash. (UUM-27652)

  • Graphics: DrawProcedural family of functions now also work when shaders want vertexbuffers. (UUM-32295)

  • Graphics: Fixed a crash (or memory leak) caused when using AABBs procedural geometries in a RayTracingAccelerationStructure. (UUM-43293)

  • Graphics: Fixed crashing without error on VK and GL when wrong Graphics Buffer Target is set. (UUM-42421)

  • Graphics: Fixed incorrect clamping of maxComputeBufferInputs when VkPhysicalDeviceLimits::maxPerStageDescriptorStorageBuffers is max unsigned integer. (UUM-43741)

  • Graphics: Fixed null pointer exception on the player when none of the quality levels were assigned. (UUM-43265)

  • Graphics: Fixed texture memory leaks for asynchronous scene loads. (UUM-35265)

  • Graphics: Modified doc as camera distance calculation is coupled with camera. (UUM-12523)

  • HDRP: Fixed custom pass injection point "After Opaque And Sky" happening after cloud rendering.

  • HDRP: Fixed FTLP (Fine Tiled Light Pruning) Shader Options max light count. Previous support only supported up to 63 These changes allow to go up to 255 with higher instability as numbers per tile approach 255.<br> For support greater than 255, do it at your own risk! (and expect some flickering). (UUM-39924)

  • HDRP: Fixed the incorrect size of the material preview texture. (UUM-31221)

  • HDRP: Mixed runtime lights were not considering the intensity multiplier during bakes. These changes fix this behaviour and make bakes more intuitive. (UUM-41081)

  • IL2CPP: Allow the number of thread local storage slots to grow at runtime. (UUM-31808)

  • IL2CPP: Fixed a deadlock when quitting WebGL Player when the code utilized System.ThreadPool. (UUM-32717)

  • iOS: Fixed attach managed debugger window not showing up and causing application to be in frozen state. (UUM-39644)

  • Linux: Fixed Vulkan falsely reporting that HDR is supported on Linux. (UUM-43364)

  • Linux: Prevent paused unity player from using excessive CPU when "run in the background" option is off. (UUM-38092)

  • Package Manager: Disabled documentation link button when it's unavailable. (UUM-45844)

  • Package Manager: Fixed the issue where packages in My Assets are loading forever. (UUM-45604)

  • Package Manager: Show the package technical name of a UPM on A$ in the editor.

  • Particles: Fixed potential crash on deletion of particle systems with mesh particles. (UUM-26623)

  • Physics: Fixed an issue on OSX where Physics.Simulate would experience hickus due to how the PhysX task system was being integrated with Unity's Job System. (UUM-27803)

  • Physics: Fixed small bodies starting to tunnel through large bodies in continuous collision detection mode at high simulation frequencies (~200Hz). (UUM-19349)

  • Scene/Game View: Fixed a slight pause in the Scene View's camera movement when rapidly changing between arrow keys of opposite directions. (UUM-42170)

  • Scene/Game View: Fixed an issue where shader dispatch events would not show up in GameView's RenderDoc capture data. (UUM-29955)

  • Scene/Game View: Fixed the Scene View mouse jumping to only be set when the view tools are active. (UUM-33675)

  • Scripting: PrefabUtilitiy.InstantiateAttachedAsset is deprecated. (UUM-33714)

  • Scripting: Respect Reference Validation Plugin setting. (UUM-32855)

  • Serialization: Fixed the TypeDB path in BuildPlayerDataGenerator. (UUM-28069)

  • Shaders: Fixed Editor crashing sometimes when importing shaders. (UUM-42369)

  • Shaders: Shader warmup was not being skipped through SRP initialization.<br> This could cause GPU hangs if the user specifies a shader preloading asset. This functionality should only occur for open gl platforms. (UUM-43199)

  • Tests: Fixed for 2022.3.X: [INSTABILITY]: MouseEnterLeaveWhenElementIsMoved. (UUM-41198)

  • Tests: Fixed for 2022.3.X: [INSTABILITY]: MouseEnterLeaveWhenElementIsResized. (UUM-41218)

  • Tests: Fixed for 2022.3.X: [INSTABILITY]: MouseEnterLeaveWhenElementTransformChanges. (UUM-41219)

  • UI Toolkit: Added the TextField focus when used inside a TreeView. (UUM-42629)

  • UI Toolkit: Fixed an issue in the UI Builder that would cause an exception when using a CustomRenderTexture where a RenderTexture was expected. (UUM-37729)

  • UI Toolkit: Fixed an issue in the UI Builder where editing an element in-canvas would sometimes have an offset. (UUM-17577)

  • UI Toolkit: Fixed contentContainer for RadioButtonGroup. (UUM-39830)

  • UI Toolkit: Fixed gaps between background repeat stamps. (UUM-36753)

  • UI Toolkit: Fixed RadioButtonGroup choices not being cleared properly. (UUM-40687)

  • UI Toolkit: Fixed USS files reordering in UI Builder. (UUM-37728)

  • Universal RP: Fixed runtime performance drops when multiple views that uses incompatible RTHandle descriptors are rendered within a frame. (UUM-40249)

  • Version Control: Fixed an existing checkout operation has locked the workspace, triggered by saving the current scene at check-in.

  • Version Control: Fixed Unity Version Control toolbar icon disappearing.

  • VFX Graph: Blocks and operators sampling Depth or Color now work with Dynamic Resolution Scaling. (UUM-546)

  • VFX Graph: Fixed a compilation error when using Cube outputs with a texture shared with another context. (UUM-41037)

  • VFX Graph: Fixed console errors when deleting VFX asset in some configuration. (UUM-41333)

  • VFX Graph: Fixed HDRP Decal Output when system is in world space. (UUM-41091)

  • VFX Graph: Fixed undefined behavior of SpawnerSetAttribute when an expression is connected to activation slot. (UUM-35461)

  • VFX Graph: Incorrect Behavior while switching from old to new SG Integration. (UUM-40925)

  • VFX Graph: Incorrect Material Settings status while changing Material Override in URP. (UUM-42220)

  • VFX Graph: Undefined sorting mode with SpriteLit/SpriteUnlit, now sorted when automatic sorting is on. (UUM-22486)

  • VFX Graph: Unexpected error while using SpriteLit/SpriteUnlit target. (UUM-22349)

  • Video: [iOS] White screen is displayed instead of the video, and "Cannot read file" is logged after resuming the video if Video Player was paused and the app was minimized and opened. (UUM-40973)

  • Visual Scripting: Fixed code for custom nodes being stripped in AOT builds when Managed Stripping Level is set to High. (UVSB-2437)

  • Visual Scripting: Fixed migration deserialization bug introduced in 1.8.0. (UVSB-2492)

  • Web: Added stickyCursorLock API to make cursor lock "sticky" or "unsticky". Sticky cursor lock means that if the browser unlocks the cursor when the user presses the ESC key, the cursor will remain locked in Unity. To match the browser's behavior, users can set the stickyCursorLock to false, which will "unstick" the cursor lock. (UUM-16915)

  • WebGL: Fixed a bug where the application's background image wouldn't appear while loading if compression was enabled. (UUM-8692)

  • Windows: Fixed possible crash where non client area is redrawn before player is fully initialized. (UUM-43075)


Third Party Notices

For more information please see our Open Source Software Licenses FAQ on the Unity Support Portal