Guide de conversion URP/HDRP

Les matériaux du Built-in Render Pipeline de Unity peuvent être convertis vers le Universal Render Pipeline (URP) ou le High Definition Render Pipeline (HDRP).

---

Avant de commencer​

• Confirmez que votre projet est configuré avec URP ou HDRP. Le package du render pipeline cible doit être installé et assigné dans Project Settings > Graphics.
• La conversion n'affecte que les matériaux utilisant le shader Standard ou Standard (Specular Setup) de Unity. Les shaders personnalisés ne sont pas convertis automatiquement.

---

Méthode 1 : Conversion via le menu Edit​

Sélectionnez les matériaux à convertir et utilisez le menu Edit. Idéal pour convertir un petit nombre de matériaux spécifiques.

Conversion vers URP​

1. Sélectionnez tous les matériaux de l'asset dans votre fenêtre Project.

   

2. Go to Edit > Rendering > Materials > Convert Selected Built-in Materials to URP.

   

3. Dans le dialogue Material Upgrader, cliquez sur Proceed.

   

4. Vérifiez que les matériaux s'affichent correctement dans la scène. Si des matériaux apparaissent en rose, consultez Dépannage.

   

Conversion vers HDRP​

1. Sélectionnez tous les matériaux de l'asset dans votre fenêtre Project.

   

2. Go to Edit > Rendering > Materials > Convert Selected Built-in Materials to HDRP.

   

3. Dans le dialogue Material Upgrader, cliquez sur Proceed.

   

4. Vérifiez que les matériaux s'affichent correctement dans la scène. Si des matériaux apparaissent en rose, consultez Dépannage.

   

---

Méthode 2 : Render Pipeline Converter (URP)​

Unity fournit une fenêtre de conversion dédiée pour les projets URP. Cette méthode permet de scanner et vérifier tous les assets convertibles avant d'appliquer les modifications.

1. Go to Window > Rendering > Render Pipeline Converter.
2. Sélectionnez Built-in Render Pipeline to URP dans le menu déroulant.
3. Cochez Material Upgrade (et optionnellement Read-only Material Converter pour les matériaux par défaut intégrés).
4. Cliquez sur Initialize Converters pour scanner votre projet.
5. Examinez la liste des assets qui seront convertis.
6. Cliquez sur Convert Assets.

---

Dépannage​

Matériaux roses ou magenta après conversion​

Les matériaux deviennent roses lorsque leur shader est incompatible avec le render pipeline actuel. Cela se produit généralement pour l'une de ces raisons.

• Le matériau n'a pas été inclus dans la sélection de conversion.
• Le matériau utilise un shader personnalisé que le convertisseur ne peut pas gérer.
• Le package du render pipeline n'est pas correctement installé ou assigné.

Vérifiez l'assignation du shader du matériau rose dans l'Inspector, puis relancez la conversion ou assignez manuellement un shader compatible (Universal Render Pipeline/Lit pour URP, HDRP/Lit pour HDRP).

Les textures semblent différentes ou manquantes​

Les propriétés des shaders peuvent ne pas correspondre 1:1 entre les pipelines. Après conversion, vérifiez les points suivants.

• Les normal maps, metallic maps et emission maps sont toujours assignés.
• Les valeurs de Smoothness et Metallic peuvent nécessiter un ajustement si l'apparence de la surface a changé.

Shaders personnalisés non convertis​

Le convertisseur intégré ne gère que les shaders Standard et Standard (Specular Setup). Les shaders personnalisés et Surface Shaders doivent être réécrits ou recréés manuellement dans Shader Graph.

---

Référence de mappage des shaders​

Après conversion, les shaders Built-in sont remappés vers leurs équivalents de pipeline :

Shader Built-in	Équivalent URP
Standard	Universal Render Pipeline/Lit
Standard (Specular Setup)	Universal Render Pipeline/Lit
Mobile/Diffuse	Universal Render Pipeline/Simple Lit
Particles/Standard Surface	Universal Render Pipeline/Particles/Lit

Shader Built-in	Équivalent HDRP
Standard	HDRP/Lit
Standard (Specular Setup)	HDRP/Lit

---

Notes sur les versions de Unity​

Version de Unity	Méthode 1 (Menu Edit)	Méthode 2 (Converter)
Unity 2022, Unity 6 (6000.x)	Disponible	Disponible (URP uniquement)

Le chemin du menu Edit peut changer entre les versions de Unity. Si Edit > Rendering > Materials n'est pas disponible, utilisez la Méthode 2 ou consultez la documentation de votre version de Unity.