Release Notes Background

Unity 2021.3.28f1

Released on Jul 4, 2023

Install

Manual installs

Component installers

Release

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.
    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) & 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:

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

Looking for a different release?

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