Wiki
Règles de validation
Contrôles de validation d'assets exécutés au check-in : les 9 règles intégrées, les sévérités error / warning / info, la config JSON, export / import / reset.
Introduction
Les règles de validation sont des contrôles d'assets Unreal exécutés au moment du check-in : nommage, taille de texture, dépendances manquantes, etc. Elles servent à faire respecter les conventions du studio automatiquement, avant que le contenu n'entre dans le dépôt. Elles se configurent par dépôt.
Accès et rôles
L'onglet Règles est accessible au super admin et au project_admin sur les dépôts qu'il administre.
Sévérités
| Sévérité | Effet au check-in |
|---|---|
error | Bloque le check-in tant que le problème n'est pas corrigé. |
warning | Avertit mais laisse passer. |
info | Purement informatif. |
Les 9 règles intégrées
| Règle | Défaut | Ce qu'elle vérifie |
|---|---|---|
blueprint_compilation | error | Les Blueprints compilent sans erreur avant le check-in. |
naming_convention | warning | Préfixes de nommage (style Allar UE5) : T_ textures, M_ matériaux, BP_ blueprints, SM_ static meshes, WBP_ widgets, etc. |
max_texture_size | warning | Taille max des textures : par défaut 4096 × 4096, puissance de 2 requise. |
material_complexity | warning | Complexité des matériaux : par défaut max 256 instructions, 16 échantillons de texture. |
import_settings | warning | Réglages d'import conformes (textures, meshes). |
missing_dependency | error | Aucune dépendance manquante (ignore par défaut le contenu moteur). |
circular_dependency | error | Pas de dépendance circulaire (profondeur de recherche 20 par défaut). |
unreferenced_asset | info | Signale les assets non référencés (exclut cartes et widgets par défaut). |
duplicate_asset | warning | Détecte les assets en double (ignore les .umap par défaut). |
Activer et configurer
Pour chaque règle :
- Interrupteur : active / désactive la règle. Sauvegarde immédiate.
- Sévérité : menu déroulant error / warning / info. Sauvegarde immédiate.
- Configuration (JSON) : dépliez la règle (chevron) pour éditer ses paramètres en JSON, puis Save Config. Un JSON invalide bloque la sauvegarde avec le détail de l'erreur.
Exemple : abaisser max_texture_size à 2048 pour un projet mobile, ou passer
naming_convention en error pour l'imposer strictement.
Export, import, reset
- Export : télécharge un fichier
rules.jsoncontenant l'état de toutes les règles (activation, sévérité, config). - Import : recharge un
rules.jsonet applique chaque entrée aux règles correspondantes (les clés inconnues sont ignorées). - Reset to Defaults : remet toutes les règles à leurs valeurs par défaut. Les configurations personnalisées sont perdues (confirmation demandée).
L'export / import sert à répliquer une politique de validation d'un dépôt à l'autre, ou à la versionner hors ligne.
rules.json dans le dépôt
.uversion/rules.json committé n'est appliqué à la politique du dépôt que si l'auteur du
commit détient la capacité manage_rules. Sinon le fichier est stocké mais les règles ne changent pas.
C'est une garde : un contributeur avec droit d'écriture sur ce chemin ne peut pas désactiver la validation en
committant un fichier.
Pièges courants
Un check-in est bloqué
Une règle en error a échoué. Le message indique laquelle. Corrigez l'asset, ou (si la règle est trop
stricte pour votre contexte) abaissez sa sévérité en warning.
Reset efface mes réglages
Reset to Defaults est destructif pour vos configurations personnalisées. Faites un Export avant si vous voulez pouvoir revenir en arrière.
Une règle semble ne rien faire
Vérifiez qu'elle est activée (interrupteur) et que sa sévérité n'est pas info si vous attendiez un
blocage. Seul error bloque le check-in.