Release notes
Unity is the ultimate game development platform. Use Unity to build high-quality 3D and 2D games, deploy them across mobile, desktop, VR/AR, consoles or the Web, and connect with loyal and enthusiastic players and customers. Install this version with Unity Hub. Additional downloads. 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.
Known Issues in 2021.1.4f1
Asset Import Pipeline: Prefab script field reference is lost when project is upgraded(1328724)
Animation: AnimationEvent is fired late or isn't fired at all when Animation's 'Motion Time' value is set manually(1324763)
Global Illumination: Performance regression when baking light probes with a light cookie in the scene(1323393)
Asset Bundles: [macOS] Editor crashes when trying to build Asset bundles in InitializeOnLoad or InitializeOnLoadMethod time(1328463)
Scene/Game View: [Game view] Game stops accepting input when the Game view undocked and re-docked during Play Mode using the Input System(1320678)
Settings Window: Editor freezes when FixedTimestep value in the Preferences is set to 0/0(1326481)
2D: [Skinning Editor] Vertex can't be created after modifying Vertexes weight and when Sprite is from the .psb file(1322204)
AI: Crash with ComputeTileMeshJob when generating Navmesh(1329346)
Global Illumination: Reflection probes don't contain indirect scene lighting after the on-demand GI bake from the Lighting window(1324246)
Animation: [Performance Regression] AnimationWindowState:get_allCurves takes approximately 5000ms to load animation in the Animation window(1320250)
IL2CPP: Build fails when using a combination of messages, SyncVars and SyncList in a project(1328966)
Metal: Performance in Game View is significantly impacted by Gfx.WaitForPresentOnGfxThread when a second monitor is connected(1327408)
Terrain: All the textures are cleared when creating Texture array(1323870)
HD RP: The camera doesn't rotate in HDRP Template with the SimpleCameraController.cs script(1326816)
Scene Management: Crash on BuildPrefabInstanceCorrespondingObjectMap when overriding nested prefab inside AssetDatabase.StartAssetEditing() block(1324978)
WebGL: 'SharedArrayBuffer will require cross-origin isolation as of M91' warning is thrown when launching Player on Chrome(1323832)
Linux: Linux Editor crashes at '_XFreeX11XCBStructure' when loading tutorials(1323204)
Terrain: Crash on TreeRenderer::WillRenderTrees when being in Play Mode for several seconds(1317966)
IMGUI: Contents of a ModalUtility window are invisible when it is launched from a Unity Context Menu(1313636)
Packman: User can't easily configure location of both UPM and Asset Store package local cache(1317232)
Serialization: Crash in SerializedProperty::IsValid when reordering a SerializedProperty list(1320319)
Global Illumination: [GPUPLM] Crash in RadeonRaysMeshManager::RemoveGeometry while baking Terrain game object with 4k lightmaps on certain GPU(1255993)
Terrain: Terrain Lit Opacity as Density option causes alpha'd areas on the 5th layer or greater to appear with artifacts(1283124)
Packman: Package resolution error when using a Git dependency referencing an annotated tag in its Git URL(1325920)
Scripting: Increased Script Assembly reload time(1323490)
Scripting: Crashes on mono_class_init when entering Play Mode after recompiling scripts(1262671)
Global Illumination: Wintermute::Geometry::Verify errors are spammed when baking a Mesh with Mesh Compression set to Medium/High(1319133)
MacOS: [macOS] 'build is damaged and cannot be opened' error when downloading Unity build from internet(1323501)
Asset Importers: Wintermute::Geometry::Verify errors are spammed when baking a Mesh with Mesh Compression set to Medium/High(1313968)
2D: [URP] The Camera renders black screen when Post Processing is enabled in the 2D Renderer and in the Camera Component(1318500)
2021.1.4f1 Release Notes
Features
- Search: Added support for menu states (disabled, checked) in QuickSearch. (EC-767).
Improvements
Asset Import: Improved overall performance of FBX files import.
Asset Import: Improved performance of ASCII FBX files import.
Package: ProBuilder 5.0.3.
Package: Upgraded udp to 2.1.6.
Search: Added support for search item favorites.
Search: Added support to index sub objects and compress search index entries.
Search: Improved asset search performances by ~4x.
Search: Improved scene provider search performances and reduced the scene provider memory usage.
Search: Improved transaction manager performances.
Search: Many search UI and UX improvements.
Search: Search indexes size are now ~60% smaller.
Search: Settings can now be searched by their properties in Search.
XR: Updated OpenXR Package to 1.1.1.
API Changes
- HDRP: Added: Added a fallback for the ray traced directional shadow in case of a transmission.(1307870)
Changes
HDRP: Assets going through the migration system are now dirtied.
HDRP: Changed normal used in path tracing to create a local light list from the geometric to the smooth shading one.
HDRP: Changed the behavior of the clear coat and SSR/RTR for the stack lit to mimic the Lit's behavior.(1320154)
HDRP: The default LookDev volume profile is now copied and referened in the Asset folder instead of the package folder.
Package Manager: Com.unity.purchasing updated with missing documentation.
Search: In Index Manager, for includes/excludes, we now keep the last file pattern that was selected in the enum field when adding another item.
Search: Ref:<asset_path> should only search results that has a direct dependency to <asset path>.
Fixes
Animation: Fixed an issue where the animator parameter values would truncate float values to 1 decimal.(1308930)
Asset Bundles: Fixed issue where loading assets from AssetBundles synchronously did not load native object types recursively in some situations.(1321141)
Asset Import: Fixed performance regression of animation import.(1265275)
Asset Pipeline: Fixed an issue where duplicated assets with children could select the wrong main object.(1302399)
Asset Pipeline: Improved performance of flushing the preload operation queue from the main thread. This can occur when accessing an operation's result on the main thread before it is completed.(1322086)
Build Pipeline: Fixed an edge case where windows relative paths were not handled correctly.(1318673)
Editor: Fixed ReorderableList not getting expanded height for lists inside properties.(1324456)
GI: Fixed an issue where Wintermute::Geometry::Verify errors are spammed when baking a Mesh with Mesh Compression set to Medium/High.(1319133)
Graphics: Choose the proper graphics multithreaded mode.(1223767)
Graphics: Fixed instanced rendering light layers to be initialized to the default (first light layer) instead of zero to fix lack of lighting on the instanced objects.(1268590)
HDRP: Fixed a bug with Reflection Probe baking would result in an incorrect baking reusing other's Reflection Probe baking.
HDRP: Fixed an issue with Decal normal blending producing NaNs.
HDRP: Fixed Decal's pivot edit mode 2D slider gizmo not supporting multi-edition.
HDRP: Fixed Exposure Frame Settings control issues on Planar reflection probes. Dynamic reflections now keep their own exposure relative to their parent camera.(1312153)
HDRP: Fixed generation of the packed depth pyramid when hardware Dynamic Resolution Scaling is enabled.
HDRP: Fixed issue in wizard when resource folder don't exist.
HDRP: Fixed issue were the final image is inverted in the Y axis. Occurred only on final Player (non-dev for any platform) that use Dynamic Resolution Scaling with Contrast Adaptive Sharpening filter.
HDRP: Fixed issue with Decal projector edge on Metal.(1286074)
HDRP: Fixed issue with gbuffer debug view when virtual texturing is enabled.
HDRP: Fixed Render Graph Debug UI not refreshing correctly in the Render Pipeline Debugger.
HDRP: Fixed SSR Precision for 4K Screens.
HDRP: Fixed SSS materials in planar reflections.(1319027)
HDRP: Fixed volumetric fog being visually chopped or missing when using hardware Dynamic Resolution Scaling.
HDRP: Fixed volumetric fog noise due to sun light leaking.(1319005)
HDRP: Fixed warning fixed on ShadowLoop include (HDRISky and Unlit+ShadowMatte).
IL2CPP: Corrected convert assemblies that do not have a type.(1319131)
IL2CPP: Corrected the behavior of by-reference parameter for delegate async invocation when the by-reference parameter is after a non-by-reference parameter.(1313160)
IL2CPP: Fixed crash in il2cpp::vm::LivenessState::AddProcessObject.(1315058)
IL2CPP: Fixed CultureInfo.DateTimeFormat being loaded incorrectly in some locales.(1252269)
IL2CPP: Fixed exception when converting a method with a parameter that is an in generic parameter with a default value.(1313460)
IL2CPP: Fixed possible IndexOutOfRangeException with script debugging enabled.(1321876)
IL2CPP: Workaround a crash caused by a MSVC optimizer incorrectly reuses stack space when a stack pointer is returned via a function pointer.(1317949)
Linux: Fixed ArgumentException errors being thrown when clicking on the camera settings button on the scene view.(1286300)
Linux: Fixed broken automated test, test now passes and is re-enabled.(1252268)
Linux: Fixed code path that allows OnGUI() to be called before Awake() in user scripts.(1273603)
Linux: Fixed crash when Unity Editor was closed while running the profiler.(1278719)
Linux: Fixed OnGUIDepth errors that spam the console when docking and undocking the Inspector window.(1299223)
Linux: Fixed profiler throwing BeginSample/EndSample mismatch errors when opening preferences from the profile window while profiling.(1286545)
Package Manager: Fixed bug where Package Manager window In Project list would be empty for a newly created project.(1319205)
Particles: Fixed ParticleSystemRenderer.SetMeshes script API.(1322561)
Prefabs: InstantiatePrebab in the editor now calls OnTransformChildrenChanged.(1319453)
Scene/Game View: Fixed arc handle picking when the arc is close to parallel with the camera.(1310854)
Scripting: Added Flags attribute to SelectionMode enum.(1298921)
Scripting: Instanciation of Unity objects defined in types under more than one level of nesting should work.(1299861)
Search: Fixed exception thrown when closing search if started from sync button.(1315777)
Search: Fixed floating point search expression parsing for non US locales.
Search: Fixed help tips and default opening option of search window.(1315793)
Search: Fixed hierarchy window search returns incorrect results when using ref in the search bar.(1311273)
Search: Fixed search index incremental update merge issue.
Search: Fixed searching for settings in Search that will yield results, even when keywords order doesn't match the original string.(1321890)
Search: Fixed SearchService.Request when used with a non-asynchronous queries.
See https://forum.unity.com/threads/quick-search-preview.635863/page-12#post-6907427.Search: Fixed typo in PlayableScript template that created an error when Menu.GetEnabled was called on it.(1315168)
Search: Print a friendly error when saving an invalid search query asset.(1317448)
Search: Removed unchecked character from menu provider item name since it looks like a display error.(1315167)
Search: Updated the search provider active state when toggled in the search view provider filters dropdown.(1318459)
Serialization: Fixed issue where SerializedProperty.propertyPath would not return the same path when invoked multiple times with an array entry path which is no longer there.(1310571)
Shadergraph: Fixed a bug where synchronously compiling an unencountered shader variant for preview was causing long delays in graph updates.(1323744)
Shaders: Fixed regression that was dropping some shader errors from the inspector after restarting the editor.(1325521)
UI Toolkit: Fixed multiple errors appear after modifying ScriptableObject's array indirectly.(1303188)
Universal: Fixed errors when the Profiler is used with XR multipass.(1313141)
Video: Stereoscopic layout controls are missing in VideoPlayer and Skybox Panoramic shader.(1307239)
XR: Fixed deadlock when using XR + URP + D3D11 with skipPresentToMainScreen.(1323833)
XR: Updated the verified AR Foundation related packages to 4.1.7. Please see the AR Foundation package changelog for details.
XR: XRDisplaySubsystem and XRInputSubsystem now available on WebGL build target.(1283105)
Release notes
Known Issues in 2021.1.3f1
Metal: Performance in Game View is significantly impacted by Gfx.WaitForPresentOnGfxThread when a second monitor is connected(1327408)
Terrain: All the textures are cleared when creating Texture array(1323870)
Animation: [Perfomance Regression] AnimationWindowState:get_allCurves takes approximately 5000ms to load animation in the Animation window(1320250)
HD RP: The camera doesn't rotate in HDRP Template with the SimpleCameraController.cs script(1326816)
Scene Management: Crash on BuildPrefabInstanceCorrespondingObjectMap when overriding nested prefab inside AssetDatabase.StartAssetEditing() block(1324978)
WebGL: 'SharedArrayBuffer will require cross-origin isolation as of M91' warning is thrown when launching Player on Chrome(1323832)
2D: [Skinning Editor] Vertex can't be created after modifying Vertexes weight and when Sprite is from the .psb file(1322204)
Scripting: Increased Script Assembly reload time(1323490)
Linux: Linux Editor crashes at '_XFreeX11XCBStructure' when loading tutorials(1323204)
Terrain: Crash on TreeRenderer::WillRenderTrees when being in Play Mode for several seconds(1317966)
IMGUI: Contents of a ModalUtility window are invisible when it is launched from a Unity Context Menu(1313636)
Global Illumination: Reflection probes doesn't contain indirect scene lighting after the on-demand GI bake from the Lighting window(1324246)
Packman: User can't easily configure location of both UPM and Asset Store package local cache(1317232)
Serialization: Crash in SerializedProperty::IsValid when reordering a SerializedProperty list(1320319)
Global Illumination: [GPUPLM] Crash in RadeonRaysMeshManager::RemoveGeometry while baking Terrain game object with 4k lightmaps on certain GPU(1255993)
Terrain: Terrain Lit Opacity as Density option causes alpha'd areas on the 5th layer or greater to appear with artifacts(1283124)
Asset Bundles: Synchronous Asset Loading Does Not Correctly Load Preload Dependencies(1321141)
Addressable Assets: Performance bug in PreloadManager::WaitForAllOperationToComplete(1322086)
Packman: Package Manager incorrectly shows that there are no packages in a new project(1319205)
Windows: [Windows 7] 'WindowsVideoMedia error 0xc00d36b4' error is thrown when loading a video with the VideoPlayer(1306350)
Scripting: Crashes on mono_class_init when entering Play Mode after recompiling scripts(1262671)
Global Illumination: Wintermute::Geometry::Verify errors are spammed when baking a Mesh with Mesh Compression set to Medium/High(1319133)
Cloth: Cloth is broken when parent GameObject scale is lower than 1 and Surface Penetration constraints are set 0(1319488)
MacOS: [macOS] 'build is damaged and cannot be opened' error when downloading Unity build from internet(1323501)
Asset Importers: Wintermute::Geometry::Verify errors are spammed when baking a Mesh with Mesh Compression set to Medium/High(1313968)
2D: [URP] The Camera renders black screen when Post Processing is enabled in the 2D Renderer and in the Camera Component(1318500)
2021.1.3f1 Release Notes
Unity 10q
Improvements
Unity 1 Hour
Web: Updated UnityWebRequest's libCurl backend (used on most platforms).
XR: Updated Windows MR Package to 5.2.2.
Changes
2D: Animation Package 6.0.0 as verified package.
2D: Pixel Perfect 5.0.0 as verified package.
2D: PSDImporter 5.0.0 as verified package.
2D: Sprite Shape 6.0.0 as verified package.
2D: Tilemap Extras 2.0.0 as verified package.
Unity 1v1.lol
Fixes
Unity 10k
Audio: Don't shut down audio output device in edit mode when DSPGraph is running.(1310050)
DX12: Fixed black screen that would show when using a non-native resolution in fullscreen.(1318666)
Editor: Fixed Material Editor large thumbnails not showing up correctly for material texture properties when the texture type is Texture2DArray or Texture3D.(1288995)
Editor: Fixed Texture3DPreview InfoString incorrectly displaying: Texture dimensions as Z-Y-Z instead of X-Y-Z & very small resolutions.(1321095)
Graphics: Fixed DrawProcedural reporting incorrect triangle counts to FrameStats.
Graphics: Fixed performance issue when loading textures direct to GPU memory from LZ4 compressed packages.(1307820)
IL2CPP: Fixed possible ArgumentException when converting a call to a type that implements multiple variations of the same generic interface.(1319313)
IL2CPP: Redist dlls copied from MSVC & Windows SDK for Windows Games platforms.(1299856)
iOS: Fixed a performance issue where Microphone.Start would cause CPU spikes on iOS. If the user selects the player setting 'Prepare iOS for Recording', these spikes have been eliminated. They will now only occur when switching back-and-forth between a built-in microphone and a Bluetooth microphone. When using 'Prepare iOS for Recording', most projects will also want to set 'Force iOS Speakers when Recording'.(1281833)
iOS: Leaderboards now return the non deprecated player ID on appropriate OS versions.(1312882)
Linux: Install sysroot packages automatically only when Linux IL2CPP is present.(1325982)
macOS: Fixed failing to resign binaries after Unity has signed them with error: 'file not in an order that can be processed (code signature data out of place):'.(1324168)
macOS: Fixed Windows and Linux native plugins getting included into the generated Xcode project.(1321049)
Package Manager: Fixed an issue where adding packages from a registry which returned invalid publish dates would fail.(1318975)
Package Manager: Fixed an issue where the
UnityEditor.PackageManager.Client.SearchAll
method would result in a connection error despite usingofflineMode = true
.(1319585)Package Manager: Fixed an issue which could sometimes cause package resolution errors due to
EMFILE
errors in projects with a large number of packaged assets.Package Manager: Fixed an issue which could sometimes lead to missing files in successfully resolved packages in projects with a large number of packaged assets.
Package Manager: Fixed an issue which prevented starting
UnityPackageManager.exe
on Windows when its path contained non-ANSI Unicode characters.(1317244)Particles: Fixed invalid AABB error when using Rate over Distance and Limit Velocity.(1317418)
Scene/Game View: Fixed Physics Debugger not selecting collider debug volumes first when clicking.(1309768)
XR: Fixed depth buffer sharing support.(1242142)
XR: [Lumin] : Fixed some improper temp string usage that was causing the allocator to spam the system logs.(1284830)