Manual installs
Operating systems
-Component installers
Windows
+macOS
+macOS ARM64
+Release
Release notes
+Known Issues in 2021.3.12f1
Asset Importers: Textures are not generated when Naming option in Import Settings of an FBX file is changed to "From Model's Material" (UUM-3640)
Linux: Editor crashes at "DisconnectGtkSignal(void*, GtkCallbackResponse ()(), void)" when opening floating windows (UUM-11724)
MacOS: [M1] Crash on System.Object:__icall_wrapper_ves_icall_array_new_specific when launching a project (UUM-3207)
Mono: Crash with ScanAssemblyForAttributesAndInterfaceImplementations when opening a project (1376858)
Optimization: [Mac] Editor performance drops on macOS when clicking and dragging on Position, Rotation and Scale values in Transform component (UUM-7457)
Progress Window: [2021.3][MacOS] Crash when calling "Progress.Pause" from a script (UUM-14845)
Scene Hierarchy: Undo action is not registered when undoing GameObjects list order in the Hierarchy window (UUM-16576)
Universal RP: Shader compilation time is higher in 2021.3 than in 2020.3 (UUM-17405)
Web Platform: Project fails with "UnityEditor.BuildPlayerWindow+BuildMethodException" when building for the WebGL platform (UUM-17658)
XR SRP: Meta Quest performance loss between URP versions when built (UUM-15608)
2021.3.12f1 Release Notes
Improvements
Animation: Improved animation performance across the board
Editor: Reduced the time taken to open inspectors by avoiding a pointless copy of a big thing behind the scenes
Shadergraph: Reduced time taken by code generation when a shader graph asset is imported
VFX Graph: Reduced time taken by code generation when a VFX asset is imported
API Changes
iOS: Added: Added identifiers for iPhone 14 models.
Shaders: Added: Added an API to control shader memory usage at runtime. (UUM-5583)
Changes
Editor: Update com.xr.sdk.openxr package version to 1.5.3
Editor: Updated manifest.json to use com.unity.inputsystem package version 1.4.3
XR: Updated the verified version of AR Foundation related packages to 4.2.6.
Fixes
2D: Fixed regression where GameObjects are not instantiated by Tiles when the Tilemap is not active. (UUM-14293)
Android: Fixed exporting the Android Studio project to a non-existing folder using Editor API. (UUM-1886)
Android: Interaction with PS4 touchpad won't cause navigational movement when using UGUI together with input system package. (UUM-881)
Animation: Added back old method signature for backward compatibility. (UUM-1812)
Asset Import: Fixed editor crash when importing a folder with an FBX file where its optimizeBones is set to 0. (UUM-9463)
Asset Import: Fixed import of some meshes with Blend Shape Normals set to Calculate. (UUM-7867)
Audio: Fixed unexpected output from OnAudioFilterRead when the audio source is stopped and the 'spatialize' property is enabled. (UUM-6318)
Build Pipeline: Fixed edge case where isDebugBuild would not revert to true after the build. (UUM-12064)
Editor: Add warning log when the size of a Sprite in a Secondary Texture used in a Sprite Atlas does not match its size in the Main Texture. (UUM-11164)
Editor: Fixed build process should be quicker to detect scripting backend changes when building to a pre-used folder (1421700). (UUM-1949)
Editor: Fixed case where Editor would crash when a selected renderer was deleted. (UUM-3249)
Editor: Fixed crash in standalone profiler during shutdown. (UUM-13932)
Editor: Fixed crash when opening scenes in builds that had missing Prefab sources. (UUM-2546)
Editor: Fixed dragging prefab with ctrl on linux. (UUM-1601)
Editor: Fixed inspector and documentation to reflect intended behavior. (UUM-2392)
Editor: Fixed light layers when using motion vectors. (UUM-15125)
Editor: Fixed SceneVisibilityManager exceptions when using shortcuts with no Hierarchy window. (1425103)
Editor: Fixed the "Auto-hide gizmos" preference in the Scene View page to persist value when reopening the editor. (UUM-7848)
Editor: Fixed the persistence of the position of overlays when closing and reopening the editor. (UUM-9975)
Editor: Prevented exceptions if ShortcutManager cannot read profile id from file. (UUM-9220)
GI: Fixed an issue where emission color was erroneously reused for different renderers using the same material when they have similar lightmap UVs. (UUM-2771)
Graphics: Added error message for indirect compute buffers incorrectly flagged on DX11. (UUM-899)
Graphics: Fixed an issue where TextureImporter.GetAutomaticFormat would return the incorrect format for platforms that had their override turned off. (UUM-11694)
Graphics: Fixed crash when using bad args in CommandBuffer.DrawRenderer. (HRB-20)
Graphics: Fixed issue in which editor would get stuck when importing corrupted FBX models. (UUM-3981)
Graphics: Fixed sporadic freeze in mesh upload. (UUM-4293)
Graphics: Fixed Vulkan validation error when GFR is disabled. (UUM-9583)
Graphics: Graphic and Compute Buffer allocations will now allocate less garbage collected memory. (UUM-4005)
Graphics: Updated libjpeg-turbo to version 2.1.2 to solve security issues with version 1.3.1, used by Texture2D and ImageConversion LoadImage API and ImageConversion EncodeToJPG API. (UUM-4950)
HDRP: Fixed over exposition in indoor template scenes. (UUM-11455)
HDRP: Shaders correctly fallback to error shader. (UUM-1417)
IL2CPP: Avoid an exception from Buffer.BlockCopy when the destination array is of type sbyte. (UUM-12875)
IL2CPP: Avoid an intermittent crash in the .NET thread pool implementation when a thread is incorrectly removed from the pool twice. (UUM-11191)
IL2CPP: Corrected the build of a Mac Standalone player with an exported Xcode project when script debugging is enabled. (UUM-11352)
IL2CPP: Fixed fatal error in Unity CIL Linker with RecognizedReflectionAccessPattern reporting. (UUM-13281)
IL2CPP: Fixed possible crash/corruption when invoking a virtual generic method on a generic type by reflection or when Faster (smaller) builds is enabled. (UUM-12498)
IL2CPP: Workaround an MSVC C++ compiler optimization bug related the Math.Max implementation for System.Decimal. (UUM-11487)
iOS: Disabled depth16 support on pre-iOS14 or pre-A9, since depth-bias does not work correctly. (UUM-9562)
iOS: Stop Touch.rawPosition changing position when touch is dragged. (UUM-7581)
Mono: Avoid an editor crash when the debugger code fails to lookup the signature of a method. (UUM-9219)
Mono: Avoid exception when registering a window class in different domain instances. (UUM-13189)
Mono: Fixed LINQ performance regression on linux by switching to a more efficient stack checking method. (UUM-11526)
Networking: UnityWebRequest will not change HEAD to GET on 302 or 303 response. (UUM-7274)
Networking: Upgraded curl to 7.84.0. (UUM-11134)
Package Manager: Fixed an issue where having packages with a lot of versions increases domain reload time drastically. (UUM-12670)
Physics: Fixed ArticulationBody indices not matching when using methods like GetJointPositions and GetDriveTargets. (UUM-1805)
Profiler: Fixed issue on Metal where an error message about texture binding may appear in some situations. (UUM-907)
Scene Manager: Opening a broken scene with light mapping enabled could crash the editor. (UUM-9319)
Scene/Game View: Fixed case where gizmos with bounds near the camera could be incorrectly culled. (UUM-9158)
Scripting: Fixed an issue where projects with Entities 0.51-preview.32 would fail to load if build target is WebGL
Serialization: Prevent "Objects are trying to be loaded during a domain backup. This is not allowed as it will lead to undefined behaviour!" from occuring on DomainReload when SerializeReference instance contained a Unity.Object reference to an already unloaded asset. (UUM-2116)
Shaders: Exposed Player settings to control shader memory usage at runtime. (UUM-5583)
UI Toolkit: Fixed an issue where the children of a TwoPaneSplitView would have incorrect sizes when displayed after being hidden. (UUM-2538)
UI Toolkit: Fixed EventSystem error logged in Editor when entering and leaving Play mode if there's a UIDocument in the scene. (UUM-10360)
UI Toolkit: Fixed for 2021.3.X: [UI Builder] @import is stripped from the associated .uss file when saving .uxml. (UUM-14414)
Undo System: Fixed Editor crash on GetTransformAccess when undoing GameObject duplication. (UUM-13617)
Undo System: Fixed Undo.PerformUndo causes Editor crash when undoing reparented LineRenderer. (UUM-14123)
Universal RP: Fixed default URP asset being included in builds when it wasn't supposed to be (when URP asset overrides are available for all target's quality levels). (UUM-8487)
Universal Windows Platform: Fixed float values stored in player prefs getting corrupted on startup. (UUM-14671)
URP: Added force depth prepass option when requesting the Depth Texture. (UUM-8273)
URP: Shaders correctly fallback to error shader. (UUM-1417)
VFX Graph: Create a new system then convert an operator node to subgraphs fails. (UUM-2272)
VFX Graph: Fixed flickering when sorting large systems. (UUM-9514)
Video: Editor crashes when playing a video file with 14 audio tracks in Play mode. (UUM-861)
Video: Removed spike on the main thread when changing the video clip. (UUM-878)
Video: VideoPlayer throws errors when VideoClip loaded from AssetBundle nears the end. (UUM-1888)
Web: Allow Name Files As Hashes option for Development WebGL builds as well as Non-Development builds. (UUM-1133)
WebGL: Fixed a bug where losing focus on the player would cause buttons to become stuck. (UUM-3230)
WebGL: Fixed a bug where pressing the
CMDkey on Safari would cause buttons to become stuck. (UUM-12013)WebGL: Fixed changing AudioSource.time while audio source is paused. (UUM-1157)
WebGL: Fixed division by zero error when calling AudioSource.time. (UUM-2302)
WebGL: Fixed immediate playback of scheduled audio source if AudioSource.time is changed. (UUM-1147)
WebGL: Fixed playback of audio clips on timeline. (UUM-6801)
WebGL: Improved shader compilation performance problems on MacOS when GPU instancing is used. (UUM-6390)
Package changes in 2021.3.12f1
Packages updated
Changeset
+Third Party Notices
Release notes
+Known Issues in 2021.3.12f1
Asset Importers: Textures are not generated when Naming option in Import Settings of an FBX file is changed to "From Model's Material" (UUM-3640)
Linux: Editor crashes at "DisconnectGtkSignal(void*, GtkCallbackResponse ()(), void)" when opening floating windows (UUM-11724)
MacOS: [M1] Crash on System.Object:__icall_wrapper_ves_icall_array_new_specific when launching a project (UUM-3207)
Mono: Crash with ScanAssemblyForAttributesAndInterfaceImplementations when opening a project (1376858)
Optimization: [Mac] Editor performance drops on macOS when clicking and dragging on Position, Rotation and Scale values in Transform component (UUM-7457)
Progress Window: [2021.3][MacOS] Crash when calling "Progress.Pause" from a script (UUM-14845)
Scene Hierarchy: Undo action is not registered when undoing GameObjects list order in the Hierarchy window (UUM-16576)
Universal RP: Shader compilation time is higher in 2021.3 than in 2020.3 (UUM-17405)
Web Platform: Project fails with "UnityEditor.BuildPlayerWindow+BuildMethodException" when building for the WebGL platform (UUM-17658)
XR SRP: Meta Quest performance loss between URP versions when built (UUM-15608)
2021.3.12f1 Release Notes
Improvements
Animation: Improved animation performance across the board
Editor: Reduced the time taken to open inspectors by avoiding a pointless copy of a big thing behind the scenes
Shadergraph: Reduced time taken by code generation when a shader graph asset is imported
VFX Graph: Reduced time taken by code generation when a VFX asset is imported
API Changes
iOS: Added: Added identifiers for iPhone 14 models.
Shaders: Added: Added an API to control shader memory usage at runtime. (UUM-5583)
Changes
Editor: Update com.xr.sdk.openxr package version to 1.5.3
Editor: Updated manifest.json to use com.unity.inputsystem package version 1.4.3
XR: Updated the verified version of AR Foundation related packages to 4.2.6.
Fixes
2D: Fixed regression where GameObjects are not instantiated by Tiles when the Tilemap is not active. (UUM-14293)
Android: Fixed exporting the Android Studio project to a non-existing folder using Editor API. (UUM-1886)
Android: Interaction with PS4 touchpad won't cause navigational movement when using UGUI together with input system package. (UUM-881)
Animation: Added back old method signature for backward compatibility. (UUM-1812)
Asset Import: Fixed editor crash when importing a folder with an FBX file where its optimizeBones is set to 0. (UUM-9463)
Asset Import: Fixed import of some meshes with Blend Shape Normals set to Calculate. (UUM-7867)
Audio: Fixed unexpected output from OnAudioFilterRead when the audio source is stopped and the 'spatialize' property is enabled. (UUM-6318)
Build Pipeline: Fixed edge case where isDebugBuild would not revert to true after the build. (UUM-12064)
Editor: Add warning log when the size of a Sprite in a Secondary Texture used in a Sprite Atlas does not match its size in the Main Texture. (UUM-11164)
Editor: Fixed build process should be quicker to detect scripting backend changes when building to a pre-used folder (1421700). (UUM-1949)
Editor: Fixed case where Editor would crash when a selected renderer was deleted. (UUM-3249)
Editor: Fixed crash in standalone profiler during shutdown. (UUM-13932)
Editor: Fixed crash when opening scenes in builds that had missing Prefab sources. (UUM-2546)
Editor: Fixed dragging prefab with ctrl on linux. (UUM-1601)
Editor: Fixed inspector and documentation to reflect intended behavior. (UUM-2392)
Editor: Fixed light layers when using motion vectors. (UUM-15125)
Editor: Fixed SceneVisibilityManager exceptions when using shortcuts with no Hierarchy window. (1425103)
Editor: Fixed the "Auto-hide gizmos" preference in the Scene View page to persist value when reopening the editor. (UUM-7848)
Editor: Fixed the persistence of the position of overlays when closing and reopening the editor. (UUM-9975)
Editor: Prevented exceptions if ShortcutManager cannot read profile id from file. (UUM-9220)
GI: Fixed an issue where emission color was erroneously reused for different renderers using the same material when they have similar lightmap UVs. (UUM-2771)
Graphics: Added error message for indirect compute buffers incorrectly flagged on DX11. (UUM-899)
Graphics: Fixed an issue where TextureImporter.GetAutomaticFormat would return the incorrect format for platforms that had their override turned off. (UUM-11694)
Graphics: Fixed crash when using bad args in CommandBuffer.DrawRenderer. (HRB-20)
Graphics: Fixed issue in which editor would get stuck when importing corrupted FBX models. (UUM-3981)
Graphics: Fixed sporadic freeze in mesh upload. (UUM-4293)
Graphics: Fixed Vulkan validation error when GFR is disabled. (UUM-9583)
Graphics: Graphic and Compute Buffer allocations will now allocate less garbage collected memory. (UUM-4005)
Graphics: Updated libjpeg-turbo to version 2.1.2 to solve security issues with version 1.3.1, used by Texture2D and ImageConversion LoadImage API and ImageConversion EncodeToJPG API. (UUM-4950)
HDRP: Fixed over exposition in indoor template scenes. (UUM-11455)
HDRP: Shaders correctly fallback to error shader. (UUM-1417)
IL2CPP: Avoid an exception from Buffer.BlockCopy when the destination array is of type sbyte. (UUM-12875)
IL2CPP: Avoid an intermittent crash in the .NET thread pool implementation when a thread is incorrectly removed from the pool twice. (UUM-11191)
IL2CPP: Corrected the build of a Mac Standalone player with an exported Xcode project when script debugging is enabled. (UUM-11352)
IL2CPP: Fixed fatal error in Unity CIL Linker with RecognizedReflectionAccessPattern reporting. (UUM-13281)
IL2CPP: Fixed possible crash/corruption when invoking a virtual generic method on a generic type by reflection or when Faster (smaller) builds is enabled. (UUM-12498)
IL2CPP: Workaround an MSVC C++ compiler optimization bug related the Math.Max implementation for System.Decimal. (UUM-11487)
iOS: Disabled depth16 support on pre-iOS14 or pre-A9, since depth-bias does not work correctly. (UUM-9562)
iOS: Stop Touch.rawPosition changing position when touch is dragged. (UUM-7581)
Mono: Avoid an editor crash when the debugger code fails to lookup the signature of a method. (UUM-9219)
Mono: Avoid exception when registering a window class in different domain instances. (UUM-13189)
Mono: Fixed LINQ performance regression on linux by switching to a more efficient stack checking method. (UUM-11526)
Networking: UnityWebRequest will not change HEAD to GET on 302 or 303 response. (UUM-7274)
Networking: Upgraded curl to 7.84.0. (UUM-11134)
Package Manager: Fixed an issue where having packages with a lot of versions increases domain reload time drastically. (UUM-12670)
Physics: Fixed ArticulationBody indices not matching when using methods like GetJointPositions and GetDriveTargets. (UUM-1805)
Profiler: Fixed issue on Metal where an error message about texture binding may appear in some situations. (UUM-907)
Scene Manager: Opening a broken scene with light mapping enabled could crash the editor. (UUM-9319)
Scene/Game View: Fixed case where gizmos with bounds near the camera could be incorrectly culled. (UUM-9158)
Scripting: Fixed an issue where projects with Entities 0.51-preview.32 would fail to load if build target is WebGL
Serialization: Prevent "Objects are trying to be loaded during a domain backup. This is not allowed as it will lead to undefined behaviour!" from occuring on DomainReload when SerializeReference instance contained a Unity.Object reference to an already unloaded asset. (UUM-2116)
Shaders: Exposed Player settings to control shader memory usage at runtime. (UUM-5583)
UI Toolkit: Fixed an issue where the children of a TwoPaneSplitView would have incorrect sizes when displayed after being hidden. (UUM-2538)
UI Toolkit: Fixed EventSystem error logged in Editor when entering and leaving Play mode if there's a UIDocument in the scene. (UUM-10360)
UI Toolkit: Fixed for 2021.3.X: [UI Builder] @import is stripped from the associated .uss file when saving .uxml. (UUM-14414)
Undo System: Fixed Editor crash on GetTransformAccess when undoing GameObject duplication. (UUM-13617)
Undo System: Fixed Undo.PerformUndo causes Editor crash when undoing reparented LineRenderer. (UUM-14123)
Universal RP: Fixed default URP asset being included in builds when it wasn't supposed to be (when URP asset overrides are available for all target's quality levels). (UUM-8487)
Universal Windows Platform: Fixed float values stored in player prefs getting corrupted on startup. (UUM-14671)
URP: Added force depth prepass option when requesting the Depth Texture. (UUM-8273)
URP: Shaders correctly fallback to error shader. (UUM-1417)
VFX Graph: Create a new system then convert an operator node to subgraphs fails. (UUM-2272)
VFX Graph: Fixed flickering when sorting large systems. (UUM-9514)
Video: Editor crashes when playing a video file with 14 audio tracks in Play mode. (UUM-861)
Video: Removed spike on the main thread when changing the video clip. (UUM-878)
Video: VideoPlayer throws errors when VideoClip loaded from AssetBundle nears the end. (UUM-1888)
Web: Allow Name Files As Hashes option for Development WebGL builds as well as Non-Development builds. (UUM-1133)
WebGL: Fixed a bug where losing focus on the player would cause buttons to become stuck. (UUM-3230)
WebGL: Fixed a bug where pressing the
CMDkey on Safari would cause buttons to become stuck. (UUM-12013)WebGL: Fixed changing AudioSource.time while audio source is paused. (UUM-1157)
WebGL: Fixed division by zero error when calling AudioSource.time. (UUM-2302)
WebGL: Fixed immediate playback of scheduled audio source if AudioSource.time is changed. (UUM-1147)
WebGL: Fixed playback of audio clips on timeline. (UUM-6801)
WebGL: Improved shader compilation performance problems on MacOS when GPU instancing is used. (UUM-6390)
Package changes in 2021.3.12f1
Packages updated

Find the Unity version that’s compatible with your existing projects, or that provides you with specific features unavailable in newer versions.
