# Upgrade to Unity 2023.1

> Upgrade a project from 2022 LTS to 2023.1.

This page lists changes in Unity 2023.1 which might affect existing projects when you upgrade them from a 2022 LTS version to 2023.1.

### Page outline

* [Render pipelines](#ren-pipe)
* [Gaussian Filter Radius properties from `LightingSettings` are now floating point values](#gaussian-filter)
* [Improvements to light probe energy conservation](#light-probe)
* [Enlighten Baked Global Illumination is no longer available](#enlighten-baked-gi)
* [Android: Java class UnityPlayer needs to be renamed to UnityPlayerForActivityOrService](#android-unityplayer)
* [Android: UnityPlayer java class no longer extends FrameLayout](#android-framelayout)
* [FetchFirstCompatibleTypeUsingScriptableRenderPipelineExtension replaced by GetDerivedTypesSupportedOnCurrentPipeline](#api-fetchfirstcompatible)
* [CustomEditorForRenderPipelineAttribute and VolumeComponentMenuForRenderPipelineAttribute deprecated](#api-deprecated)
* [Changes to Android Gradle templates usage](#android-gradle)

## Render pipelines

This upgrade guide describes how to upgrade to version 2023.1 of Unity's built-in render pipeline. To upgrade other render pipelines to version 2023.1, see:

* [The URP upgrade guide](/engine/6000.7/manual/render-pipelines/universal-render-pipeline/introduction/installing-and-configuring-urp/upgrade-guides/upgrade-guide-2023-1.md)
* [The HDRP upgrade guide](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@15.0/manual/Upgrading-from-2022.2-to-2023.1.html)

To upgrade other packages, refer to the documentation for the packages you are using.

## Gaussian Filter Radius properties from LightingSettings are now floating point values

The [Progressive Lightmapper](/engine/6000.7/manual/lighting-overview/direct-and-indirect-lighting/lightmapping/baking-before-runtime/configure/progressive-lightmapper.md) includes a **Gaussian** option among its **Advanced** filtering options (**Lighting Window > Lightmapping Settings > Filtering > Direct Filter > Gaussian**). The **Radius** control for **Gaussian** filtering now supports decimal increments, such as 0.5. Previously, this control only supported integer steps (1 to 5).

As a result of this change, these properties are now deprecated in the C# API:

* `int LightingSettings.filteringGaussRadiusAO`
* `int LightingSettings.filteringGaussRadiusDirect`
* `int LightingSettings.filteringGaussRadiusIndirect`

The floating point replacements for the deprecated properties are:

* `float LightingSettings.filteringGaussianRadiusAO`
* `float LightingSettings.filteringGaussianRadiusDirect`
* `float LightingSettings.filteringGaussianRadiusIndirect`

You can call one of the deprecated member functions to round the Gaussian filter radius to the nearest integer.

## Improvements to light probe energy conservation

Light Probes are now as bright as lightmaps. Previously, Unity’s Light Probes were only 94% as bright as they should be. For this reason, objects lit with light probes appeared a bit darker than objects lit with lightmaps. Because of the subtlety of this change, it is possible that many users won’t see a noticeable difference.

Should you prefer the old appearance, you can achieve it in the following way:

1. Bake light probes.
2. Use C# to get a copy of the array [LightmapSettings.lightProbes.bakedProbes](/engine/6000.7/script-reference/unityengine/lightprobes/bakedprobes.md).
3. For each SphericalHarmonicsL2 instance, multiply coefficient 0 with 16/17.
4. Write your copy of the array back into [LightmapSettings.lightProbes.bakedProbes](/engine/6000.7/script-reference/unityengine/lightprobes/bakedprobes.md).

## Enlighten Baked Global Illumination is no longer available

The Enlighten Baked Global Illumination lightmapping backend is no longer available.

When you upgrade a project to this version, Unity removes the Enlighten baking backend from the lightmapper selection dropdown and substitutes a Progressive Lightmapper in every Scene where you've selected the Enlighten baking backend.

On Apple silicon devices, Unity substitutes the Progressive GPU Lightmapper for the Enlighten baking backend. On all other devices, Unity selects the CPU Progressive Lightmapper.

Enlighten precomputed Realtime Global Illumination is still available and is supported up until Unity 6.

## Android: Java class UnityPlayer needs to be renamed to UnityPlayerForActivityOrService

The `UnityPlayer` Java class has been replaced by two new bridge classes, `UnityPlayerForActivityOrService` and `UnityPlayerForGameActivity`. These new classes both derive from `UnityPlayer`, but public methods such as `displayChanged` and `windowFocusChanged` have moved from `UnityPlayer` specifically to `UnityPlayerForActivityOrService`.

If you [extend the default Unity activity](/engine/6000.7/manual/platform-specific/android/developing/application-entries/activity/unity-player-activity.md) and use the `UnityPlayer` class, you might encounter compile errors. In this case, rename `UnityPlayer` to `UnityPlayerForActivityOrService`.

## Android: UnityPlayer java class no longer extends FrameLayout

The `UnityPlayer` Java class no longer extends `FrameLayout`. If you need to access `FrameLayout`, call the `getFrameLayout` function on the `UnityPlayer` instance.

## FetchFirstCompatibleTypeUsingScriptableRenderPipelineExtension replaced by GetDerivedTypesSupportedOnCurrentPipeline

`RenderPipelineEditorUtility.FetchFirstCompatibleTypeUsingScriptableRenderPipelineExtension` is now deprecated. Use [GetDerivedTypesSupportedOnCurrentPipeline](/engine/6000.7/script-reference/unityeditor/rendering/renderpipelineeditorutility/getderivedtypessupportedoncurrentpipeline.md) instead. This method's signature is also different; now it returns all derived types, not just the first one it encounters. This prevents inconsistencies, because Unity does not guarantee type order.

## CustomEditorForRenderPipelineAttribute and VolumeComponentMenuForRenderPipelineAttribute deprecated

CustomEditorForRenderPipelineAttribute and VolumeComponentMenuForRenderPipelineAttribute are now deprecated. Use [CustomEditor](/engine/6000.7/script-reference/unityeditor/customeditor.md) and [VolumeComponentMenu](https://docs.unity3d.com/Packages/com.unity.render-pipelines.core@15.0/api/UnityEngine.Rendering.VolumeComponentMenu.html) instead. To restrict the choice of pipeline when these attributes are active, combine them with [SupportedOnRenderPipelineAttribute](/engine/6000.7/script-reference/unityengine/rendering/supportedonrenderpipelineattribute.md) and specify a [RenderPipelineAsset](/engine/6000.7/script-reference/unityengine/rendering/renderpipelineasset.md) type. If you want to activate an SRP attribute that does work with the Built-In Render Pipeline, use [SupportedOnRenderPipelineAttribute](/engine/6000.7/script-reference/unityengine/rendering/supportedonrenderpipelineattribute.md) without parameters. This provides a unified workflow for both attributes when there’s a need to activate them on a specific pipeline.

## Changes to Android Gradle templates usage

A new [API](/engine/6000.7/manual/platform-specific/android/building-and-delivering/modify-gradle-project-files/agp.md) to modify the Android Gradle project was introduced. The API can be used to replace the old Android Gradle templates workflow. Templates will still work as before if the new API is not used.

To use the new API a [Templates Upgrader](/engine/6000.7/manual/android-templates-upgrader-window.md) can be used:

1. Open **Android Player Settings**.
2. Go to **Publishing Settings** > **Build**.
3. Select **Upgrade templates to C#**.

## Additional Resources

* [What's New in Unity 2023.1](/engine/6000.7/manual/whats-new/20231.md)
* [Install Unity](/engine/6000.7/manual/get-started/install-and-upgrade/getting-started-installing-unity.md)
* [API updater](/engine/6000.7/manual/upgrade-guides/apiupdater.md)