Wiki

Validierungsregeln

Beim Check-in ausgeführte Asset-Validierungsprüfungen : die 9 integrierten Regeln, die Schweregrade error / warning / info, JSON-Konfiguration, Export / Import / Reset.

Einführung

Validierungsregeln sind Unreal-Asset-Prüfungen, die zum Zeitpunkt des Check-ins ausgeführt werden : Benennung, Texturgröße, fehlende Abhängigkeiten usw. Sie dienen dazu, die Konventionen des Studios automatisch durchzusetzen, bevor Inhalte in das Repository gelangen. Sie werden pro Repository konfiguriert.

Zugriff und Rollen

Der Tab Regeln steht dem Super-Admin und dem project_admin auf den von ihm verwalteten Repositories zur Verfügung.

Automatische Erstbefüllung Wenn man die Regeln eines Repositories, das noch keine hat, zum ersten Mal öffnet, werden die 9 Standardregeln automatisch erstellt. Sie starten also immer mit einem vollständigen Satz, den Sie anpassen können.

Schweregrade

Schweregrad	Wirkung beim Check-in
`error`	Blockiert den Check-in, bis das Problem behoben ist.
`warning`	Warnt, lässt aber durch.
`info`	Rein informativ.

Die 9 integrierten Regeln

Die Liste der integrierten Regeln, jede mit ihrem Aktivierungsschalter und ihrem Schweregradmenü error/warning/info.

Regel	Standard	Was sie prüft
`blueprint_compilation`	error	Blueprints kompilieren vor dem Check-in fehlerfrei.
`naming_convention`	warning	Benennungspräfixe (Allar-UE5-Stil) : `T_` Texturen, `M_` Materialien, `BP_` Blueprints, `SM_` Static Meshes, `WBP_` Widgets usw.
`max_texture_size`	warning	Maximale Texturgröße : standardmäßig 4096 × 4096, Zweierpotenz erforderlich.
`material_complexity`	warning	Materialkomplexität : standardmäßig max. 256 Instruktionen, 16 Textursamples.
`import_settings`	warning	Konforme Importeinstellungen (Texturen, Meshes).
`missing_dependency`	error	Keine fehlende Abhängigkeit (ignoriert standardmäßig Engine-Inhalte).
`circular_dependency`	error	Keine zirkuläre Abhängigkeit (Suchtiefe standardmäßig 20).
`unreferenced_asset`	info	Meldet nicht referenzierte Assets (schließt Karten und Widgets standardmäßig aus).
`duplicate_asset`	warning	Erkennt doppelte Assets (ignoriert standardmäßig `.umap`).

Aktivieren und konfigurieren

Eine aufgeklappte Regel mit ihrem JSON-Konfigurationseditor und der Schaltfläche Save Config.

Für jede Regel :

Schalter : aktiviert / deaktiviert die Regel. Sofortiges Speichern.
Schweregrad : Dropdown error / warning / info. Sofortiges Speichern.
Konfiguration (JSON) : Klappen Sie die Regel auf (Pfeil), um ihre Parameter im JSON zu bearbeiten, dann Save Config. Ungültiges JSON blockiert das Speichern mit dem Fehlerdetail.

Beispiel : max_texture_size für ein Mobilprojekt auf 2048 senken oder naming_convention auf error setzen, um sie strikt durchzusetzen.

Export, Import, Reset

Export : lädt eine Datei rules.json herunter, die den Zustand aller Regeln enthält (Aktivierung, Schweregrad, Konfiguration).
Import : lädt eine rules.json erneut und wendet jeden Eintrag auf die entsprechenden Regeln an (unbekannte Schlüssel werden ignoriert).
Reset to Defaults : setzt alle Regeln auf ihre Standardwerte zurück. Benutzerdefinierte Konfigurationen gehen verloren (Bestätigung erforderlich).

Export / Import dient dazu, eine Validierungsrichtlinie von einem Repository auf ein anderes zu replizieren oder sie offline zu versionieren.

rules.json im Repository

Eine committete rules.json wird nicht von jedem angewendet Eine committete Datei .uversion/rules.json wird nur dann auf die Richtlinie des Repositories angewendet, wenn der Autor des Commits die Fähigkeit manage_rules besitzt. Andernfalls wird die Datei gespeichert, aber die Regeln ändern sich nicht. Das ist eine Absicherung : ein Mitwirkender mit Schreibrecht auf diesem Pfad kann die Validierung nicht durch das Committen einer Datei deaktivieren.

Häufige Stolperfallen

Ein Check-in ist blockiert

Eine Regel mit error ist fehlgeschlagen. Die Meldung zeigt an, welche. Korrigieren Sie das Asset oder (wenn die Regel für Ihren Kontext zu streng ist) senken Sie ihren Schweregrad auf warning.

Reset löscht meine Einstellungen

Reset to Defaults ist für Ihre benutzerdefinierten Konfigurationen destruktiv. Machen Sie vorher einen Export, wenn Sie zurückkehren können möchten.

Eine Regel scheint nichts zu tun

Prüfen Sie, ob sie aktiviert ist (Schalter) und ob ihr Schweregrad nicht info ist, falls Sie eine Blockade erwartet haben. Nur error blockiert den Check-in.