Unity 2021.3.28

Released:

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.
New to Unity? Get started

Release Notes

Known Issues in 2021.3.28f1

  • HD RP: [XR] Editor crash entering play mode with terrain in the scene (UUM-41447)

  • Input: Crash on InputDeviceIOCTL when closing Unity editor (UUM-10774)

  • iOS: App freezes and the "You can attach a managed debugger now if you want” message doesn’t show up when running the app on iOS devices with the "Wait For Managed Debugger" setting enabled (UUM-39644)

  • Linux: Crash on DisconnectGtkSignal(void*, GtkCallbackResponse ()(), void) when going through microgame tutorials (UUM-34847)

  • MacOS: Crash on objc_msgSend when the Editor UI gets redrawn (UUM-34202)

  • MacOS: Fix for 2021.3.X: Editor silently crashes when entering Play Mode on macOS (UUM-37060)

  • Metal: [iOS] Rendering freezes when the orientation is changed (UUM-9480)

  • Mono: Crash with ScanAssemblyForAttributesAndInterfaceImplementations when opening a project (1376858)

  • Platform Audio: [WebGL] A looping audio sounds different on WebGL than in the editor/native desktop player (UUM-12530)

  • Project Browser: Project Browser shows package resources when package visibility is disabled (UUM-32517)

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

  • Vulkan: Editor exits when opening the Scene view window or selecting a material (UUM-36647)

2021.3.28f1 Release Notes

Improvements

  • Documentation: Improved the documentation for the NonSerialized attribute to indicate that the attribute is necessary if you really never want a (private) field to be serialized.

  • Editor: Animation Events are now organized into sub-menus in the inspector.

  • Editor: The "Non-Power of 2" control is now hidden for Cubemaps in the Texture Importer Inspector because it is not used for Cubemaps. (UUM-1882)

  • Multiplayer: Added Netcode for GameObjects 1.5.0.

  • VFX Graph: Allows texture types to be used in branch operators. (UUM-38037)

  • VFX Graph: VFX systems receiving GPU events can now go into sleep state.

Changes

  • Build Pipeline: Will now use -filelist when running libtool for MacOS/iOS builds to prevent command lines from becoming too long. (UUM-34555)

  • Package: Updated code coverage package to version 1.2.4.

  • Services: Rebranded Unity Cloud Build service to Build Automation.

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

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

