Wiki

Reglas de validación

Comprobaciones de validación de assets ejecutadas en el check-in : las 9 reglas integradas, las severidades error / warning / info, la configuración JSON, exportar / importar / reset.

Introducción

Las reglas de validación son comprobaciones de assets de Unreal ejecutadas en el momento del check-in : nomenclatura, tamaño de textura, dependencias faltantes, etc. Sirven para hacer cumplir las convenciones del estudio de forma automática, antes de que el contenido entre en el repositorio. Se configuran por repositorio.

Acceso y roles

La pestaña Reglas está disponible para el super admin y para el project_admin en los repositorios que administra.

Sembrado automático La primera vez que se abren las reglas de un repositorio que aún no tiene ninguna, las 9 reglas por defecto se crean automáticamente. Por lo tanto siempre parte de un conjunto completo, listo para ajustar.

Severidades

Severidad	Efecto en el check-in
`error`	Bloquea el check-in mientras el problema no se corrija.
`warning`	Advierte pero deja pasar.
`info`	Puramente informativo.

Las 9 reglas integradas

La lista de las reglas integradas, cada una con su interruptor de activación y su menú de severidad error/warning/info.

Regla	Por defecto	Qué comprueba
`blueprint_compilation`	error	Los Blueprints compilan sin errores antes del check-in.
`naming_convention`	warning	Prefijos de nomenclatura (estilo Allar UE5) : `T_` texturas, `M_` materiales, `BP_` blueprints, `SM_` static meshes, `WBP_` widgets, etc.
`max_texture_size`	warning	Tamaño máximo de las texturas : por defecto 4096 × 4096, potencia de 2 obligatoria.
`material_complexity`	warning	Complejidad de los materiales : por defecto máx. 256 instrucciones, 16 muestras de textura.
`import_settings`	warning	Ajustes de importación conformes (texturas, meshes).
`missing_dependency`	error	Ninguna dependencia faltante (ignora por defecto el contenido del motor).
`circular_dependency`	error	Sin dependencia circular (profundidad de búsqueda 20 por defecto).
`unreferenced_asset`	info	Señala los assets sin referencias (excluye mapas y widgets por defecto).
`duplicate_asset`	warning	Detecta los assets duplicados (ignora los `.umap` por defecto).

Activar y configurar

Una regla desplegada en su editor de configuración JSON con el botón Save Config.

Para cada regla :

Interruptor : activa / desactiva la regla. Guardado inmediato.
Severidad : menú desplegable error / warning / info. Guardado inmediato.
Configuración (JSON) : despliegue la regla (chevron) para editar sus parámetros en JSON, luego Save Config. Un JSON no válido bloquea el guardado con el detalle del error.

Ejemplo : bajar max_texture_size a 2048 para un proyecto móvil, o pasar naming_convention a error para imponerla estrictamente.

Exportar, importar, reset

Export : descarga un archivo rules.json que contiene el estado de todas las reglas (activación, severidad, configuración).
Import : recarga un rules.json y aplica cada entrada a las reglas correspondientes (las claves desconocidas se ignoran).
Reset to Defaults : restablece todas las reglas a sus valores por defecto. Las configuraciones personalizadas se pierden (se pide confirmación).

Exportar / importar sirve para replicar una política de validación de un repositorio a otro, o para versionarla sin conexión.

rules.json en el repositorio

Un rules.json commiteado no lo aplica cualquiera Un archivo .uversion/rules.json commiteado solo se aplica a la política del repositorio si el autor del commit posee la capacidad manage_rules. De lo contrario el archivo se almacena pero las reglas no cambian. Es una salvaguarda : un contribuidor con derecho de escritura en esa ruta no puede desactivar la validación commiteando un archivo.

Errores frecuentes

Un check-in está bloqueado

Una regla en error falló. El mensaje indica cuál. Corrija el asset, o (si la regla es demasiado estricta para su contexto) baje su severidad a warning.

Reset borra mis ajustes

Reset to Defaults es destructivo para sus configuraciones personalizadas. Haga un Export antes si quiere poder volver atrás.

Una regla parece no hacer nada

Compruebe que está activada (interruptor) y que su severidad no es info si esperaba un bloqueo. Solo error bloquea el check-in.