Unity 2021.3.17

Released:
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 2021.3.17f1

  • 2D: [URP] Memory leak when in Play Mode (UUM-19089)

  • IMGUI Framework: Array values aren't changed when altering them in a custom EditorWindow (UUM-15645)

  • MacOS: Crash on __pthread_kill when dragging Sprites into the Scene view (UUM-20950)

  • MacOS: Crash on __pthread_kill when multi-clicking on "Build and Publish" in the "LEGO Microgame" project (UUM-22236)

  • MacOS: [2D Platformer Microgame] 2D Platformer Microgame Project crash on __cxxabiv1::__aligned_malloc_with_fallback when pinching out or in on the trackpad during “Zoom in and out” step (UUM-20720)

  • 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)

  • Video: [Android] Application crashes when changing the source URL of a video player in Android (UUM-20661)

  • Visual Effects: [VFX Graph] Opaque Unlit Output don't write to Depth (UUM-19559)

2021.3.17f1 Release Notes

Features

  • Visual Scripting: Added confirmation popup when resetting assemblies/types in project settings.

  • Visual Scripting: Added confirmation popup when resetting project settings and editor preferences.

  • Visual Scripting: Added Sticky Note for ScriptGraph and StateGraph.

  • Visual Scripting: Nodes may now have a button which triggers a custom action in their inspector description.

  • Visual Scripting: Nodes whose type cannot be found are now temporarily converted to dummy nodes until either their original type is defined again or the user replaces them.

  • Visual Scripting: Support for parameter renaming in code used by API nodes.

Improvements

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

  • Asset Import: Reduced the overhead of asset importing by limiting the number of copies of internal parameter structs.

  • GI: Added a toggle for automatic recalculation of environment lighting in the Workflow section of the Lighting window. (UUM-13907)

  • Package: Updated version of com.unity.learn.iet-framework to 3.1.1.

  • Package: Updated version of com.unity.learn.iet-framework.authoring to 1.2.1.

  • VFX Graph: Added a toggle in both VFX preferences in VFX Graph view to allow shader debug symbols with generated shaders. (UUM-19517)

API Changes

  • Core: Added: Use these methods for improved performance when operating on both positions and rotations at the same time.<br> Transform.GetLocalPositionAndRotation()<br> Transform.GetPositionAndRotation()<br> TransformAccess.GetLocalPositionAndRotation()<br> TransformAccess.GetPositionAndRotation()<br> TransformAccess.SetLocalPositionAndRotation()<br> TransformAccess.SetPositionAndRotation()

Changes

  • Editor: Updated the Unity FBX SDK bindings to version 4.1.2. which update Autodesk FBX SDK to 2020.3.2.

  • Visual Scripting: AOTStubs are now generated for all nodes regardless of whether they represent a runtime or editor member. (UVSB-2381)

  • Visual Scripting: Increased zoom out distance in graphs.

  • XR: Updated com.unity.xr.openxr package version to 1.6.0.

  • XR: Updated XR Core Utilities to 2.0.1.

