68 lines
4.4 KiB
Markdown
68 lines
4.4 KiB
Markdown
---
|
||
uid: urp-install-urp-into-a-project
|
||
---
|
||
# Installing the Universal Render Pipeline into an existing Project
|
||
|
||
You can download and install the latest version of the Universal Render Pipeline (URP) to your existing Project via the [Package Manager system](https://docs.unity3d.com/Packages/com.unity.package-manager-ui@latest/index.html), and then install it into your Project. If you don’t have an existing Project, refer to documentation on [how to start a new URP Project from a Template](creating-a-new-project-with-urp.md).
|
||
|
||
## Before you begin
|
||
|
||
URP uses its own [integrated post-processing solution](integration-with-post-processing.md). If you have the Post Processing Version 2 package installed in your Project, you need to delete the Post Processing Version 2 package before you install URP into your Project. When you have installed URP, you can then recreate your post-processing effects.
|
||
|
||
URP does not currently support custom post-processing effects. If your Project uses custom post-processing effects, these cannot currently be recreated in URP. Custom post-processing effects will be supported in a forthcoming release of URP.
|
||
|
||
## Installing URP
|
||
|
||
1. In Unity, open your Project.
|
||
2. In the top navigation bar, select **Window** > **Package Manager** to open the **Package Manager** window.
|
||
3. In the **Packages** menu, select **Unity Registry**. This shows the list of available packages for the version of Unity that you are currently running.
|
||
4. Select **Universal RP** from the list of packages.
|
||
5. In the bottom right corner of the Package Manager window, select **Install**. Unity installs URP directly into your Project.
|
||
|
||
## Configuring URP
|
||
|
||
Before you can start using URP, you need to configure it. To do this, you need to create a Scriptable Render Pipeline Asset and adjust your Graphics settings.
|
||
|
||
### Creating the Universal Render Pipeline Asset
|
||
|
||
The [Universal Render Pipeline Asset](universalrp-asset.md) (URP Asset) contains the global rendering and quality settings of your project, and creates the rendering pipeline instance. The rendering pipeline instance contains intermediate resources and the render pipeline implementation.
|
||
|
||
To create a Universal Render Pipeline Asset:
|
||
|
||
1. In the Editor, go to the Project window.
|
||
2. Right-click in the Project window, and select **Create** > **Rendering** > **URP Asset (with Universal Renderer)**. Alternatively, navigate to the menu bar at the top, and select **Assets** > **Create** > **Rendering** > **URP Asset (with Universal Renderer)**.
|
||
|
||
You can either leave the default name for the new Universal Render Pipeline Asset, or type a new one.
|
||
|
||
### <a name="set-urp-active"></a>Set URP as the active render pipeline
|
||
|
||
To set URP as the active render pipeline:
|
||
|
||
1. In your project, locate the Render Pipeline Asset that you want to use.<br/>**Tip**: to find all URP Assets in a project, use the following query in the search field: `t:universalrenderpipelineasset`.
|
||
|
||
1. Select **Edit** > **Project Settings** > **Graphics**.
|
||
|
||
2. In the **Scriptable Render Pipeline Settings** field, select the URP Asset. When you select the URP Asset, the available Graphics settings change immediately.
|
||
|
||
**Optional**:
|
||
|
||
Set an override URP Assets for different quality levels:
|
||
|
||
1. Select **Edit** > **Project Settings** > **Quality**.
|
||
|
||
2. Select a quality level. In the **Render Pipeline Asset** field, select the Render Pipeline Asset.
|
||
|
||
## Upgrading your shaders
|
||
|
||
If your project uses the prebuilt [Standard Shader](https://docs.unity3d.com/Manual/shader-StandardShader.html), or custom Unity shaders made for the Built-in Render Pipeline, you must convert them to URP-compatible Unity shaders. For more information on this topic, refer to [Upgrading your Shaders](upgrading-your-shaders.md).
|
||
|
||
## Upgrade from the Built-in Render Pipeline
|
||
|
||
When you upgrade a project from the Built-in Render Pipeline (BiRP) to the Universal Render Pipeline (URP), there are many changes which occur. These changes are wide reaching and require some work beyond the initial installation process for URP shown here. The following pages explain more about these changes and provide guidance on any additional steps required:
|
||
|
||
* [Converting your shaders](upgrading-your-shaders.md)
|
||
* [Render Pipeline Converter](features/rp-converter.md)
|
||
* [Upgrade custom shaders for URP compatibility](urp-shaders/birp-urp-custom-shader-upgrade-guide.md)
|
||
* [Find graphics quality settings in URP](birp-onboarding/quality-settings-location.md)
|
||
* [Update graphics quality levels for URP](quality-presets.md)
|