Install this version with Unity Hub.
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.2.5f1
2D: Reordering "Sorting Layers" list causes Sprites to reference different Layer names and ID (1376779)
AI: NavMesh Agent can not pass through passable area between carving NavMesh Obstacles (1346325)
Android: Sometimes text is not rendered when using OpengLES3 on a Xiaomi Redmi9A device. (1347186)
Android: * Devices might wake up from sleep when in split screen mode.
- Chrome OS devices that support tablet mode might not pause apps when they are no longer visible.
- Some Android devices may experience delayed resolution updates after resizing a window.
- Minimum window size might not be respected properly on all Android devices.
- Chrome OS devices that support tablet mode might not pause apps when they are no longer visible.
Build Pipeline: Windows build fails when using Deltatre Magma Engine (1382217)
DirectX12: Objects are not lighted in Game view when using SEGI system with Graphics API for Windows set to Direct3D12 (1375746)
HD RP: HDRP Template fills the Console with "Shader error...couldn't open include file" messages after building the project (1342989)
IMGUI: List Elements in the PropertyField disappear when the window is displayed on the second screen (1371078)
Linux: Player settings and other options are locked after script compilation (1380015)
Linux: Editor crashes at "RegisterRuntimeInitializeAndCleanup::ExecuteCleanup()" when quitting from "Enter Safe Mode" prompt [Linux] (1374087)
Linux: Editor crashes at "__assert_fail_base.cold" when opening a project (Linux) (1375312)
Linux: [HDRP] Editor crashes when opening HDRP Sample Project (1381237)
MacOS: Editor freezes when Vsync is enabled and Game View window is resized on macOS (1375973)
MacOS: [OSX][Editor] DirectoryNotFoundException errors appear when a project is created inside a directory with unicode characters (1377915)
Progressive Lightmapper: Crash while sculpting Terrain and Baking Lightmaps (1266511)
Progressive Lightmapper: [GPU PLM] Crash after enabling Auto at the end of Bake - OpenCLRenderLightmapBuffers.HasBakingBuffers() (1379762)
Progressive Lightmapper: [GPU PLM] Fallback to CPU PLM in CL_INVALID_MEM_OBJECT after switching light color only and rebaking GI (1356714)
Scene Management: Instantiated FBX through code throws error after leaving Play Mode (1363573)
Scene/Game View: Icon attached to MonoBehaviour script disappears when Selecting the GameObject (1379500)
Scripting: Only some assemblies fail to be loaded when assembly name does not match the file name (1345099)
Serialization: [CacheServer] Editor crashes when "IP Address" in Project Settings is empty (1373314)
Serialization: [SERIALISATION] Going into play mode does not deserialize the object properly (1383439)
ShaderGraph: [General][AssetDB][URP] Adding URP to the project causes reimports of many assets and goes into infinite import loops (1374611)
Shadows/Lights: Memory access violation in LightProbesManager when appending LightProbes objects with overlaps twice (1377416)
Shadows/Lights: Scene is brighter in Standalone player if it was open in the Editor at build time (1375015)
Shuriken: [Particles] Inspector breaks and errors are thrown when the Material field is deleted from the Particle System (1379541)
Vulkan: [Editor] The Scene's GameObjects textures are seemingly random and change colours depending on the Scene's Camera pos. (1337772)
XR SDK: [XR][Linux] Scene View doesn't render when opening new AR or VR Template project or pressing "Show Tutorials" (1362435)
2021.2.5f1 Release Notes
Input System: Added support for PS5 DualSense controllers on Mac and Windows.
Version Control: Added empty state and success message for Pending Changes tab.
Version Control: Added metrics for Branches tab functionalities.
Version Control: Added option to "Add to ignore file" in context menu in the project view.
Editor: Added an Information Entry when the player data is rebuilt with 'Development' checkbox off. The message will be 'Rebuilding Data files because BuildOptions.Development is not set.' (1364982)
Input System: Improved creating single vs multi-touch touchscreen bindings in the Input Action Asset editor by making both options visible in the input action dropdown menu. Now it's not neccessary to be aware of the touch\*/press path binding syntax. (1357664)
Scripting: Added TextAsset.GetData that returns a NativeArray view into the data without memory allocations. (1376503)
HDRP: Depth of Field is now disabled in orthographic cameras - it was using the hidden perspective settings. (1372582)
HDRP: Integrate a help box to inform users of the potential dependency to directional lights when baking.
HDRP: Maximum light count per fine prunned tile (opaque deferred) is now 63 instead of 23.
Input System: When exceptions occur in user code inside of Input System callbacks, the exception message is now printed first and details about the callback second to avoid hiding exception details.
Package: Updated OpenXR package version to 1.3.0. Full package release notes available here:
Package: Updated Recorder package to version 3.0.2. Full package release notes available here:
Package: Updated Searcher package version to 4.9.1. Full package release notes available here:
Package: Updated Tutorial Framework version to 2.1.1. Full package release notes available here:
Version Control: Changed the default metadata columns shown in the Incoming Changes screen.
Version Control: Removed pinstriping in the Gluon Incoming Changes window.
Version Control: Removed the "Nothing to download" bar from the Incoming Changes window when there are no items to download.
Version Control: Updated the alignment of sorting arrows to the right of the column.
XR: Added SRP batcher support for late latching.
Android: Fixed an issue where Resource.Load did not work when running universal.apk were created from AAB which was built with Split Application Binary option that was enabled. Note: In universal.apk, Bundletool includes only install-time delivered asset packs, so resource loading can still fail if Unity creates fast-follow delivered core data asset pack. (1363907)
Audio: Fixed a crash that would occur when removing a custom filter from a game object and then stopping the associated audio source. (1363271)
DX12: Fixed linear colorspace screenshots being broken when swapchain resolution mismatched with window resolution. (1379073)
Editor: Fixed an issue where PropertyField methods was not including ReorderableList children by default. (1336112)
Editor: Fixed an issue where the game view maximized instead of tab being switched when clicking on a tab docked in the same window as the Game View window while in playmode in the Linux Editor. (1350901)
GI: Fixed rare infinite loop issue when baking reflection probes while shaders were asynchronously compiling. (1376248)
Graphics: Fixed a crash when PreviewRenderUtility.BeginPreview() was not properly followed by EndPreview(). (1338040)
Graphics: Fixed a crash when using ray tracing shader passes that are part of a fallback shader. (1369861)
Graphics: Fixed an issue when changing volume profiles at runtime with a script. (1364256)
Graphics: Fixed an issues on vulkan library on initialization and on AMD gpus. (1373442)
Graphics: Fixed serialization of DebugStateFlags where the internal Enum were not being serialized.
HDRP: Fixed a build-time warning regarding light loop variants. (1372256)
HDRP: Fixed a crash issue when adding an area light on its own.
HDRP: Fixed a regression that was introduced in the diffuse denoiser.
HDRP: Fixed an exception when the user did not set one of the renderers of a given LOD. (1372965)
HDRP: Fixed an infinite import loop of materials when there is no HDMetaData generated by the ShaderGraph.
HDRP: Fixed an issue where pyramid blur was being corrupted when hardware DRS was on. (1372245)
HDRP: Fixed an issue with area light support for hair.
HDRP: Fixed an issue with mixed cached shadow for area lights.
HDRP: Fixed and optimize distance shadowmask fade.
HDRP: Fixed compilation errors when using Elipse, Rectangle, Polygon, Checkerboard, RoundedPolygon, RoundedRectangle in a ray tracing shader graph. (1377610)
HDRP: Fixed emissive value when switching between HDR and LDR mode.
HDRP: Fixed film grain and dithering when using spatial upscaling methods for DRS.
HDRP: Fixed focus distance in path traced depth of field now takes into account the focus mode setting (volume vs camera).
HDRP: Fixed geometry scale issue with the Eye Shader.
HDRP: Fixed light unit conversion after changing mid gray value.
HDRP: Fixed motion vector buffer not accessible from custom passes in the BeforeTransparent, BeforePreRefraction and AfterDepthAndNormal injection points.
HDRP: Fixed outdated documentation about recursie ray tracing effects support.
HDRP: Fixed outdated documentation about supported GPUs for ray tracing.
HDRP: Fixed performance on PrepareLightsForGPU by burstifying light loop.
HDRP: Fixed public API to reset path tracing accumulation and check its status.
HDRP: Fixed rendertarget ColorMask in Forward with virtual texturing and transparent motion vectors.
HDRP: Fixed sky override layer mask having no effect.
HDRP: Fixed stencil buffer resolve when MSAA is enabled so that OR operator is used instead of picking the last sample.
HDRP: Fixed the bad blending between the sun and the clouds. (1373282)
HDRP: Fixed the point distribution for the diffuse denoiser sometimes not being properly intialized.
HDRP: Fixed Z axis orientation when sampling 3D textures in local volumetric fog.
Input System: Fixe an issue where any unhandled exception in
InputManager.OnUpdatefailed latter updates with
InvalidOperationException: Already have an event buffer set! Was OnUpdate() called recursively?. Instead the system will try to handle the exception and recover into a working state.
Input System: Fixed "Default constructor not found for type UnityEngine.InputSystem.iOS.LowLevel.iOSStepCounter" any other potential exceptions due to classes, methods, fields and properties being stripped when managed stripping setting set to medium or high. (1368761)
Input System: Fixed a performance issue on entering/exiting play-mode where HID device capabilities JSON could be parsed multiple times for a single device. (1362733)
Input System: Fixed a problem where only using runtimes that are not XR supported causes a compile error. This fix adds back in ENABLE_VR checks to prevent this issue.
Input System: Fixed an issue that broke the
VirtualMouseInputcomponent in the editor. (1367553)
Input System: Fixed an issue where explicitly switching to an already active control scheme and device set for
PlayerInputwould cancel event callbacks for no reason when the control scheme switch would have no practical effect. This fix detects and skips device unpairing and re-pairing if the switch is detected to not be a change to scheme or devices. (1342297)
Input System: Fixed an issue where InvalidOperationException was thrown if an input for an action with multiple interactions is held while disconnecting the device. (1354098)
Input System: Fixed an issue where resetting an action via
InputAction.Reset()while being in disabled state would prevent the action from being enabled again. (1370732)
Input System: Fixed current being
nullfor sensors (
Accelerometer.current, others). (1371204)
Input System: Fixed input action for Android gamepad's right stick will be correctly invoked when only the Y-axis is changing. (1308637)
Input System: Fixed
action.ReadValueand others returning invalid data when used from
FixedUpdateor early update when running in play mode in the editor. (1368559)
Input System: Generic gamepad short display button names where incorrectly mapped on Switch (
Profiler: Fixed a crash when exiting Unity Editor related to UnsafeUtility.Malloc usage. (1377694)
Serialization: Fixed missed invocations of ISerializationCallbackReceiver.OnAfterDeserialization and asserts arising when that interface is implemented on structs inside a MonoBehaviour or ScriptableObject class, along with the presence of SerializeReference fields. (1372710)
Shadergraph: Fixed a ShaderGraph warning when connecting a node using Object Space BiTangent to the vertex stage. (1361512)
Shadergraph: Fixed a usability issue where in some cases searcher would suggest one collapsed category of results that user would have to manually expand anyway.
Shadergraph: Fixed an issue that caused exceptions to be thrown when using the up/down arrow keys with search list focused. (1358016)
Shadergraph: Fixed an issue that caused incorrect search results with non whitespaced queries for nodes with spaces in their name and for subgraphs. (1359158)
Shadergraph: Fixed an issue that caused search results to not be visible sometimes in the searcher window. (1366061)
Shadergraph: Fixed an issue that caused some searcher items to be irreversibly collapsed due to expand icon disappearing on collapsing those items.
Shaders: Prevent shader cache from growing infinitely. Shader cache is now organized into per asset folders. (1339314)
UI Toolkit: Fixed an issue where the element under pointer was not updated when pointer position varied very slowly (subpixel amounts on each update). (1356041)
Universal Windows Platform: Fixed a generated Visual Studio project issue when building to Universal Windows Platform with Visual Studio 2022. (1378086)
URP: Fixed a performance regression for 2D shaders where alpha discard was disabled. (1335648)
URP: Fixed an issue where installing the Adaptive Performance package caused errors to the inspector UI. (1368161)
URP: Fixed an issue where the Convert Renderering Settings would cause a freeze. (1353885)
URP: Fixed disabled debug lighting modes on Vulkan and OpenGL following a shader compiler fix.
URP: Fixed incorrect behavior of Reflections with Smoothness lighting debug mode.
URP: Fixed post processing with Pixel Perfect camera. (1363763)
Version Control: Fixed a console error when selecting an object in Scene view hierarchy or creating a new asset.
Version Control: Fixed NullReferenceException after closing the Plastic SCM window.
Version Control: Fixed UI overlays in Project view that was missing on changed assets when force checkout was disabled.
VFX Graph: Fixed a performance drop when Windows screen DPI setting was set to custom values (like 125%).
VFX Graph: Fixed an issue where there were extra nodes in Ribbon template. (1355602)
VFX Graph: Fixed the compilation error while using not exposed texture in ShaderGraph.
WebGL: Fixed a fullscreen mode issue on Safari. (1347304)
WebGL: Fixed AudioSource.loop property when using AudioSource.PlayScheduled() and AudioSource.PlayDelayed(). (1337312)
Windows: Fixed an issue where SystemInfo.operatingSystem did not recognize Windows 11. (1372750)
Windows: UnityCrashHandler.exe will no longer inherit all Windows handles from the editor/player when launched, which should eliminate some problems with it causing files to be locked unnecessarily.
XR: Fixed an issue where UnitySubsystemsManifest.json file was added to the app bundle instead of apk while building XR app for Android with Build App Bundle option. (1379905)
XR: Fixed for late latching pre drawcall performance regression and world space UI and terrain always drawn at origin. (1337356, 1337972, 1337973)