Fixes

  • Fixed Autodesk FBX and SketchUp SDK vulnerabilities. (UNITY-SEC-JAN-2023-1)

  • 2D: Added proper manual URL for GridSelection. (UUM-20223)

  • 2D: Fixed Case where there is Sprite Atlas warning in console when loading sprite in playmode. (UUM-18521)

  • 2D: Fixed collider shapes for a TilemapCollider2D when rotated Tiles are used with a collider offset.

  • 2D: Fixed crash when there is an invalid Sprite on a Tilemap and a TilemapRenderer tries to bind the invalid Sprite to a Sprite Atlas. (UUM-19275)

  • 2D: Fixed rendering of GameObjects in a Tile Palette window when a Scriptable Render Pipeline is used. (UUM-22035)

  • 2D: Fixed sorting of Tiles in a TilemapRenderer when the Sprites of the Tiles in the TilemapRenderer come from different Texture sources and Sprites with large vertex/index counts are rendered first due to batching. (UUM-18345)

  • 2D: Fixed Sprite Mode field is empty upon changing Texture Type to Sprite in TextureImporter. (UUM-16278)

  • 2D: Removed hiding tint in Sprites/Default shader. (UUM-19330)

  • 2D: [com.unity.2d.psdimporter] Fixed an issue where an error would be shown when selecting Import Mode: Merged.

  • 2D: [com.unity.2d.psdimporter] Fixed an issue where the amount of alpha removed from layers would not be re-applied as final position offset of the layers.

  • 2D: [com.unity.2d.psdimporter] Fixed an issue where the editor would crash when importing .psd/.psb files with their layers outside of the document canvas. (DANB-285)

  • 2D: [com.unity.2d.psdimporter] Fixed an issue where the generated GameObjects would be laid out differently from how they appear in the DCC tool. (DANB-298)

  • 2D: [com.unity.2d.tilemap.extras][GameObjectBrush] Fix placement of GameObjects when Cell Gap is set.

  • 2D: [com.unity.2d.tilemap.extras][GridInformation] Implement IEquatable for GridInformationKey.

  • 2D: [com.unity.2d.tilemap.extras][PrefabRandomBrush] Fix possible NullReferenceException in PrefabRandomBrush.

  • AI: Fixed a blocked passage due to seemingly valid polygons after an obstacle carved the NavMesh nearby. (UUM-8240)

  • Android: Fixed error 'Source directory '....'. is not a directory when Symlink Sources option is on. (UUM-884)

  • Asset Pipeline: Fixed an issue where the standalone profiler could crash or emit errors when the script domain reloads in the editor. (UUM-19179)

  • Audio: Updated FMOD's FLAC from version 1.2.1 to 1.3.4. This fixes an issue identified by our application security team. (UUM-400)

  • Build Pipeline: Fixed static batching sorting to ensure deterministic build results. (UUM-11427)

  • DX12: Fixed stalls in asynchronous scene loading with a large number of reflection probes. (UUM-20766)

  • Editor: Ensure scene view outline render uses the attributed main texture property name rather than the default name. (UUM-20416)

  • Editor: Fixed a bug on Chrome on iOS where the WebGL canvas cannot regain focus after losing it. (UUM-1166)

  • Editor: Fixed a crash when a window is closed during EditorWindow.OnLostFocus. (UUM-12434)

  • Editor: Fixed a deadlock that can occur when MasterTextureLimit is changed while a texture has an in-progress upload request. (UUM-16491)

  • Editor: Fixed API for users sending analytics as json formatted strings.

  • Editor: Fixed camera roll animations import. (UUM-15444)

  • Editor: Fixed character encoding for error messages in the Unity Accelerator. (UUM-16372)

  • Editor: Fixed crash issue with very large project import when the amount of descriptors grows unusually high. (UUM-20186)

  • Editor: Fixed crash/validation error when loading old Vulkan shaders from asset bundles.

  • Editor: Fixed documentation links for Script Graph and State Graphs assets. (UVSB-2422)

  • Editor: Fixed Editor crash when calling API's to show modal dialogs while -drawRect is in progress. (UUM-2293)

  • Editor: Fixed EditorWindow maximum size calculations when using a display not at integer scaling. (UUM-12808)

  • Editor: Fixed for scene hierarchy order change when entering Play mode in the Mobile Template. (UUM-13298)

  • Editor: Fixed Highlighter.Highlight does not disappear when the highlighted element disappears from view. (UUM-3535)

  • Editor: Fixed issue on Windows where modal dialogs can get the Editor stuck if they are launched from a window that closes itself. (UUM-21096)

  • Editor: Fixed issue where mouse up and mouse down events were reported twice in OnGUI when using the Device Simulator. (UUM-14340)

  • Editor: Fixed null reference exception in the FreeCamera component when there is no keyboard. (UUM-17801)

  • Editor: Fixed sub graphs being shown with broken connections on first load as of Unity 2021.2. (UVSB-2345)

  • Editor: Fixed t:prefab in AssetProvider only yields files ending in .prefab (no fbx or obj anymore). (UUM-18200)

  • Editor: Fixed that on Mac when hovering over arrow in the Hierarchy to open Prefab in Prefab Mode the tooltip displays shortcut as "Alt" and not "Option". (UUM-15760)

  • Editor: Fixed unexpected rendering when Fragment Normal uses Object Space. (UUM-10045)

  • Editor: Metal no longer crash when using shader referencing POSITION with mesh missing this attr. (UUM-20796)

  • Editor: OpenSSL updated to 1.1.1s to address. (UUM-18983)

  • Editor: Some gamepad inputs were being mapped to keyboard keys on 2021.3 for Android, causing the input scheme to be keyboard when it should be gamepad. This mapping has been removed. (UUM-20119)

  • Graphics: Added error message when capturing a screenshot into a RenderTexture but passing null for argument. (UUM-7004)

  • Graphics: Fixed a ReadPixels issue. (UUM-2998)

  • Graphics: Fixed an issue so that entering playmode with disabled compositor no longer breaks all its layers. (UUM-11633)

  • Graphics: Fixed an issue with inspecting a RenderTexture with DepthAuto / ShadowMap as the Color Format so it no longer breaks the inspector. (UUM-11764)

  • Graphics: Fixed crash in depth resolve when using HDR render textures. (UUM-2316)

  • Graphics: Fixed for incorrect values in ReadPixel for some graphics formats on DirectX. (UUM-15344)

  • Graphics: Fixed problems with 16-bit floats on iOS with URP. (UUM-14877)

  • Graphics: Fixed ShaderUtil API to properly fetch data from the SerializedShader and the RuntimeShader. (UUM-10163)

  • Graphics: Fixed GraphicsFenceType so it is now set correctly from CommandBuffer.CreateGraphicsFence. (UUM-11450)

  • Graphics: Graphics: Fixed crash by preventing race condition when opening app from floating icon state on Android. (UUM-576)

  • HDRP: Added clarification on HDR Output not supporting Scene View. (UUM-16184)

  • HDRP: Fixed a black screen issue with master builds on HDRP. (UUM-17388)

  • HDRP: Fixed a number of outdated reference to "HDRP Default Settings" in the UI. (UUM-11494)

  • HDRP: Fixed ambient probe for volumetric clouds.

  • HDRP: Fixed an issue with Bloom and Depth of Field in game view when filtering in the hierarchy. (UUM-17739)

  • HDRP: Fixed an issue with low resolution depth of field producing a cropped result in some scenarios. (UUM-11354)

  • HDRP: Fixed black dots when clouds rendered in local mode. (UUM-11651)

  • HDRP: Fixed black line in ray traced reflections. (UUM-11379)

  • HDRP: Fixed color grading so it no longer outputs negative colors. (UUM-11110)

  • HDRP: Fixed custom pass scaling issues with dynamic resolution. (UUM-10882)

  • HDRP: Fixed decal material validation after saving. (UUM-12750)

  • HDRP: Fixed embedding the config package when it's not a direct dependency. (UUM-8012)

  • HDRP: Fixed exposure of recorded frames with path tracing and auto exposure. (UUM-14985)

  • HDRP: Fixed graphics issues with sky and fog in game view when filtering objects in the hierarchy. (UUM-11952)

  • HDRP: Fixed Layer List is not duplicated when duplicating a LayeredLit Material. (UUM-11123)

  • HDRP: Fixed minor bug in the shadow ray culling for the cone spot light. (UUM-9708)

  • HDRP: Fixed missing limitation in path tracing documentation regarding Local Volumetric Fog. (UUM-13354)

  • HDRP: Fixed missing tag on decal shader properties.

  • HDRP: Fixed Missing tooltip for Screen Weight Distance in Screen Space Refraction Override. (UUM-16930)

  • HDRP: Fixed mouse position in debug menu with scaled screens in editor. (UUM-16880)

  • HDRP: Fixed null reference error in the rendering debugger when no camera is available. (UUM-18189)

  • HDRP: Fixed performance when volumetric fog is disabled. (UUM-14318)

  • HDRP: Fixed range of spill removal parameter in graphics compositor UI. (UUM-11634)

  • HDRP: Fixed Ray Tracing Mixed Mode Collisions. (UUM-14613)

  • HDRP: Fixed scene depth node not working in the Decal ShaderGraph material type. (UUM-8237)

  • HDRP: Fixed shadergraph using derivatives and Raytracing Quality keyword. (UUM-8358)

  • HDRP: Fixed shadows in transparent unlit shadow matte. (UUM-12284)

  • HDRP: Fixed slight change of color in background when changing scene hierarchy. (UUM-14324)

  • HDRP: Fixed Text alignment in Transparency Inputs section. (UUM-17208)

  • HDRP: Fixed texture wrapping of cloud layer. (UUM-15591)

  • HDRP: Fixed the fallback section so it now disappears when hiding the additional data. (UUM-16780)

  • HDRP: Fixed the indirect diffuse lighting in ray tracing so it now always works properly. (UUM-14083)

  • HDRP: Fixed the ray tracing reflection denoiser being partially broken. (UUM-10443)

  • HDRP: Fixed the ray tracing shadow denoiser s it no longer produces leaks at the edge of spotlight shadows. (UUM-17794)

  • HDRP: Fixed transmission on directional lights. (UUM-15003)

  • HDRP: Fixed unnecessary loss of precision when all post processing are disabled. (UUM-13277)

  • HDRP: Fixed volumetric cloud incorrectly display in lighting debug mode.

  • HDRP: Fixed zfighting artifacts for ray tracing. (UUM-7668)

  • HDRP: Improved the motion and receiver rejection tooltips for RTGI and RTAO. (UUM-13152)

  • HDRP: Removed misleading part of a LensFlare tooltip. (UUM-13946)

  • HDRP: Removed unused voluimetric clouds volume component on new scenes templates. (UUM-11451)

  • HDRP: Removed unwanted RTAO effect on indirect specular lighting. (UUM-8772)

  • HDRP: Renamed IOR output in Eye shadergraph for clarification. (UUM-15849)

  • HDRP: Worked around exception when enabling raytracing when resources for raytracing have not been built. (UUM-9570)

  • IL2CPP: Enabled properly forwarding declare generic value type pointer arguments. (UUM-19689)

  • IMGUI: Removed Resolve of invalid GC handle error occurring when exiting Play mode. (UUM-14969)

  • iOS: Fixed a hang on startup on iOS 16 when linking to UnityFramework. (UUM-16259)

  • Linux: Fixed SystemInfo.batteryStatus and SystemInfo.batteryLevel so that they now work on Linux. (UUM-16083)

  • Mono: Updated the Brotli compression library to version 1.0.9 to correct https://github.com/advisories/GHSA-5v8v-66v8-mwm7. (UUM-15721)

  • Networking: Fixed race condition between DownloadHandlerTexture and Resources.UnloadUnusedAssets, sometimes cause premature destruction of the texture. (UUM-18044)

  • Package Manager: Package documentation links pointing to private Github URLs can now be opened in browser for non-Unity packages. Additionally, for all packages in general, opening local documentation will fall back on the README file if a documentation.md file cannot be found. (UUM-8337)

  • Particles: Fixed crash caused by Particle EmissionModule::Transfer handling of bursts array. (UUM-8886)

  • Physics 2D: Fixed an issue so that RelativeJoint2D angularOffset uses Degrees and not Radians. (UUM-19333)

  • Physics 2D: Fixed an issue when using the 2D Physics Multithreaded solver so that contact processing time no longer increases over time under certain circumstances. (D2D-4284)

  • Physics 2D: Fixed an issue where a contact normal would be inversed leading to Collider2D.IsTouching incorrectly filtering the collision normal angle. (UUM-15726)

  • Prefabs: Fixed the import process so that only transform remains after importing a broken file, if a Prefab file is found to contain multiple transforms due to external merge tool or manual edit error. Note: Import prioritization of RectTransform over Transform remains unchanged. (UUM-14898)

  • Profiler: Fixed profiler connection allocations tracking under the ProfilerConnection entry in Memory Profiler. (UUM-16465)

  • Profiler: Fixed rendering of certain character sets in CPU Profiler Timeline view. (UUM-16513)

  • Profiler: GPU module's sample hierarchy no longer uses CPU data after a recompilation when there is an active selection. (UUM-20083)

  • Profiler: Restore Defaults will now also re-enable all default modules and reset chart preferences. (UUM-11329)

  • Scripting: Removed warning for obsolete platforms when added plugins to plugin folders that contains both obsolete and non-obsolete platforms. (UUM-12246)

  • Shadergraph: Fixed Shader Graph BiRP Target so it now works correctly with point lights and transparent objects. (UUM-9823)

  • Shaders: Fixed a crash in Shader Prefiltering when the Render Pipeline assets contain circular data references. (UUM-19976)

  • Shaders: Fixed a crash when building variants when a package is unloaded and re-loaded. (UUM-20693)

  • Shaders: Fixed an incorrect error message when using instanced rendering and replacement shaders. (UUM-20961)

  • Shaders: Fixed shader graph incorrectly stripping variants for BiRP shaders that weren't built with shader graph. (UUM-14800)

  • Shaders: Preparing variants for compilation dialog now shows the name of the shader being processed. (UUM-22015)

  • SRP Core: Fixed ColorCurves volume leaking Texture2D objects under certain circumstances. (UUM-16602)

  • Terrain: Terrain is not affected by Environmental Lighting when Draw Instanced is turned on. (UUM-11754)

  • UI: Fixed missing tooltip for "Screen Weight Distance" in Screen Space Refraction override. (UUM-12116)

  • UI Toolkit: Fixed :active default style overwritten by :hover:enabled. (UUM-19845)

  • UI Toolkit: Fixed an issue where the Progress Bar's title attribute would not reset inside the UI Builder. (UUM-21345)

  • UI Toolkit: Fixed an issue where the UI Builder would log a cryptic error when trying to save a uxml document outside of the project. It will now inform the user that the operation failed. (UUM-20711)

  • UI Toolkit: Fixed image element so it no longer ignores UV rect when a sprite was used. (UUM-18362)

  • UI Toolkit: Fixed incorrect width calculated for Labels with style tags. (UUM-8428)

  • UI Toolkit: Fixed layout of Image element so it now works with a flipped UV rect. (UUM-17729)

  • UI Toolkit: Fixed support for compound assignment operators for UI Toolkit numeric fields (IntegerField, LongField, FloatField, DoubleField). (UUM-3471)

  • UI Toolkit: Improved UI Toolkit so that flipped UVs are now properly handled by scale modes of the Image element. (UUM-17136)

  • Universal RP: Fixed a missing keyword in ParticleLit for Lightmap shadow mixing. (UUM-18601)

  • Universal RP: Fixed projection flip inversion. (UUM-13634)

  • Universal Windows Platform: Fixed mouse wheel events on UWP. (UUM-19092)

  • URP: Fixed 2D game view flickering when using URP Pixel Perfect and Cinemachine Pixel Perfect Extension. (UUM-20343)

  • URP: Fixed errors related to the lack of support of native shadow maps on WebGL1. (UUM-2270)

  • VFX Graph: Fixed an issue that vertex Color was black while using new shader graph integration on planar primitive output. (UUM-12866)

  • VFX Graph: Fixed an issue with the out of range exception on GPU when multiple spawn context are plugged to the same initialize system. (UUM-8351)

  • VFX Graph: Forbid drag and drop of material from project browser to VFX component in scene. (UUM-14790)

  • Video: Fixed Video Player crash/malfunction on Android versions less than 9. (UUM-1843)

  • Video: VideoPlayer.width and height return 0 instead of expected values. (UUM-1899)

  • Visual Scripting: Detected and fixed parameter renames for nodes that support a default parameter for each of their inputs. (UVSB-1885)

  • Visual Scripting: Fixed a problem that was preventing link.xml creation when building for Mono backend. (UVSB-2348)

  • Visual Scripting: Fixed graphs being corrupted on deserialization if containing a node whose type cannot be found. (UVSB-2332)

  • Visual Scripting: Fixed Visual Scripting settings now only save to disk when modified.

  • Visual Scripting: Fixed Gradient.mode serialization. This fix is available for Unity 2021.3.9f1 or newer. (UVSB-2356)

  • Visual Scripting: Moved Events/MessageListeners files to a Listeners folder to avoid to exceed some OS path limit.

  • WebGL: Fixed a bug where Firefox would hang at 90% while loading. (UUM-1155)

  • WebGL: Fixed error handling of AudioContext.resume(). (UUM-17803)

  • XR: Fixed crash on Quest when using MSAA and moving out of the guardian during startup. (UUM-20525)

  • XR: Updated XR Interaction Toolkit to 2.2.0.

Package changes in 2021.3.17f1

Packages updated

Changeset:
3e8111cac19d

Third Party Notices

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

We use cookies to ensure that we give you the best experience on our website. Visit our cookie policy page for more information.

Got it