Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Upgrade to Unity 6.1

Upgrade a project from Unity 6.0 LTS to Unity 6.1.
Read time 2 minutesLast updated 21 days ago
This page lists changes in Unity 6.1 in these areas that can affect existing projects when you upgrade from Unity 6.0 LTS to Unity 6.1:

Editor and workflow

This section outlines recent updates to the Editor and its general workflows that can affect your upgrade experience.

Window menu changes

Package Manager, Asset Store, Services, My Assets, and Version Control now appear in new submenus. This change breaks any custom keyboard shortcuts to open these windows.
After upgrading, recreate any shortcuts to these windows.

Graphics

This section outlines recent updates to Unity's graphics systems that can affect your upgrade experience.

Render pipelines

For upgrade guides for specific render pipelines in Unity, refer to one of the following pages:
To upgrade other packages, refer to the documentation for the packages you’re using.

The 
_CLUSTER_LIGHT_LOOP
shader keyword replaces 
_FORWARD_PLUS

Unity 6.1 replaces the 
_FORWARD_PLUS
shader keyword with the 
_CLUSTER_LIGHT_LOOP
keyword. If your custom shaders use the 
_FORWARD_PLUS
keyword, replace it with 
_CLUSTER_LIGHT_LOOP
.
For more information about using the keywords, refer to Shader keywords and macros reference in URP.

Support for the PVRTC format is deprecated

Support for PVRTC compression is deprecated and will be fully removed in the future. It’s recommended that you transition to other compression formats, such as ASTC or ETC, to avoid issues in future upgrades.

Physics

This section outlines recent updates to Physics-specific tools and settings that can affect your upgrade experience.

Rigidbody.SetDensity is deprecated

The 
SetDensity
method was deprecated for 
Rigidbody
. Use 
Rigidbody.mass
 instead.
The 
SetDensity
method was effectively used as a mass multiplier for the body by the physics integration instead of a per-Collider value used during mass distribution to determine each Collider's mass.

Platforms

This section outlines recent updates to platform-specific tools and settings that can affect your upgrade experience.

Android

The default Android tools versions have changed

Unity has updated the default versions of the following tools used by Android. The default versions of SDK build tools, SDK platform tools, and JDK remain unchanged. The updated versions are as follows:

Tool

Version

Gradle8.11
Android Gradle Plugin8.7.2
SDK Command-line tools16.0
NDKr27c
If your project uses any custom Gradle templates, consider recreating those templates to avoid any build issues with the updated Android Gradle Plugin version. For more information, refer to Modify Gradle project files with Gradle template files.

Windows

New default Auto Graphics API

The default Auto Graphics API in Unity 6.1 is DirectX12. Projects upgrading from older versions of Unity maintain the default setting from their version.
To change to the default for 6.1, in
Player Settings

?

, enable Auto Graphics API.