Fixes

  • 2D: Fixed bug with placement of the Tilemap Instantiated Object when the Tilemap orientation is set. (UUM-36433)

  • 2D: Fixed case where sprite Packer does not re-pack folder when texture type is changed to sprite when inside a target folder. (UUM-34323)

  • Android: Fixed crash when creating pipeline objects for some URP Lit shader on some older Adreno drivers. (UUM-29409)

  • Android: Fixed errors on new InputSystem when using mouse clicks on Samsung Dex. (UUM-19038)

  • Android: Fixed R8 mapping output and enforced use of R8 for targetSDK 33 and above. (UUM-889)

  • Android: Fixed Unity allocator crash when forcing -systemallocator on ARM64 with Android 10/11 or higher. (UUM-40105)

  • Android: Updated that the text inputfield to appear and disappear with the "Enter" key. (UUM-30811)

  • Asset Bundles: Added error message when loading bundle without typetrees in the Editor. (UUM-660)

  • Build Pipeline: Fixed edge case where using the BuildPipeline.BuildPlayer APIs on Windows can fail, when a previously used build folder has been deleted. (UUM-30952)

  • Build Pipeline: Fixed incorrect dependencies appear after building AssetBundles with Prefab Variants. (UUM-20038)

  • Build Pipeline: Fixed renaming Prefab Objects leads to wrong Asset Bundle dependency when the Prefab is nested. (UUM-639)

  • Build Pipeline: Fixed Shader references are lost when building assets with BuildPipeline.BuildAssetBundles. (UUM-2259)

  • Burst: Fixed incorrect Burst stacktraces in Windows player builds. (UUM-33695)

  • Editor: AdbProvider doesn't add errors when displayed in the Project tab. (UUM-32810)

  • Editor: Added Bee build recipes for LAME and Vorbis encoders.<br> Fix LAME vulnerability CVE-2017-8419. (UUM-14404)

  • Editor: Added more validation when saving scene template (handled outside project). Also allows saving inside a package folders. (UUM-30708)

  • Editor: Added try/catch when calling custom indexers so they cannot crash the whole indexing process. (UUM-27948)

  • Editor: Avoid quadratic indexing time when indexing scenes with prefabs. (UUM-16085)

  • Editor: Changed search result count label color to be more clear when selected and hovered. (UUM-32515)

  • Editor: Component Help button tooltip are generated with a nicify type name. (UUM-37612)

  • Editor: Custom indexers are properly refreshed on Domain reload. (UUM-35650)

  • Editor: Do not allow to add the same column twice. (UUM-36007)

  • Editor: Ensure ModeService does a EnumerateAllAssets once (in startup) and never again during domain reload. (UUM-37521)

  • Editor: Fixed a case where an object change event for object destruction would not contain a valid parent instance id. (UUM-40341)

  • Editor: Fixed an issue that caused some packages to remain visible in the Project Window when the visibility button was toggled. (UUM-35156)

  • Editor: Fixed an issue that caused the assets of some packages to remain visible in the Object Picker when the visibility button in the Project Window was toggled. (UUM-21308)

  • Editor: Fixed an issue where dragging an asset from the Packages folder to an empty Assets folder could cause a crash. (UUM-39919)

  • Editor: Fixed an issue where the Cubemap "Mapping" control in the Texture Importer Inspector would incorrectly be disabled in certain scenarios. (UUM-1882)

  • Editor: Fixed Column naming in Edit Column menu. (UUM-32469)

  • Editor: Fixed context menu items not being enabled in modal windows on MacOS Editor. (UUM-20747)

  • Editor: Fixed crash when calling EditorUtility.UnloadUnusedAssetsImmediate(false). (UUM-11648)

  • Editor: Fixed EditorBuildRules.GetAllScriptAssemblies scales poorly on large projects. (UUM-35879)

  • Editor: Fixed for editor freeze on macOS. (UUM-30173)

  • Editor: Fixed hover and tooltip of Scene Template Pipeline help button. (UUM-37542)

  • Editor: Fixed issues with missing realtime GI when mixing realtime GI Light Probes and baked GI Light Probes in Auto Generate Lighting mode. (UUM-20639)

  • Editor: Fixed meshes from 2019 LTS and older being upgraded to use an incorrect "Margin Method" setting for Lightmap UV generation. (UUM-37456)

  • Editor: Fixed resize minimum size on undocked window. (UUM-36103)

  • Editor: Fixed scrollbar in scene template dialog. (UUM-35878)

  • Editor: Fixed the problem of selectedPlatform being serialized in ProjectSettings.asset. (UUM-28332)

  • Editor: Fixed title show the major, minor and version build. (UUM-26695)

  • Editor: Fixed tool gizmos clipping in cases where adjacent objects are separated by large distances on the z axis. (UUM-34638)

  • Editor: Improved warning message when trying to save a SceneTemplate with an invalid asset path. (UUM-31433)

  • Editor: Prevent particle system buffer pre-mapping in editor if RenderDoc is present. (UUM-32787)

  • Editor: Updating outdated and broken links in the Help toolbar for Unity Discussions (old Unity Answers) &amp; Unity Feedback. (UUM-40354)

  • GI: Fixed crash on Mac M1 when attempting to bake a reflection probe in URP. (UUM-1370)

  • GI: Fixed Light Probe occlusion when using GPU Lightmapper and many light probe positions. (UUM-4179)

  • GI: Fixed off-by-one error in version number used for margin method upgrade path. (UUM-40721)

  • Graphics: Avoid false warnings about RenderTexture format when switching colorspace. (UUM-6770)

  • Graphics: Fixed CustomRenderTexture depth test results failing on some platforms. (UUM-1839)

  • Graphics: Fixed Light movement and artifacts when multiple vertex lights are interacting. (UUM-36457)

  • Graphics: Graphics: Fixed solid color block artifacts when compressing textures using Fast ASTC on M1 devices. (UUM-3148)

  • Graphics: SUCCEEDED(hr) error is thrown when the project's Shadows Filtering Quality is set to High or Very High. (UUM-37088)

  • HDRP: Added check to ensure gismos arent rendered when they shouldnt be. (UUM-22315)

  • HDRP: Fixed color pyramid history buffer logic when history is reset and the color pyramid is not required. (UUM-36095)

  • HDRP: Fixed GetScaledSize when not using scaling. (UUM-34513)

  • HDRP: Fixed TAA aliasing edge issues on alpha output for recorder / green screen. This fix does the following:<br>

    • Removes history rejection when the current alpha value is 0. Instead it does blend with the history color when alpha value is 0 on the current plane.<br>
    • The reasoning for blending again with the history when alpha is 0 is because we want the color to blend a bit with opacity, which is the main reason for the alpha values. sort of like a precomputed color<br>
    • As a safety, we set the color to black if alpha is 0. This results in better image quality when alpha is enabled. (UUM-33950)

  • HDRP: Fixed VT init to avoid RTHandle allocation outside of HDRP rendering loop. (UUM-31058)

  • HDRP: [Backport] Fix the incorrect base color of decals for transparency. (UUM-38038)

  • IL2CPP: Fixed LineNumberMapping.json not ending up in exported projects when --emit-source-mapping is used. (UUM-29964)

  • IL2CPP: When P/Invoking with a blittable class parameter, pass a pinned pointer to the managed class to native. (UUM-33942)

  • iOS: Fixed "Screen.orientation" is not changing orientation in the UaaL. (UUM-30925)

  • iOS: Fixed assert error in iOS.Device.systemVersion and tvOS.Device.systemVersion. Also make there properties only return values on respective OSes. (UUM-16561)

  • iOS: Fixed BuildCanBeAppended returning Unsupported when used on Windows. (UUM-25061)

  • iOS: Fixed leak error messages for iOS build and run process on MacOS editor. (UUM-1944)

  • iOS: Fixed low memory usage event not triggered when using Unity as a library. (UUM-20838)

  • iOS: Fixed Screen.orientation not changing value when only landscape orientations are enabled and device is rotated. (UUM-36598)

  • iOS: Fixed Screen.orientation returns wrong values when switching from Landscape orientation to AutoRotation at runtime on iOS 16. (UUM-23251)

  • Linux: Fixed Unity Editor does not send exit code until Bug Reporter is closed. (UUM-34630)

  • Linux: Fixed Unity runtime printing stack trace more than once in Entities package + IL2CPP crashes. (UUM-35527)

  • macOS: Fixed BuildCanBeAppended returning Unsupported when used on Windows. (UUM-25061)

  • macOS: Fixed editor freezes on Apple Silicon devices. (UUM-3768)

  • Mono: Corrected handle generic parameter attributes in the .Net Framework Api Compatibility Level. (UUM-32896)

  • Package Manager: Fixed a bug where removing an invalid local package would delete your project folder. (UUM-36876)

  • Package Manager: Fixed null Exception when manually installing com.unity.ui.builder. (UUM-39890)

  • Particles: Fixed potential crash when using systems relying on GeometryJobs. (UUM-36872)

  • Prefabs: Fixed PrefabModificationsForSerializedObject::DoPrefabModificationsNeedUpdate() is unnecessarily slow. (UUM-40630)

  • Profiler: Fixed invalid time reported by ProlfierRecorder for Main Thread root marker. (UUM-35959)

  • Serialization: Memory could get corrupted when attempting to deserialize a JSON to an Array. As this is not supported by JsonUtility, this will now throw an ArgumentException. (UUM-34344)

  • Services: Fixed Unity Cloud Build service broken links.

  • Shaders: Fixed "state comes from an incompatible keyword space" error sometimes shown in the console when loading certain shaders. (UUM-36032)

  • Shaders: Fixed corruption of AuxIndexCache when setting a TextureProperty on ShaderPropertySheet. (UUM-34732)

  • Shaders: Fixed interpolator parameter GLSL generated code for EVAL_SAMPLE_INDEX, EVAL_SNAPPED, EVAL_CENTROID. (UUM-35468)

  • SRP Core: Crash on keywords::LocalKeywordState::ResetWithSpace when shader contains Grab Pass. (UUM-30548)

  • TextCore: Fixed issue where sprites used incorrect indexes. (UUM-30797)

  • uGUI: Slider Component Normal Color property does not change in Scene and Game view when changed with an Animation. (UUM-34170)

  • UI Toolkit: Fixed missing Length conversions for style transitions between px and % units. (UUM-21277)

  • UI Toolkit: Fixed runtime navigation issues in TextField and composite fields, sometimes not entering text editing mode, or inserting undesired characters when doing so, or not allowing navigation to other elements. (UUM-20841)

  • UI Toolkit: Fixed the flag value not being updated with change of selection for unsigned int in enum mask field. (UUM-3688)

  • UI Toolkit: Fixed UI Toolkit not rendering in render texture when launched in batch mode. (UUM-26763)

  • Universal RP: Fixed an issue where keywords used with SSAO and Decals were not stripped correctly when the features were disabled. (UUM-18616)

  • Universal RP: Fixed lens-flare post-process effect on overlay camera causing a black screen. (UUM-36538)

  • Universal RP: Fixed rare iOS shader building failure due to URP Lit Forward Pass shader varyings struct variable mismatch. (UUM-1916)

  • Universal RP: Universal RP: Decals now do not enqueue passes when running on unsupported API's, such as OpenGL or GLES3, instead of displaying the magenta error. (UUM-13183)

  • Universal Windows Platform: Capabilities are not changed when rebuilding the project. (UUM-39725)

  • URP: 2D - Remove serialization and cache vertices and indices for sprite lights causing bloat in prefabs. (UUM-33700)

  • URP: Fixed redundant blit is used due to postFX, although it is disabled in rendererData. (UUM-31474)

  • URP: Fixed ShaderGraph preview window not showing anything when using DepthNormals pass. (UUM-31643)

  • VFX Graph: Fixed a potential crash with particle strips. (UUM-36762)

  • VFX Graph: Fixed an editor only memory leak with VFX Graph objects.

  • VFX Graph: Fixed VFX assets being considered modified after creation. (UUM-35056)

  • WebGL: Fixed a missing backslash in WebGL system info user agent regex that triggered a JS linter. (UUM-34348)

  • WebGL: Fixed an issue where C++ function names would not be properly generated in the output symbols.json file. (UUM-28034)

  • Windows: Fixed a bug with multi-channel audio input on Windows. If we tried to capture from a microphone with more than 2 channels, Microphone.Start would fail and an "Unsupported file or audio format" error would appear in the console. (UUM-26565)

  • Windows: Numpad Equals can now be registered with the Input System. (UUM-15023)

  • XR: Updated XR Hands Package to v1.2.0.

  • XR: Updated XR Hands Package to v1.2.1.

  • XR: Updated XR Interaction Toolkit Package to v2.4.0-pre.2.

  • XR: Updated XR Interaction Toolkit Package to v2.4.1-pre.1.

  • XR: Updated XR Interaction Toolkit to 2.4.0.

Package changes in 2021.3.28f1

Packages updated

Packages added

Changeset:
232e59c3f087

Third Party Notices

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

Quick jump

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